Docker化MERN应用后Nginx Proxy Pass失效（404）求助

常见问题点及解决办法 #

1. Nginx代理地址误用localhost（容器内localhost≠宿主机） #

Docker容器里的localhost指向容器自身，不是你的宿主机。Nginx配置必须用Docker Compose中定义的后端服务名称访问后端，比如后端服务叫backend，proxy_pass要写成http://backend:8082/，同时注意路径末尾的斜杠——少了斜杠会导致请求路径多一层/apipoint，后端无对应路由就会404。

错误配置示例：

location /apipoint {
    proxy_pass http://localhost:8082;
}

正确配置示例：

location /apipoint/ {
    proxy_pass http://backend:8082/;
    # 补充请求头，避免后端识别异常
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

2. 前后端路径前缀不匹配 #

如果前端请求/apipoint/xxx，但后端接口前缀是/api，需要做路径重写：

location /apipoint/ {
    # 把/apipoint/xxx重写成/xxx（或/api/xxx，根据后端实际路由调整）
    rewrite ^/apipoint/(.*)$ /$1 break;
    proxy_pass http://backend:8082/;
    # 同上请求头配置
}

或者直接在Node.js后端修改路由前缀：

app.use('/apipoint', require('./routes/your-api-routes'));

3. Docker网络隔离问题 #

确保Nginx和后端容器在同一个Docker网络里。默认Docker Compose会自动创建共享网络，若手动指定网络，需将两个服务都加入：

# docker-compose.yml示例片段
services:
  backend:
    ...
    networks:
      - app-net
  nginx:
    ...
    networks:
      - app-net

networks:
  app-net:
    driver: bridge

4. Nginx配置文件挂载错误 #

检查Docker-Compose.yml是否正确挂载了Nginx配置文件，路径写错的话，Nginx会用默认配置，代理规则根本不生效：

nginx:
  image: nginx:alpine
  ports:
    - "80:80"
  volumes:
    # 本地配置文件挂载到容器内对应路径
    - ./nginx/default.conf:/etc/nginx/conf.d/default.conf
  depends_on:
    - backend
    - frontend

5. 后端路由未匹配请求路径 #

查看后端容器日志，确认Nginx转发的请求路径。比如Nginx把/apipoint/users转发成/apipoint/users，但后端只有/users接口，就会404。这时要么改Nginx重写规则，要么调整后端路由前缀。

快速验证步骤 #

1. 进入Nginx容器测试后端连通性：

   docker exec -it <你的nginx容器名> curl http://backend:8082/你的后端接口路径
   

   返回数据说明网络正常，问题在配置或路径；无返回则排查网络或后端服务。
2. 查看Nginx日志找错误细节：

   docker logs <你的nginx容器名>
   

   日志会显示是Nginx找不到路径，还是后端返回的404。
3. 查看后端日志确认请求是否到达：

   docker logs <你的后端容器名>
   

   看到请求路径后，直接对比后端路由就能定位问题。

内容的提问来源于stack exchange，提问作者Manas S. Roy