Azure App Service 與 IIS 搭配 ASP.NET Core 時的常見錯誤疑難排解

本主題描述最常見錯誤，並提供在 Azure Apps Service 和 IIS 上裝載 ASP.NET Core 應用程式時的疑難排解建議。

請參閱常見應用程式啟動錯誤的針對 Azure App Service 和 IIS 上的 ASP.NET Core 進行疑難排解資訊，以及如何診斷錯誤的指示。

收集下列資訊：

• 瀏覽器行為 (例如狀態碼和錯誤訊息)。
• 應用程式事件記錄檔項目
  • Azure App Service：請參閱針對 Azure App Service 和 IIS 上的 ASP.NET Core 進行疑難排解。
  • IIS
    1. 在 [Windows] 功能表中選取 [開始]，鍵入「事件檢視器」，然後按 Enter 鍵。
    2. 在 [事件檢視器] 開啟之後，展開提要欄位中的 [Windows 記錄檔]>[應用程式]。
• ASP.NET Core 模組 stdout 和偵錯記錄項目
  • Azure App Service：請參閱針對 Azure App Service 和 IIS 上的 ASP.NET Core 進行疑難排解。
  • IIS：遵循＜ASP.NET Core 模組＞主題中記錄檔建立和重新導向和增強型診斷記錄小節的指示。

將錯誤資訊與下列常見錯誤進行比較。 如果找到相符情況，請依照疑難排解建議進行操作。

本主題中的錯誤清單並不完整。 如果您遇到這裡未列出的錯誤，請使用本主題底部的 [內容意見反應] 按鈕來開啟新的問題，並提供如何重現錯誤的詳細指示。

重要

ASP.NET Core 預覽版本與 Azure App Service

根據預設，ASP.NET Core 預覽版本不會部署至 Azure App Service。 若要裝載使用 ASP.NET Core 預覽版本的應用程式，請參閱將 ASP.NET Core 預覽版本部署至 Azure App Service。

作業系統升級已移除 32 位元的 ASP.NET Core 模組

應用程式記錄檔：無法載入模組 DLL C:\WINDOWS\system32\inetsrv\aspnetcore.dll。 資料即錯誤。

疑難排解：

作業系統升級時不會保留 C:\Windows\SysWOW64\inetsrv 目錄中的非作業系統檔案。 如果先安裝 ASP.NET Core 模組再升級 OS，然後在 OS 升級之後以 32 位元模式執行任何應用程式集區，就會發生此問題。 作業系統升級之後，請修復 ASP.NET Core 模組。 請參閱安裝 .NET Core 裝載套件組合。 執行安裝程式時，請選取 [修復]。

遺失網站延伸模組、已安裝 32 位元 (x86) 和 64 位元 (x64) 網站延伸模組，或錯誤的處理序位元集合

適用於 Azure 應用程式服務所裝載的應用程式。

• 瀏覽器：HTTP 錯誤 500.0 - ANCM 同處理序處理常式載入失敗

• 應用程式記錄檔：叫用 hostfxr 以尋找同處理序要求處理常式失敗，而不會尋找任何原生相依性。 找不到同處理序要求處理常式。 已從叫用的 hostfxr 擷取輸出：找不到任何相容的架構版本。 找不到指定的架構 'Microsoft.AspNetCore.App' 版本 '{VERSION}-preview-*'。 無法啟動應用程式 '/LM/W3SVC/1416782824/ROOT', ErrorCode '0x8000ffff'。

• ASP.NET Core 模組 stdout 記錄檔：找不到任何相容的架構版本。 找不到指定的架構 'Microsoft.AspNetCore.App' 版本 '{VERSION}-preview-*'。

• ASP.NET Core 模組偵錯記錄：叫用 hostfxr 以尋找同處理序要求處理常式失敗，而不會尋找任何原生相依性。 這最有可能表示應用程式設定不正確，請檢查應用程式設為目標的 Microsoft.NetCore.App 和 Microsoft.AspNetCore.App 版本，並確定已安裝在電腦上。 已傳回失敗的 HRESULT：0x8000ffff。 找不到同處理序要求處理常式。 無法找到任何相容的架構版本。 找不到指定的架構 'Microsoft.AspNetCore.App' 版本 '{VERSION}-preview-*'。

疑難排解：

• 如果在預覽執行階段中執行應用程式，請安裝與應用程式位元和應用程式執行階段版本相符的 32 位元 (x86) 或 64 位元 (x64) 網站延伸模組。 請勿同時安裝這兩個延伸模組或延伸模組的多個執行階段版本。

  • ASP.NET Core {RUNTIME VERSION} (x86) 執行階段
  • ASP.NET Core {RUNTIME VERSION} (x64) 執行階段

  重新啟動應用程式。 請等候數秒，讓應用程式重新啟動。

• 如果在預覽執行階段中執行應用程式，而且已經安裝 32 位元 (x86) 和 64 位元 (x64) 網站延伸模組，請將與應用程式位元不符的網站延伸模組解除安裝。 移除網站延伸模組之後，請重新啟動應用程式。 請等候數秒，讓應用程式重新啟動。

• 如果在預覽執行階段中執行應用程式，且網站延伸模組位元與應用程式相符，請確認預覽網站延伸模組的「執行階段版本」是否與應用程式相符。

• 確認應用程式設定中應用程式的平台與應用程式位元相符。

如需詳細資訊，請參閱將 ASP.NET Core 應用程式部署至 Azure App Service。

已部署 x86 應用程式，但未啟用 32 位元應用程式的應用程式集區

• 瀏覽器：HTTP 錯誤 500.30 - ANCM 同處理序啟動失敗

• 應用程式記錄檔：實體根目錄為 '{PATH}' 的應用程式 '/LM/W3SVC/5/ROOT' 遇到未預期的受控例外狀況，例外狀況代碼 = '0xe0434352'。 如需詳細資訊，請檢查 stderr 記錄檔。 實體根目錄為 '{PATH}' 的應用程式 '/LM/W3SVC/5/ROOT' 無法載入 CLR 和受控應用程式。 CLR 背景工作執行緒不當結束

• ASP.NET Core 模組 stdout 記錄檔：已建立記錄檔，但是空的。

• ASP.NET Core 核心模組偵錯記錄：已傳回失敗的 HRESULT：0x8007023e

SDK 會在發行獨立應用程式時攔截到此案例。 如果 RID 不符合平台目標 (例如 win10-x64 RID 在專案檔中使用 <PlatformTarget>x86</PlatformTarget>)，SDK 就會產生錯誤。

疑難排解：

針對 x86 架構相依部署 (<PlatformTarget>x86</PlatformTarget>)，請啟用 32 位元應用程式的 IIS 應用程式集區。 在 [IIS 管理員] 中，開啟應用程式集區的 [進階設定]，然後將 [啟用 32 位元應用程式] 設定為 [True]。

平台發生 RID 衝突

• 瀏覽器：HTTP 錯誤 502.5 - 處理序失敗

• 應用程式記錄檔：實體根目錄為 'C:{PATH}' 的應用程式 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}' 無法使用命令列 '"C:{PATH}{ASSEMBLY}.{exe|dll}" ' 來啟動處理序，ErrorCode = '0x80004005：ff。

• ASP.NET Core 模組 stdout 記錄檔：無法處理的例外狀況：System.BadImageFormatException：無法載入檔案或組件 '{ASSEMBLY}.dll'。 嘗試載入了格式不正確的程式。

疑難排解：

• 確認應用程式在 Kestrel 本機上執行。 處理序失敗，可能是因為應用程式發生問題。 如需詳細資訊，請參閱針對 Azure App Service 和 IIS 上的 ASP.NET Core 進行疑難排解。

• 如果在升級應用程式和部署更新的組件時，Azure 應用程式部署發生這個例外狀況，請手動刪除來自先前部署的所有檔案。 部署升級的應用程式時，延遲不相容的組件會導致 System.BadImageFormatException 例外狀況。

URI 端點錯誤或停止了網站

• 瀏覽器：ERR_CONNECTION_REFUSED --或-- 無法連線

• 應用程式記錄檔：無項目

• ASP.NET Core 模組 stdout 記錄檔：未建立記錄檔。

• ASP.NET Core 模組偵錯記錄：未建立記錄檔。

疑難排解：

• 確認使用對應用程式正確的 URI 端點。 檢查繫結。

• 確認 IIS 網站不是處於「已停止」狀態。

已停用 CoreWebEngine 或 W3SVC 伺服器功能

作業系統例外狀況：必須安裝 IIS 7.0 CoreWebEngine 和 W3SVC 功能，才能使用 ASP.NET Core 模組。

疑難排解：

確認已啟用適當的角色和功能。 請參閱 IIS 組態。

不正確的網站實體路徑或遺失應用程式

• 瀏覽器： 403 禁止 - 存取被拒--或-- 403.14 禁止 - 網頁伺服器已設為不列出此目錄的內容。

• 應用程式記錄檔：無項目

• ASP.NET Core 模組 stdout 記錄檔：未建立記錄檔。

• ASP.NET Core 模組偵錯記錄：未建立記錄檔。

疑難排解：

檢查 IIS 網站的 [基本設定] 和實體的應用程式資料夾。 確認應用程式位於 IIS 網站實體路徑的資料夾中。

角色不正確、ASP.NET Core 模組未安裝，或權限不正確

• 瀏覽器：500.19 內部伺服器錯誤 - 無法存取所要求的網頁，因為該頁面的相關組態資料無效。 --或-- 無法顯示此頁面

• 應用程式記錄檔：無項目

• ASP.NET Core 模組 stdout 記錄檔：未建立記錄檔。

• ASP.NET Core 模組偵錯記錄：未建立記錄檔。

疑難排解：

• 確認已啟用適當的角色。 請參閱 IIS 組態。

• 開啟 [程式和功能] 或 [應用程式與功能]，並確認已安裝 Windows Server Hosting。 如果已安裝的程式清單中沒有 Windows Server Hosting，請下載並安裝 .NET Core 裝載套件組合。

  目前的 .NET Core 裝載套件組合安裝程式 (直接下載)

  如需詳細資訊，請參閱安裝 .NET Core 裝載套件組合。

• 確定 [應用程式集區]>[處理序模型]>Identity 設定為 ApplicationPoolIdentity，或自訂identity具有正確的權限，可存取應用程式的部署資料夾。

• 若解除安裝 ASP.NET Core Hosting Bundle 並安裝舊版裝載套件組合，applicationHost.config 檔案不會包括 ASP.NET Core Module 的區段。 開啟位於 %windir%/System32/inetsrv/config 的 applicationHost.config，然後尋找 <configuration><configSections><sectionGroup name="system.webServer"> 區段群組。 若區段群組中沒有 ASP.NET Core Module 的區段，請新增區段元素：

  <section name="aspNetCore" overrideModeDefault="Allow" />
  

  或者，您也可以安裝最新版的「ASP.NET Core 裝載套件組合」。 最新版本回溯相容，提供支援的 ASP.NET Core 應用程式。

不正確的 processPath、遺失 PATH 變數、未安裝裝載套件組合、未重新啟動系統/IIS、未安裝 VC++ 可轉散發套件或 dotnet.exe 存取違規

• 瀏覽器：HTTP 錯誤 500.0 - ANCM 同處理序處理常式載入失敗

• 應用程式記錄檔：實體根目錄為 'C:{PATH}' 的應用程式 'MACHINE/WEBROOT/APPHOST/{ASSEMBLY}' 無法使用命令列 '"{...}" ' 來啟動處理序，ErrorCode = '0x80070002：0。 應用程式 '{PATH}' 無法啟動。 在 '{PATH}' 找不到可執行檔。 無法啟動應用程式 '/LM/W3SVC/2/ROOT'，ErrorCode '0x8007023e'。

• ASP.NET Core 模組 stdout 記錄檔：未建立記錄檔。

• ASP.NET Core 模組偵錯記錄：事件記錄檔：無法啟動應用程式 '{PATH}'。 在 '{PATH}' 找不到可執行檔。 已傳回失敗的 HRESULT：0x8007023e

疑難排解：

• 確認應用程式在 Kestrel 本機上執行。 處理序失敗，可能是因為應用程式發生問題。 如需詳細資訊，請參閱針對 Azure App Service 和 IIS 上的 ASP.NET Core 進行疑難排解。

• 檢查 web.config 中 <aspNetCore> 元素上的 processPath 屬性，以確認它是 dotnet (適用於架構相依部署 (FDD)) 或 .\{ASSEMBLY}.exe (適用於自封式部署 (SCD))。

• 若為 FDD，可能無法透過路徑設定存取 dotnet.exe。 確認系統 PATH 設定中有 C:\Program Files\dotnet\。

• 若為 FDD，應用程式集區的使用者identity可能無法存取 dotnet.exe。 確認應用程式集區使用者identity可以存取 C:\Program Files\dotnet 目錄。 確認 C:\Program Files\dotnet 和應用程式目錄上未針對應用程式集區使用者 identity 設定任何拒絕規則。

• 可能已部署 FDD 並安裝 .NET Core，但未重新啟動 IIS。 從命令提示字元依序執行 net stop was /y 和 net start w3svc，重新啟動伺服器或重新啟動 IIS。

• 可能已部署 FDD，但未在主控系統上安裝 .NET Core 執行階段。 如果尚未安裝 .NET Core 執行階段，請在系統上執行「.NET Core 裝載套件組合安裝程式」。

  目前的 .NET Core 裝載套件組合安裝程式 (直接下載)

  如需詳細資訊，請參閱安裝 .NET Core 裝載套件組合。

  如果需要特定執行階段，則請從 .NET 下載頁面下載執行階段，並將其安裝在系統上。 從命令提示字元依序執行 net stop was /y 和 net start w3svc，透過重新啟動系統或重新啟動 IIS 來完成安裝。

不正確的 <aspNetCore> 元素引數

• 瀏覽器：HTTP 錯誤 500.0 - ANCM 同處理序處理常式載入失敗

• 應用程式記錄檔：叫用 hostfxr 以尋找同處理序要求處理常式失敗，而不會尋找任何原生相依性。 這最有可能表示應用程式設定不正確，請檢查應用程式設為目標的 Microsoft.NetCore.App 和 Microsoft.AspNetCore.App 版本，並確定已安裝在電腦上。 找不到同處理序要求處理常式。 已從叫用的 hostfxr 擷取輸出：您是否表示要執行 dotnet SDK 命令？ 請從下列位置安裝 dotnet SDK：https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409 無法啟動應用程式 '/LM/W3SVC/3/ROOT', ErrorCode '0x8000ffff'。

• ASP.NET Core 模組 stdout 記錄檔：您是否想要執行 dotnet SDK 命令？ 請從下列位置安裝 dotnet SDK：https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409

• ASP.NET Core 模組偵錯記錄：叫用 hostfxr 以尋找同處理序要求處理常式失敗，而不會尋找任何原生相依性。 這最有可能表示應用程式設定不正確，請檢查應用程式設為目標的 Microsoft.NetCore.App 和 Microsoft.AspNetCore.App 版本，並確定已安裝在電腦上。 已傳回失敗的 HRESULT：0x8000ffff 找不到同處理序要求處理常式。 已從叫用的 hostfxr 擷取輸出：您是否表示要執行 dotnet SDK 命令？ 請從下列位置安裝 dotnet SDK：https://go.microsoft.com/fwlink/?LinkID=798306&clcid=0x409 已傳回失敗的 HRESULT：0x8000ffff

疑難排解：

• 確認應用程式在 Kestrel 本機上執行。 處理序失敗，可能是因為應用程式發生問題。 如需詳細資訊，請參閱針對 Azure App Service 和 IIS 上的 ASP.NET Core 進行疑難排解。

• 檢查 web.config 中 <aspNetCore> 元素上的 arguments 屬性，以確認它是 (a) .\{ASSEMBLY}.dll (適用於架構相依部署 (FDD))；或 (b) 不存在、空字串 (arguments="")，或是應用程式的引數清單 (arguments="{ARGUMENT_1}, {ARGUMENT_2}, ... {ARGUMENT_X}"，適用於自封式部署 (SCD))。

遺失 .NET Core 共用架構

• 瀏覽器：HTTP 錯誤 500.0 - ANCM 同處理序處理常式載入失敗

• 應用程式記錄檔：叫用 hostfxr 以尋找同處理序要求處理常式失敗，而不會尋找任何原生相依性。 這最有可能表示應用程式設定不正確，請檢查應用程式設為目標的 Microsoft.NetCore.App 和 Microsoft.AspNetCore.App 版本，並確定已安裝在電腦上。 找不到同處理序要求處理常式。 已從叫用的 hostfxr 擷取輸出：找不到任何相容的架構版本。 找不到指定的架構 'Microsoft.AspNetCore.App' 版本 '{VERSION}'。

無法啟動應用程式 '/LM/W3SVC/5/ROOT'，ErrorCode '0x8000ffff'。

• ASP.NET Core 模組 stdout 記錄檔：找不到任何相容的架構版本。 找不到指定的架構 'Microsoft.AspNetCore.App' 版本 '{VERSION}'。

• ASP.NET Core 模組偵錯記錄：已傳回失敗的 HRESULT：0x8000ffff

疑難排解：

若為結構相依部署 (FDD)，請確認已在系統上安裝正確的執行階段。

已停止應用程式集區

• 瀏覽器：503 服務無法使用

• 應用程式記錄檔：無項目

• ASP.NET Core 模組 stdout 記錄檔：未建立記錄檔。

• ASP.NET Core 模組偵錯記錄：未建立記錄檔。

疑難排解：

確認「應用程式集區」不是處於「已停止」狀態。

子應用程式包含<處理常式>區段

• 瀏覽器：HTTP 錯誤 500.19 - 內部伺服器錯誤

• 應用程式記錄檔：無項目

• ASP.NET Core 模組 stdout 記錄檔：根應用程式的記錄檔已建立並顯示正常作業。 未建立子應用程式的記錄檔。

• ASP.NET Core 模組偵錯記錄：根應用程式的記錄檔已建立並顯示正常作業。 未建立子應用程式的記錄檔。

疑難排解：

請確認子應用程式的 web.config 檔案不包含 <handlers> 區段，或子應用程式未繼承父應用程式的處理常式。

父應用程式 web.config 的 <system.webServer> 區段位於 <location> 元素內。 將 InheritInChildApplications 屬性設定為 false，以指出位在父代應用程式子目錄中的應用程式不會繼承 <location> 元素內所指定的設定。 如需詳細資訊，請參閱適用於 IIS 的 ASP.NET Core 模組 (ANCM)。

stdout 記錄檔路徑不正確

• 瀏覽器：應用程式正常回應。

• 應用程式記錄檔：無法在 C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll 中啟動 stdout 重新導向。 例外狀況訊息：已在 {PATH}\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp:84 傳回 HRESULT 0x80070005。 無法在 C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll 中停止 stdout 重新導向。 例外狀況訊息：已在 {PATH} 傳回 HRESULT 0x80070002。 無法在 {PATH}\aspnetcorev2_inprocess.dll 中啟動 stdout 重新導向。

• ASP.NET Core 模組 stdout 記錄檔：未建立記錄檔。

• ASP.NET Core 模組偵錯記錄：無法在 C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll 中啟動 stdout 重新導向。 例外狀況訊息：已在 {PATH}\aspnetcoremodulev2\commonlib\fileoutputmanager.cpp:84 傳回 HRESULT 0x80070005。 無法在 C:\Program Files\IIS\Asp.Net Core Module\V2\aspnetcorev2.dll 中停止 stdout 重新導向。 例外狀況訊息：已在 {PATH} 傳回 HRESULT 0x80070002。 無法在 {PATH}\aspnetcorev2_inprocess.dll 中啟動 stdout 重新導向。

疑難排解：

• web.config 中 <aspNetCore> 元素所指定的 stdoutLogFile 路徑不存在。 如需詳細資訊，請參閱 ASP.NET Core 模組：記錄建立和重新導向。

• 應用程式集區使用者沒有 stdout 記錄檔路徑的寫入權限。

應用程式組態一般問題

• 瀏覽器：HTTP 錯誤 500.0 - ANCM 同處理序處理常式載入失敗 --或-- HTTP 錯誤 500.30 - ANCM 同處理序啟動失敗

• 應用程式記錄檔：變數

• ASP.NET Core 模組 stdout 記錄檔：在應用程式失敗之前，已建立記錄檔但是空的，或已使用一般項目建立記錄檔。

• ASP.NET Core 模組偵錯記錄：變數

疑難排解：

處理序無法啟動，最可能的原因是應用程式組態或程式設計問題。

如需詳細資訊，請參閱下列主題：

• 針對 Azure App Service 和 IIS 上的 ASP.NET Core 進行疑難排解
• 針對 ASP.NET Core 專案進行疑難排解和偵錯