NestJS微服务Docker Compose运行异常：网关无法连接Auth服务

核心问题 #

网关容器内尝试通过127.0.0.1:3000访问auth服务，这在Docker环境中是错误的——每个容器都有独立的网络栈，127.0.0.1指向容器自身，而非主机或其他容器。本地直接运行nest start时所有服务共享主机网络，所以127.0.0.1能正常访问。

修复步骤 #

1. 修改网关服务的目标地址 #

在网关代码中，将访问auth服务的地址从http://127.0.0.1:3000改为http://auth:3000。Docker Compose的自定义网络（这里是docker_dev_cloud）会自动将服务名auth解析为对应容器的IP地址。

2. 确保auth服务监听正确的地址 #

检查auth服务的NestJS配置，确保它监听0.0.0.0而非127.0.0.1。如果服务只绑定127.0.0.1，即使容器端口映射正确，其他容器也无法访问。示例配置：

// auth/src/main.ts
async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  await app.listen(3000, '0.0.0.0'); // 绑定0.0.0.0
}
bootstrap();

3. 可选：添加服务启动依赖（避免时序问题） #

如果网关比auth服务先启动，可能会出现短暂的连接失败。可以在docker-compose.yml中给gateway添加depends_on，确保auth容器先启动：

services:
  gateway:
    # ... 其他配置
    depends_on:
      - auth

注意：depends_on只保证容器启动顺序，不保证auth服务完全就绪。如果需要等待服务就绪，可添加健康检查配置。

验证 #

重新构建并启动服务：

docker-compose down && docker-compose up --build

此时网关应该能正常连接到auth服务。

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