Nginx 故障排查之斜杠(/) --（附 Nginx 常用命令）

码农爱java

已于 2024-04-09 14:13:45 修改

阅读量1.6k

点赞数 37

分类专栏： Nginx 文章标签： nginx 运维

于 2024-03-24 10:30:00 首次发布

本文链接：https://blog.csdn.net/weixin_42118323/article/details/136966571

版权

Nginx 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

问题场景：

项目中用到了多个子域名，测试环境通过子域名进行接口访问的时候返回 404 NOT_FOUND，经过排查测试后确定是 Nginx 配置问题，而导致事故的根本原因是运维在Nginx配置的时候少配置了一个斜杠（/），下面我们来聊聊具体情况。

故障现象如下：

nginx 配置如下：

 location /api/{
       client_max_body_size 100m;
       proxy_connect_timeout 120;
       proxy_send_timeout 120;
       proxy_read_timeout 120;
       proxy_set_header Host $http_host;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_set_header REMOTE-HOST $remote_addr;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_pass http://10.xxx.xxx.xxx:8080/api;
    }

接口请求结果如下：

在这里插入图片描述

{
    "code": 404,
    "message": "404 NOT_FOUND",
    "data": ""
}

问题分析：

接口不存在，直接通过服务部署的机器，通过 ip + 端口访问，正常响应。
网关 Gateway 有问题，通过 Gateway 服务部署的机器，通过 ip + 端口访问，正常响应。
Nginx 配置有问题，通过 Nginx 的机器IP和暴露的端口去访问，响应 404，基本可以确定Nginx 配置有问题。

原因分析：

通过对问题现象分析，我们基本确定是 Nginx 配置的问题，我们取查询 Nginx 的日看是否可以找到有效信息，没有找到有用信息。
接着我们对 Gateway 日志进行分析，看看是否可以找到有用的信息，我们发现了这样一段日志， /apidxx/v1/szzz/method（真实接口路径不方便暴露，请理解），apidxx 这段有明显问题，api 后面应该有个斜杆 / ，才接着是 dxx 才对，这段日志是在 Gateway 发现的，再次证明是 Nginx 配置的问题，现在我们进一步确定了是少了个斜杠 /，已经确定到了问题，现在去排查 Nginx 配置即可。

分析 Nginx 配置：

我们发现 proxy_pass http://10.xxx.xxx.xxx:8080/api 这段配置在api 后面没有接斜杠 / ，对比我们上面的分析，果断加上斜杠试试，重启后问题解决，正确的 Nginx 配置如下：

location /api/{
      client_max_body_size 100m;
      proxy_connect_timeout 120;
      proxy_send_timeout 120;
      proxy_read_timeout 120;
      proxy_set_header Host $http_host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header REMOTE-HOST $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_pass http://10.xxx.xxx.xxx:8080/api/;
   }

问题解决了，下面我们来分析一下，斜杠的各种场景。

location、proxy_pass 斜杠分析：

以下分析，不在赘述验证流程，感兴趣的朋友可以自己去验证，也欢迎提出疑问。
虚拟场景：我们需要通过 Nginx 代理访问地址：http://127.0.0.1/api/zt/app/list。

location加斜杠，proxy_pass 加api（上面分析的案例），如下：

location /api/ {
    proxy_pass http://127.0.0.1:8888/api;
}

实际访问地址：http://127.0.0.1:8888/apizt/app/list，这是个错误的地址，apizt 之间少了斜杠 /，导致 404。

location 不加斜杠，proxy_pass 加 api，api后面不加斜杠 /，如下：

location /api {
    proxy_pass http://127.0.0.1:8888/api;
}