无法访问Jenkins CI/CD部署的.NET 8 WebApi后端请求问题排查

以下是针对你的场景的具体排查和解决方法：

1. 确认Docker端口映射是否正确 #

• 检查Jenkins执行的Shell脚本里的docker run命令，是否包含正确的端口映射参数-p 1001:1001——如果没有做宿主机到容器的端口映射，外部根本无法访问容器内的端口。
• 执行docker inspect <容器ID>，查看输出里的HostConfig.PortBindings字段，确认1001/tcp对应的宿主机端口是否存在且为1001。

2. 验证容器内部服务状态 #

• 进入容器：docker exec -it <容器ID> bash
• 用ss -tulpn | grep 1001（如果容器没装ss，可先执行apt update && apt install iproute2），确认服务监听的是0.0.0.0:1001而非127.0.0.1:1001——后者仅允许容器内部访问，宿主机无法连接。
• 在容器内直接测试Swagger：curl http://localhost:1001/swagger，如果返回404或无法连接，说明服务本身启动有问题，和外部映射无关。

3. 检查Swagger的环境启用配置 #

• .NET 8默认仅在开发环境启用Swagger，查看你的Program.cs代码：

  if (app.Environment.IsDevelopment())
  {
      app.UseSwagger();
      app.UseSwaggerUI();
  }
  

  如果容器运行的是生产环境（默认环境变量ASPNETCORE_ENVIRONMENT=Production），Swagger会被禁用。可以临时设置容器环境变量ASPNETCORE_ENVIRONMENT=Development测试，或者修改代码允许生产环境启用Swagger（注意生产环境的安全风险）。
• 确保Program.cs或启动命令中指定了监听所有网卡的端口：比如添加WebApplication.CreateBuilder(args).WebHost.UseUrls("http://+:1001");，或者在启动命令后追加--urls=http://+:1001。

4. 排查服务器防火墙与安全组 #

• 检查服务器本地防火墙：
  • Ubuntu系统执行ufw status，确认1001端口已开放；未开放则执行ufw allow 1001/tcp。
  • CentOS/RHEL系统执行firewall-cmd --list-ports，未开放则执行firewall-cmd --add-port=1001/tcp --permanent && firewall-cmd --reload。
• 云服务器需额外检查服务商的安全组规则，确保允许外部IP访问1001端口的TCP流量。

5. 核对Dockerfile配置细节 #

• 确认Dockerfile中包含EXPOSE 1001（虽然这只是声明端口，但能避免映射时的混淆）。
• 检查启动命令是否正确，比如：

  ENTRYPOINT ["dotnet", "YourApiName.dll", "--urls=http://+:1001"]
  

  确保没有遗漏端口指定参数。

6. 查看容器日志定位潜在问题 #

• 执行docker logs <容器ID>，仔细查看服务启动的日志信息，是否有未捕获的异常、配置文件错误、依赖缺失等提示——这些问题可能导致服务看似启动成功，但实际无法处理请求。

内容的提问来源于stack exchange，提问作者Doğa Koçak