容器间Web请求失败排查：.NET微服务Docker Compose配置问题

1. 先确认容器间的访问端口（核心问题） #

Docker Compose容器间通信用的是容器内部的端口，不是映射到主机的端口。比如你在docker-compose.yml里给TenantService配置了ports: "5001:8080"，这里的8080是容器内部端口，5001是主机映射端口。Gateway调用时必须用http://tenantservice:8080，而不是http://tenantservice:5001——你之前可能误用了主机映射端口，导致连接被拒。

2. 检查.NET服务的监听地址 #

默认情况下，.NET极简API在开发环境可能只监听localhost，这会导致容器外的请求（包括其他容器）无法访问。解决方法二选一：

• 在Program.cs里修改监听配置：

  var builder = WebApplication.CreateBuilder(args);
  // 添加这行或者修改现有配置
  builder.WebHost.ConfigureKestrel(options =>
  {
      options.ListenAnyIP(8080); // 监听所有IP，对应容器内部端口
  });
  

• 或者在Dockerfile里添加环境变量：

  ENV ASPNETCORE_URLS=http://0.0.0.0:8080
  

3. 修正docker-compose.yml的端口映射（符合你的目标） #

你说主机能访问所有服务，说明TenantService和IdentityProvider都配置了ports字段。要实现“仅Gateway对外”，需要删掉这两个服务的ports配置，只保留Gateway的：

services:
  gateway:
    image: gateway
    ports:
      - "5000:8080" # 仅对外暴露Gateway的端口
  tenantservice:
    image: tenantservice
    # 删掉ports配置，禁止外部直接访问
  identityprovider:
    image: identityprovider
    # 删掉ports配置

4. 验证容器间的网络连通性 #

直接在Gateway容器内测试TenantService的可达性：

1. 用docker ps找到Gateway的容器ID
2. 进入容器：docker exec -it <gateway-container-id> bash
3. 执行curl命令测试：curl http://tenantservice:8080/api/your-endpoint
   • 如果curl失败：说明是网络或TenantService的启动/监听问题
   • 如果curl成功：问题出在Gateway的代码调用逻辑（比如URL拼写错误、协议用了HTTPS但TenantService没配置SSL）

5. 查看容器日志定位细节 #

通过日志找具体错误：

• 查看Gateway日志：docker logs <gateway-container-id>
• 查看TenantService日志：docker logs <tenantservice-container-id>
  日志里可能会显示连接超时、端口未监听、服务未启动完成等具体原因。

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