.NET Core微服务Docker容器无法互连问题排查求助

这问题我之前帮不少开发者踩过坑，容器间连通性的细节确实容易忽略，咱们一步步来捋清楚可能的原因：

1. 先确认服务调用地址是否用对了 #

• 本地Visual Studio运行时你可能习惯用localhost或本地IP，但在Docker Compose环境里，容器间通信必须用服务名称作为主机名，而不是localhost。比如你的docker-compose.yml里定义了order-service，其他容器调用它就得写http://order-service:8080，而不是http://localhost:8080。
• 检查你的.NET配置文件（比如appsettings.json），或者启动时的环境变量，确保Docker环境下的服务地址已经替换成了服务名称，别硬编码localhost。可以在docker-compose.yml里通过环境变量动态配置：

  api-service:
    environment:
      - OrderServiceUrl=http://order-service:8080
  

2. 注意端口：用容器内部端口，不是宿主映射端口 #

• 很多人会把宿主端口和容器内部端口设成不同值，但容器间通信只认容器内部的端口。比如你把api-service的80端口映射到宿主的5000，其他容器调用它还是用80端口，不是5000。
• 核对docker-compose.yml里的ports配置，确保右边的内部端口和你的.NET服务监听端口一致：

  ports:
    - "5000:80" # 宿主5000 -> 容器80，容器间调用用80
  

3. 深挖网络连通性细节 #

• 虽然你说容器在同一网络，但可以手动验证：进入一个容器，ping另一个服务的名称，看能不能解析到IP：

  docker exec -it <你的容器名称> ping order-service
  

  如果ping不通，检查docker-compose.yml的networks配置，确保所有服务都挂载到同一个自定义网络（默认的default网络也能用，但自定义网络的DNS解析更稳定）：

  networks:
    ms-network:
      driver: bridge
  
  services:
    api-service:
      networks:
        - ms-network
    order-service:
      networks:
        - ms-network
  

• 如果ping通了但HTTP调用失败，大概率是.NET服务的监听地址问题！确保你的Program.cs里用ListenAnyIP，别只监听localhost：

  // 正确写法：允许容器内所有IP访问
  app.Run("http://0.0.0.0:80");
  // 或者在WebHost配置时指定
  .UseUrls("http://0.0.0.0:80")
  

  要是服务只监听localhost，那只有容器自己能访问，其他容器根本连不上。

4. 排查防火墙或安全组干扰 #

• 宿主机器的防火墙（比如Windows防火墙、Linux的iptables）可能会拦截容器间的通信。可以临时关闭防火墙测试一下，如果能连通了，再给容器网络添加允许规则。

5. 看日志找精准线索 #

• 最后一定要看容器日志！用docker logs <容器名>查看容器输出，或者在.NET里开启详细日志，看调用失败时的具体错误（比如DNS解析失败、连接超时、拒绝连接），这些信息能直接帮你定位问题根源。

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