Asp.Net Core App 部署故障示例 2 Windows + IIS 環境部署Asp.Net Core App

相關閱讀：Windows + IIS 環境部署Asp.Net Core App

1.  HTTP Error 502.5 – Process Failure

環境

Windows Server 2012, IIS 8, Asp.Net Core 2.

故障

App按正常流程發佈後經過瀏覽器訪問出現如下錯誤：

HTTP Error 502.5 – Process Failure The application process failed to start The application process started but then stopped The application process started but failed to listen on the configured port

 

排錯

 1. 首先查看服務器上日誌

 能夠看到系統捕捉到兩個錯誤，其中 IIS AspNetCore Module錯誤詳細信息爲：

Application 'MACHINE/WEBROOT/APPHOST/SUGARRUSH.AUTH.WEB' with physical root 'C:\WebSites\WebApplication1\' failed to start process with commandline 'dotnet .\WebApplication1.dll', ErrorCode = '0x80004005 : ff.

此信息與示例1的錯誤很類似，都是在執行 dotnet WebApplication1.dll 時出錯了。

2. 接下來經過命令行工具檢查一下

居然沒有出錯！http://localhost:5000可以正常訪問。這說明服務器中的.Net Core環境應該沒有問題，問題可能出在IIS映射到App的某個環節上。

3. 考慮到映射過程當中最容易發生錯誤的就是路徑問題，所以回顧了一下代碼，Startup.cs中只有一個地方涉及到本地文件路徑：

new X509Certificate2(@"c:\ca\cert.pfx", "123456")

仔細檢查了文件路徑以及cert.pfx的讀取權限（Everyone 徹底控制），均沒有發現問題。

4. 註釋改行代碼，從新部署後App就可以正常訪問了。說明問題就出在文件的讀取上。

解決

參考《關於 X509Certificate2 找到文件路徑的問題》這篇文章，在IIS的「應用程序池-高級設置」中，將「加載用戶配置文件」設置爲True，問題就解決了。

小結

Asp.net Core App 在部署的時候涉及三個主要部分，IIS、Hosting Bundle及程序自己，排除故障的時候相對麻煩。示例1是Hosting Bundle版本問題，本例是IIS配置問題，但最終返回的錯誤信息都是HTTP Error 502.5 – Process Failure，着實不太友好~

後續

先前在執行dotnet WebApplication1.dll時並無報錯，是由於執行路徑是在App的根目錄：

若是是在其它路徑執行，好比默認路徑：

就會發生錯誤：

從中能夠明確知道是X509Certificate2證書路徑問題。

dotnet.exe執行路徑不一樣會有不一樣結果，所以能夠用上述方法來定位相似的路徑問題。