Docker部署Nginx API网关路由NestJS微服务请求失败求助

核心问题 #

Docker容器内的localhost和127.0.0.1指向容器自身，而非宿主机或其他NestJS微服务容器，这是路由失败的核心原因。此外，原Nginx配置的proxy_pass路径逻辑存在潜在的URL拼接问题，可能导致请求不符合微服务的接口规范。

1. 统一Docker网络 #

所有服务（Nginx网关、NestJS微服务）必须处于同一个Docker网络，才能通过容器名称/服务名互相访问。

• 手动创建专属网络：

docker network create nest-microservices-net

• 启动NestJS微服务时加入该网络：

# 用户管理服务（端口3001）
docker run -d --name user-ms --network nest-microservices-net -p 3001:3001 your-user-ms-image

# 产品管理服务（端口3000）
docker run -d --name product-ms --network nest-microservices-net -p 3000:3000 your-product-ms-image

2. 修改Nginx配置文件 #

将localhost替换为NestJS容器的名称，同时修正proxy_pass的路径逻辑，并添加必要的代理头信息：

修改后的nginx.conf：

events {
    worker_connections 1024;
}
http {
    upstream user_management {
        server user-ms:3001; # 替换为用户服务的容器名称
    }
    
    upstream product_management {
        server product-ms:3000; # 替换为产品服务的容器名称
    }

    server {
        listen 80;
        server_name localhost;

        # 前端请求/users/** 转发到用户服务的/api/v1/users/**
        location /users {
            proxy_pass http://user_management/api/v1/users;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }

        # 前端请求/api/v1/** 转发到产品服务的/api/v1/products/**
        location /api/v1/ {
            proxy_pass http://product_management/api/v1/products/; # 末尾加/保证路径拼接正确
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }

        location /test {
            root /usr/share/nginx/html;
            index index.html;
        }

        # 默认请求转发到产品服务的/Products路径
        location / {
            proxy_pass http://product_management/Products;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
    }
}

注意：proxy_pass末尾的/会影响路径拼接：如果有/，Nginx会去掉location匹配的前缀后拼接；如果没有，则保留前缀。请根据微服务的接口路径调整。

3. 重新构建并启动Nginx网关 #

将修改后的配置打包进镜像，启动时加入统一网络：

# 构建Nginx网关镜像
docker build -t nest-nginx-gateway .

# 启动容器并加入指定网络
docker run -d --name nginx-gateway --network nest-microservices-net -p 80:80 nest-nginx-gateway

4. 更便捷的管理方式：Docker Compose #

用docker-compose.yml统一编排所有服务，自动创建网络并管理依赖：

version: '3.8'

networks:
  nest-microservices-net:
    driver: bridge

services:
  nginx-gateway:
    build: .
    ports:
      - "80:80"
    networks:
      - nest-microservices-net
    depends_on:
      - user-ms
      - product-ms

  user-ms:
    image: your-user-ms-image
    ports:
      - "3001:3001"
    networks:
      - nest-microservices-net

  product-ms:
    image: your-product-ms-image
    ports:
      - "3000:3000"
    networks:
      - nest-microservices-net

启动所有服务：

docker-compose up -d

验证与排查 #

• 测试用户服务路由：

curl http://localhost/users/1
# 预期转发到 http://user-ms:3001/api/v1/users/1

• 测试产品服务路由：

curl http://localhost/api/v1/list
# 预期转发到 http://product-ms:3000/api/v1/products/list

• 查看Nginx日志排查错误：

docker logs nginx-gateway

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