Docker端口转发异常排查：Catalog.API服务8000端口无法访问

1. 确认容器内应用是否正常监听80端口 #

• 查看容器日志，验证ASP.NET Core服务启动状态：

  docker logs catalog.api
  

  日志应包含类似Now listening on: http://[::]:80或Now listening on: http://0.0.0.0:80的条目，若显示绑定到127.0.0.1:80，则外部无法访问。
• 进入容器检查端口监听情况：

  docker exec -it catalog.api ss -tulpn
  

  确保输出中有LISTEN状态的*:80或:::80记录。

2. 强制ASP.NET Core监听所有网卡 #

ASP.NET Core在Development环境下可能默认绑定127.0.0.1，需强制指定监听所有网卡：

• 在docker-compose.yml的catalog.api服务中添加环境变量：

  environment:
    - ASPNETCORE_ENVIRONMENT=Development
    - "DatabaseSettings:ConnectionString=mongodb://catalogdb:27017"
    - ASPNETCORE_URLS=http://0.0.0.0:80
  

• 更新后重启容器：

  docker-compose -f .\docker-compose.yml -f .\docker-compose.override.yml up -d --force-recreate catalog.api
  

3. 验证容器是否正常运行 #

• 检查容器状态，确认无频繁重启：

  docker ps
  

  查看STATUS列是否为Up X minutes，若显示Restarting，说明服务启动失败，需通过日志定位数据库连接或其他启动错误。
• 注意depends_on仅控制启动顺序，不保证MongoDB服务就绪，可在应用中添加数据库连接重试逻辑，或在docker-compose中配置healthcheck等待MongoDB就绪后再启动API服务。

4. 检查宿主机端口占用情况 #

确认宿主机8000端口未被其他进程占用：

• Windows系统：

  netstat -ano | findstr :8000
  

• Linux/macOS系统：

  lsof -i :8000
  

  若有其他进程占用，需停止该进程或修改docker-compose中的端口映射（如改为8001:80）。

5. 检查docker-compose.override.yml配置 #

启动命令中使用了override文件，需确认该文件未覆盖端口映射或修改网络配置：

• 查看override文件内容，确保没有network_mode: host、修改ports值，或添加限制网络访问的配置。

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