Docker容器中.NET Core API服务间通信故障排查求助

1. 优先使用Docker Compose服务名称访问 #

Docker Compose会自动为所有服务创建并加入同一个默认网络，同一compose文件内的服务可以直接用服务名称互相访问，这是最稳定的方式，无需依赖IP或localhost。

比如你的docker-compose.yml定义了两个服务：

services:
  orderapi:
    image: orderapi
    ports:
      - "5001:80"  # 主机端口:容器内部端口
  retailinmotionmvc:
    image: retailinmotionmvc
    ports:
      - "5000:80"

那么retailinmotionmvc调用orderapi的地址应该是http://orderapi:80（用容器内部端口，不是主机映射的5001）。

2. 检查docker-compose.override.yml的网络/配置覆盖 #

override文件容易悄悄修改服务的网络隔离或环境变量，重点排查：

• 是否给其中一个服务单独指定了自定义网络，导致两个服务不在同一网络组？比如orderapi加了networks: - custom-net但retailinmotionmvc没加，会直接隔离。
• 环境变量配置是否错误：比如给retailinmotionmvc配置的OrderApiUrl是主机地址（如http://localhost:5001）而非服务名称。

正确的override环境变量配置示例：

retailinmotionmvc:
  environment:
    - OrderApiUrl=http://orderapi:80

3. 手动验证容器间网络连通性 #

进入retailinmotionmvc容器终端，直接测试与orderapi的连通性：

1. 在Visual Studio容器工具中找到retailinmotionmvc容器，右键选择「打开终端」
2. 执行ping orderapi，能ping通则网络正常，问题出在请求路径/端口；ping不通则执行docker network inspect [项目名]_default（默认网络名通常是项目名加_default），确认两个服务都在该网络内。
3. 进一步用curl http://orderapi:80/api/orders测试接口是否能正常响应。

4. 检查HttpClient配置与代码 #

确保代码中没有硬编码错误地址，且配置加载正确：

• 注册HttpClient时读取配置：

builder.Services.AddHttpClient("OrderApi", client =>
{
    client.BaseAddress = new Uri(builder.Configuration["OrderApiUrl"]);
});

• 调用时使用命名客户端：

private readonly HttpClient _orderApiClient;

public HomeController(IHttpClientFactory httpClientFactory)
{
    _orderApiClient = httpClientFactory.CreateClient("OrderApi");
}

public async Task<IActionResult> Index()
{
    var response = await _orderApiClient.GetAsync("/api/orders");
    // 处理响应逻辑
}

注意请求路径要与orderapi的接口路由完全匹配，避免遗漏前缀（如/api）。

5. 确认orderapi的监听地址 #

orderapi必须监听容器的所有网卡（0.0.0.0），而非仅本地回环（localhost），否则其他容器无法访问。ASP.NET Core项目检查Program.cs：

var app = builder.Build();
app.Run("http://0.0.0.0:80"); // 确保不是仅监听localhost

或通过Dockerfile设置环境变量：

ENV ASPNETCORE_URLS=http://+:80

6. 排查防火墙与代理干扰 #

• 临时关闭本地防火墙，测试是否是防火墙阻断了容器间通信
• 关闭Visual Studio的代理设置（若开启），避免代理拦截容器内的请求

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