.NET 8 Web API部署至Docker后无法访问，求排查方案

1. 端口映射与访问地址检查 #

• 核对docker-compose.yml和docker-compose.override.yml的端口映射配置：.NET 8 Web API默认在容器内监听8080端口，确认宿主机端口与容器端口的映射是否正确，比如是否配置了ports: - "5000:8080"。访问时需使用宿主机端口，例如http://localhost:5000/swagger或http://localhost:5000/weatherforecast。
• 查看launchsettings.json中的Docker配置，确认applicationUrl是否设置为http://+:8080，避免仅监听localhost导致容器外部无法访问。
• 执行docker ps命令，检查容器的端口绑定状态，确认无端口冲突导致映射失效。

2. Swagger与环境配置验证 #

• .NET 8默认仅在Development环境下启用Swagger。检查容器运行时的环境变量：在docker-compose文件中确认是否设置了ASPNETCORE_ENVIRONMENT: Development。如果是Production环境，Swagger默认不会加载，直接调用API需确保路由正确（比如/weatherforecast）。
• 检查Program.cs中的Swagger配置代码，确认builder.Services.AddSwaggerGen();、app.UseSwagger();和app.UseSwaggerUI();是否存在，且未被错误的环境判断逻辑屏蔽（比如默认代码是包裹在if (app.Environment.IsDevelopment())中的，若要在Production启用需移除该判断）。

3. 容器内部与网络连通性测试 #

• 进入容器内部测试API可用性：执行docker exec -it <容器ID> curl http://localhost:8080/weatherforecast，如果能正常返回数据，说明应用本身无问题，问题出在外部访问的网络或映射环节。
• 确认应用监听地址：在Program.cs中添加builder.WebHost.UseUrls("http://+:8080");，确保应用监听容器内所有IP，而非仅localhost。
• 排查防火墙/安全组：确认宿主机的防火墙未阻挡映射的端口，若部署在云服务器，需检查安全组规则是否开放对应端口。

4. 日志与启动细节排查 #

• 提升日志详细度：在appsettings.json中将Logging的LogLevel设置为Debug：

  "Logging": {
    "LogLevel": {
      "Default": "Debug",
      "Microsoft.AspNetCore": "Debug"
    }
  }
  

  重新部署后，执行docker logs -f <容器ID>实时查看启动日志，确认应用是否完成启动、监听端口是否正确，是否存在隐藏的依赖加载或配置错误。
• 检查Dockerfile启动命令：确认ENTRYPOINT ["dotnet", "YourProjectName.dll"]中的项目名称正确，无拼写错误，且未遗漏必要的启动参数。

常见修复示例 #

• 添加环境变量启用Swagger：在docker-compose.yml中加入：

  environment:
    - ASPNETCORE_ENVIRONMENT=Development
  

• 修正应用监听地址：在Program.cs中添加：

  builder.WebHost.UseUrls("http://+:8080");
  

• 修正端口映射：确保docker-compose的ports配置正确：

  ports:
    - "5000:8080"
  

内容的提问来源于stack exchange，提问作者Jyothish Bhaskaran