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执行路径不同会有不同结果，因此可以用上述方法来定位类似的路径问题。