ASP.NET Core 5独立部署后HTTP Error 502.5 - Process Failure问题求助

数据老陈

2026-9-30

.NET Core 5 独立部署站点浏览器访问异常解决方案

你可以按以下步骤逐一排查问题：

配置应用路径基准
要通过server.com/project子路径访问，需要先在应用代码的Program.cs文件中添加路径基准配置，注意该配置必须放在路由注册、静态资源中间件之前：
```
app.UsePathBase("/project");
```
修改代码后重新发布即可生效。

检查反向代理配置
域名访问通常需要搭配Nginx/IIS/Apache等反向代理服务，确保代理配置正确转发请求头和路径，以Nginx为例，配置参考如下：

location /project {
    proxy_pass http://127.0.0.1:5000;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

同时要在Program.cs中添加转发头中间件，放在路径基准配置之后：

app.UseForwardedHeaders(new ForwardedHeadersOptions
{
    ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto
});

验证运行权限与工作目录
如果你是通过系统服务托管运行应用（而非手动执行CLI命令启动），需要确认两点：
1. 发布文件夹对Web服务运行用户（如IIS的IIS_IUSRS、Linux下的www-data）开放读、执行权限
2. 服务的工作目录设置为发布文件夹根目录，避免程序找不到配置文件和静态资源
开启本地日志排查具体错误
如果上述操作后仍有问题，可以在appsettings.json中添加文件日志配置，捕获具体报错信息：
```
"Logging": {
  "LogLevel": {
    "Default": "Information",
    "Microsoft.AspNetCore": "Warning"
  },
  "WriteTo": [
    {
      "Name": "File",
      "Args": {
        "path": "./logs/log-.txt",
        "rollingInterval": "Day"
      }
    }
  ]
}
```
配套安装Serilog.AspNetCore NuGet包即可实现日志落地，根据日志中的报错信息可以进一步定位问题。