Nginx路由配置求助：/gc路径代理转发失效问题排查

我来帮你排查下这个路由转发的问题，你已经走对了大部分路子，不过可能有几个细节和Docker环境特有的坑没注意到：

1. 修正server_name的错误配置 #

你的server_name写了http://example.com，这是典型的配置失误——server_name只需要填写主机名（比如example.com），不需要带协议头。Nginx是通过这个字段匹配请求的Host头，带http://的话根本匹配不上，这很可能是/gc路径没触发代理的核心原因之一。

修正后的server块开头：

server {
    listen 80;
    server_name example.com; # 去掉多余的http://
    # 其他配置...
}

2. 调整location的匹配规则 #

你用了location /gc/（末尾带斜杠），这意味着只有当请求路径以/gc/开头才会匹配，比如http://example.com/gc/test会触发转发，但http://example.com/gc（不带末尾斜杠）会被根路径的location接管，转发到app1。

如果想同时匹配/gc和/gc/两种请求，可以改成：

location /gc {
    proxy_pass http://app2:8080/;
    # 注意：如果app2的接口本身是/gc开头的，就去掉proxy_pass末尾的/，改成proxy_pass http://app2:8080;
}

这里的斜杠很关键：带斜杠的话，Nginx会把/gc后面的路径直接拼到app2的根路径；不带斜杠的话，会把整个/gc/xxx路径拼到app2的地址后，比如http://app2:8080/gc/xxx，你可以根据app2的实际接口路径调整。

3. 排查Docker网络连通性 #

这是Docker环境下代理最容易踩的坑：Nginx容器必须和app1、app2容器在同一个Docker网络里，否则Nginx无法通过app1、app2这些容器名解析到对应的服务。

• 先检查容器的网络归属：
  执行docker network ls查看现有网络，再用docker inspect <容器名> | grep Networks查看每个容器的网络配置。
• 如果不在同一网络，把Nginx容器加入到app1/app2所在的网络：

  docker network connect <目标网络名> <nginx容器名>
  

  要是用docker-compose管理服务的话，默认所有服务都会在同一个网络里，不用额外配置。

4. 查看Nginx日志定位问题 #

如果上面的调整都没解决，直接看日志是最快的排查方式：

• 访问日志（access.log）：能看到请求是否命中了/gc的location，以及转发的目标地址。
• 错误日志（error.log）：如果出现502、503错误，说明Nginx连不上app2，大概率是网络不通或者app2服务未正常启动。

你可以进入Nginx容器实时查看日志：

docker exec -it <nginx容器名> tail -f /var/log/nginx/access.log /var/log/nginx/error.log

最后给你一个完整的修正后配置参考，还加了常用的proxy头配置，避免后端服务识别不到真实请求信息：

server {
    listen 80;
    server_name example.com;

    location /gc {
        proxy_pass http://app2:8080/;
        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_set_header X-Forwarded-Proto $scheme;
    }

    location / {
        proxy_pass http://app1:8081/;
        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_set_header X-Forwarded-Proto $scheme;
    }
}

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