升级至.NET 8后Nginx无法向ASP.NET Core应用发送请求排查

1. .NET 8 默认绑定地址变更 #

.NET 8 中，ASP.NET Core 应用默认绑定地址从 http://localhost:5000 调整为 http://[::]:8080（优先IPv6，同时兼容IPv4）。如果Nginx配置仍指向 127.0.0.1:5000，而实际应用并未在此地址监听，就会触发连接提前关闭的错误。

• 解决方法：
  • 修改应用配置，指定绑定回原地址，在 Program.cs 中添加：

    builder.WebHost.UseUrls("http://127.0.0.1:5000");
    

  • 或调整Nginx upstream配置，指向应用实际监听地址，比如 http://127.0.0.1:8080 或 http://[::1]:8080。

2. Docker 端口映射与监听地址问题 #

若Docker容器未正确映射端口，或容器内应用未监听 0.0.0.0，宿主机Nginx将无法访问容器内应用。

• 解决方法：
  • 确保Docker运行命令正确映射端口：

    docker run -p 5000:8080 your-image-name
    

  • 同时通过环境变量或代码指定应用监听 0.0.0.0，比如设置环境变量：ASPNETCORE_URLS=http://0.0.0.0:8080。

3. Nginx 超时配置不足 #

.NET 8 启动或请求处理耗时可能超出Nginx默认超时阈值，导致连接被主动断开。

• 解决方法：
  • 在Nginx的location配置块中添加或调整超时参数：

    proxy_connect_timeout 30s;
    proxy_send_timeout 30s;
    proxy_read_timeout 30s;
    

4. 应用隐性启动失败或异常 #

虽镜像能启动，但可能应用启动后快速崩溃，或处理请求时抛出未捕获异常导致连接关闭。

• 解决方法：
  • 查看Docker容器日志确认应用状态：

    docker logs your-container-id
    

  • 检查应用自身日志，排查启动或请求处理阶段的错误信息。

内容的提问来源于stack exchange，提问作者Grigory Zhadko