Docker容器内无法访问GraphQL API的问题排查求助

以下是针对你的情况的具体排查步骤：

1. 验证容器内应用的监听状态 #

• 进入容器执行命令，查看应用实际监听的端口：

  docker exec -it <你的容器ID或名称> ss -tulpn
  

  确认输出中存在:::5000或0.0.0.0:5000的监听记录（表示监听所有网卡），如果只有127.0.0.1:5000，说明应用仅监听容器内部的localhost，外部无法访问。
• 查看容器启动日志，确认应用启动时的监听地址：

  docker logs <你的容器ID或名称>
  

  正常日志应该包含类似Now listening on: http://[::]:5000的内容，若没有则说明应用未正确绑定端口。

2. 检查环境变量对端口配置的覆盖 #

• 打开env.secrets文件，确认是否存在ASPNETCORE_URLS、ASPNETCORE_HTTP_PORTS这类环境变量：
  • 如果ASPNETCORE_URLS设置为http://localhost:5000，会覆盖appsettings.json中的配置，导致应用仅监听容器内部localhost，外部无法访问。需改为http://*:5000;https://*:5001。
  • .NET 6+还支持ASPNETCORE_HTTP_PORTS=5000和ASPNETCORE_HTTPS_PORTS=5001的配置，确保这些值没有限制为localhost。

3. 确认容器内应用文件的完整性 #

• 你的Dockerfile仅定义了基础镜像和端口暴露，需确认构建镜像时已将应用程序和appsettings.json正确复制到容器的/app目录：

  docker exec -it <你的容器ID或名称> ls /app
  

  若目录下没有应用程序文件或配置文件，说明镜像构建过程缺失了复制步骤，需完善Dockerfile（比如添加COPY指令复制发布后的应用文件）。

4. 排查宿主机器的防火墙/端口拦截 #

• 检查宿主机器的防火墙规则，确保5000和5001端口允许入站请求：
  • Windows：打开「Windows Defender防火墙」→「高级设置」，确认存在允许5000/5001端口的入站规则。
  • Linux：执行sudo ufw allow 5000/tcp和sudo ufw allow 5001/tcp（若使用ufw），或检查iptables规则。

5. 测试容器IP直接访问 #

• 获取容器的内部IP地址：

  docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' <你的容器ID或名称>
  

  在宿主机器上访问http://<容器IP>:5000/graphql，如果能访问，说明端口映射本身没问题，可能是宿主的localhost解析或防火墙问题；如果仍无法访问，说明容器内应用确实未正确对外提供服务。

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