針對 ASP.NET Core 專案進行疑難排解和偵錯

發行項
11/30/2023

作者：Rick Anderson

下列連結提供疑難排解指引：

.NET Core SDK 警告

同時安裝了 32 位元和 64 位元版本的.NET Core SDK

在 ASP.NET Core 的 [新增專案] 對話方塊中，您可能會看到下列警告：

同時安裝了 32 位元和 64 位元版本的 .NET Core SDK。只會顯示安裝在 'C:\Program Files\dotnet\sdk\' 之 64 位元版本的範本。

同時安裝 32 位元 (x86) 和 64 位元 (x64) 版本的 .NET Core SDK 時，會出現此警告。同時安裝這兩個版本的常見原因包括：

您原本使用 32 位元電腦下載 .NET Core SDK 安裝程式，但隨後將其複製到 64 位元電腦上並加以安裝。
另一個應用程式安裝了 32 位元 .NET Core SDK。
下載並安裝了錯誤的版本。

請解除安裝 32 位元 .NET Core SDK 來避免出現此警告。從 [控制台]>[程式和功能]> 解除安裝或變更程式。如果您瞭解警告發生的原因及其含意，可以忽略該警告。

.NET Core SDK 安裝在多個位置

在 ASP.NET Core 的 [新增專案] 對話方塊中，您可能會看到下列警告：

.NET Core SDK 安裝在多個位置。只會顯示安裝在 'C:\Program Files\dotnet\sdk\' 之 SDK 的範本。

當您在 C:\Program Files\dotnet\sdk\ 以外的目錄中至少安裝了一次 .NET Core SDK 時，就會看到此訊息。通常，當使用複製/貼上而不是 MSI 安裝程式在電腦上部署 .NET Core SDK 時，就會發生這種情況。

請解除安裝所有 32 位元 .NET Core SDK 和執行階段，以避免出現此警告。從 [控制台]>[程式和功能]> 解除安裝或變更程式。如果您瞭解警告發生的原因及其含意，可以忽略該警告。

未偵測到 .NET Core SDK

在 ASP.NET Core 的 Visual Studio [新增專案] 對話方塊中，您可能會看到下列警告：

未偵測到 .NET Core SDK，請確定它們包含在環境變數 PATH 中。
執行 dotnet 命令時，警告會顯示為：

找不到任何已安裝的 dotnet SDK。

當環境變數 PATH 未指向電腦上的任何 .NET Core SDK 時，會出現這些警告。若要解決此問題：

安裝 .NET Core SDK (英文)。從 .NET 下載取得最新的安裝程式。
確認 PATH 環境變數指向 SDK 的安裝位置 (64 位元/x64 為 C:\Program Files\dotnet\；32 位元/x86 則為 C:\Program Files (x86)\dotnet\)。 SDK 安裝程式通常會設定 PATH。在同一部電腦上請一律安裝相同位元的 SDK 和執行階段。

安裝 .NET Core 裝載套件組合之後遺漏 SDK

安裝 .NET Core 裝載套件組合將會在安裝 .NET Core 執行階段時修改 PATH，以指向 32 位元 (x86) 版本的 .NET Core (C:\Program Files (x86)\dotnet\)。若使用 32 位元 (x86) .NET Core dotnet 命令時，這可能會導致遺漏 SDK (未偵測到 .NET Core SDK)。要解決此問題，請在 PATH 上將 C:\Program Files\dotnet\ 移至 C:\Program Files (x86)\dotnet\ 之前的位置。

從應用程式取得資料

如果應用程式能夠回應要求，您可以使用中介軟體從應用程式取得下列資料：

要求：方法、配置、主機、路徑基底、路徑、查詢字串、標頭
連線：遠端 IP 位址、遠端連接埠、本機 IP 位址、本機連接埠、用戶端憑證
Identity：名稱、顯示名稱
組態設定
環境變數

將下列中介軟體程式碼放在 Startup.Configure 方法之要求處理管線的開頭。執行中介軟體之前會先檢查環境，以確保程式碼只會在開發環境中執行。

若要取得環境，請使用下列其中一種方法：

將 IHostingEnvironment 插入 Startup.Configure 方法，並使用區域變數檢查環境。下列範例程式碼會示範如何使用這個方法。
將環境指派給 Startup 類別中的屬性。使用該屬性 (例如 if (Environment.IsDevelopment())) 檢查環境。

public void Configure(IApplicationBuilder app, IHostingEnvironment env, 
    IConfiguration config)
{
    if (env.IsDevelopment())
    {
        app.Run(async (context) =>
        {
            var sb = new StringBuilder();
            var nl = System.Environment.NewLine;
            var rule = string.Concat(nl, new string('-', 40), nl);
            var authSchemeProvider = app.ApplicationServices
                .GetRequiredService<IAuthenticationSchemeProvider>();

            sb.Append($"Request{rule}");
            sb.Append($"{DateTimeOffset.Now}{nl}");
            sb.Append($"{context.Request.Method} {context.Request.Path}{nl}");
            sb.Append($"Scheme: {context.Request.Scheme}{nl}");
            sb.Append($"Host: {context.Request.Headers["Host"]}{nl}");
            sb.Append($"PathBase: {context.Request.PathBase.Value}{nl}");
            sb.Append($"Path: {context.Request.Path.Value}{nl}");
            sb.Append($"Query: {context.Request.QueryString.Value}{nl}{nl}");

            sb.Append($"Connection{rule}");
            sb.Append($"RemoteIp: {context.Connection.RemoteIpAddress}{nl}");
            sb.Append($"RemotePort: {context.Connection.RemotePort}{nl}");
            sb.Append($"LocalIp: {context.Connection.LocalIpAddress}{nl}");
            sb.Append($"LocalPort: {context.Connection.LocalPort}{nl}");
            sb.Append($"ClientCert: {context.Connection.ClientCertificate}{nl}{nl}");

            sb.Append($"Identity{rule}");
            sb.Append($"User: {context.User.Identity.Name}{nl}");
            var scheme = await authSchemeProvider
                .GetSchemeAsync(IISDefaults.AuthenticationScheme);
            sb.Append($"DisplayName: {scheme?.DisplayName}{nl}{nl}");

            sb.Append($"Headers{rule}");
            foreach (var header in context.Request.Headers)
            {
                sb.Append($"{header.Key}: {header.Value}{nl}");
            }
            sb.Append(nl);

            sb.Append($"Websockets{rule}");
            if (context.Features.Get<IHttpUpgradeFeature>() != null)
            {
                sb.Append($"Status: Enabled{nl}{nl}");
            }
            else
            {
                sb.Append($"Status: Disabled{nl}{nl}");
            }

            sb.Append($"Configuration{rule}");
            foreach (var pair in config.AsEnumerable())
            {
                sb.Append($"{pair.Path}: {pair.Value}{nl}");
            }
            sb.Append(nl);

            sb.Append($"Environment Variables{rule}");
            var vars = System.Environment.GetEnvironmentVariables();
            foreach (var key in vars.Keys.Cast<string>().OrderBy(key => key, 
                StringComparer.OrdinalIgnoreCase))
            {
                var value = vars[key];
                sb.Append($"{key}: {value}{nl}");
            }

            context.Response.ContentType = "text/plain";
            await context.Response.WriteAsync(sb.ToString());
        });
    }
}

對 ASP.NET Core 應用程式進行偵錯

下列連結提供 ASP.NET Core 應用程式偵錯的相關資訊。