Docker部署.NET Core API遭遇HTTP ERROR 404问题求助

我来帮你一步步排查这个问题，从你给出的配置来看，容器启动、端口映射和监听设置的基础配置都是没问题的，日志也显示服务正常监听http://[::]:5000，那404的问题大概率出在API本身的路由配置或者发布细节上，我们可以从以下几个方向入手：

1. 优先验证API路由配置是否正确 #

这是最常见的404原因，先确认你的控制器和Action有没有正确标注路由属性：

• 确保控制器类上添加了[ApiController]和路由前缀，比如：

  [ApiController]
  [Route("api/[controller]")]
  public class ValuesController : ControllerBase
  {
      [HttpGet]
      public IActionResult Get()
      {
          return Ok("Hello World");
      }
  }
  

• 如果是这种配置，你访问的URL应该是http://localhost:5000/api/values，而不是直接访问根路径http://localhost:5000，后者会返回404。
• 你可以直接在容器内部测试API是否正常，执行以下命令：

  docker exec -it appmanager curl http://localhost:5000/api/你的控制器路径
  

  如果容器内curl能返回正确结果，说明API本身没问题，问题可能出在本地网络或防火墙；如果容器内也返回404，那肯定是路由配置的问题。

2. 检查发布的应用内容是否完整 #

有时候dotnet publish可能没有打包全必要的文件，导致API无法正确加载路由或配置：

• 进入容器查看发布目录的内容：

  docker exec -it appmanager ls -la /app
  

  确认AppManagerAPI.dll、依赖的DLL文件，以及appsettings.json/appsettings.Production.json是否存在。
• 检查Production环境的配置文件，看是否有覆盖路由或中间件的特殊设置，比如是否禁用了某些路由规则。

3. 确认端口监听和环境变量是否被覆盖 #

虽然日志显示监听5000端口，但可以再做几个验证：

• 检查容器内的端口是否真的被dotnet进程占用：

  # 如果容器没有netstat，先安装工具
  docker exec -it appmanager apt update && apt install net-tools -y
  # 查看端口监听情况
  docker exec -it appmanager netstat -tulpn | grep 5000
  

  应该能看到dotnet进程监听0.0.0.0:5000或[::]:5000。
• 检查是否有环境变量覆盖了你的UseUrls设置：

  docker exec -it appmanager printenv | grep ASPNETCORE_URLS
  

  如果输出了ASPNETCORE_URLS，它的值会优先于代码里的UseUrls配置，确保它包含http://*:5000。

4. 本地网络和防火墙排查 #

如果容器内测试API正常，但外部访问404：

• 先在本地机器上测试端口是否能连通：

  curl http://localhost:5000/api/你的控制器路径
  # 或者用telnet测试端口
  telnet localhost 5000
  

• 如果连不上，检查本地防火墙是否允许5000端口的入站请求，临时关闭防火墙再测试，确认是否是防火墙拦截了请求。

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