Asp.Net Core App 部署故障示例 2

相關閱讀：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執行路徑不同會有不同結果，因此可以用上述方法來定位類似的路徑問題。