Bug:Nginx 转发末尾斜杠导致 404 问题分析

【问题描述】使用 IP 访问是否带 / 均正常,Nginx 配置负载均衡后:

复制代码
请求 /api-gateway/api/report/analysis/ 正常工作
请求 /api-gateway/api/report/analysis 返回 404

【Nginx 配置】

复制代码
location ^~ /api-gateway/ {
    proxy_pass http://backend-service/;
    # ... 其他配置
}

【后端接口】

复制代码
接口路径: /api/report/analysis/
请求方法: POST
功能描述: 对查询结果进行智能解读分析

【原理】当 location 指令和 proxy_pass 指令都包含路径时,Nginx 会执行路径替换操作:

  • location 匹配到的前缀部分会被 proxy_pass 中指定的路径替换

  • 剩余的 URI 部分会直接拼接到 proxy_pass 的地址后面

    location ^~ /api-gateway/ → proxy_pass http://backend-service/
    ^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^
    这部分会被替换 替换成这个

【请求带末尾斜杠】

复制代码
原始请求: /api-gateway/api/report/analysis/
         |______________||____________________|
          匹配部分(被替换)    剩余部分(保留)

转发结果: http://backend-service/ + api/report/analysis/
       = http://backend-service/api/report/analysis/

【请求不带末尾斜杠】

复制代码
原始请求: /api-gateway/api/report/analysis
         |______________||___________________|
          匹配部分(被替换)    剩余部分(保留)

转发结果: http://backend-service/ + api/report/analysis
       = http://backend-service/api/report/analysis

**【问题】为什么不走 Nginx 时带不带斜杠都可以?**大多数现代 Web 框架都内置了对末尾斜杠的容错处理,比如重定向机制。通过 Nginx 代理访问,这种自动重定向机制可能不生效,或者 Nginx 拦截了重定向响应。

复制代码
【NG】
路由匹配失败,后端无这样的接口:http://backend-service/api/report/analysis

【IP】
依赖Flask等框架重定向:http://ip:port/api/report/analysis
相关推荐
这个软件需要设计一下2 天前
ninedata安装磁盘不足问题解决
运维·bug
热爱生活的五柒2 天前
cc-switch安装方法、介绍及遇到的bug
bug·cc-switch
Greenland_122 天前
Android 混淆与混淆后bug日志问题定位
android·bug
应用市场2 天前
踩坑记录:有符号整数位运算的那些隐蔽Bug——符号扩展、算术右移与补码
java·开发语言·bug
一灰灰blog3 天前
Jar包会自己消失?Excel会“记忆“数据?我遇到了两个灵异bug
java·spring boot·bug·excel
王家视频教程图书馆4 天前
修复服务端500相应,修复客户端上传文件.tmp 服务端接受不到文件bug
bug
qq_401700414 天前
Qt开发过程中遇到哪些经典的bug
qt·bug
0白露6 天前
关闭搜狗输入法右下角广告,可以适用于大多数应用系统通知的广告
windows·bug
一只自律的鸡7 天前
【Linux驱动】bug处理 ens33找不到IP
linux·运维·bug
Lichenpar8 天前
Springboot采用FastJson2作为MessageConverter时,配置的全局日期类型序列化转换BUG
java·开发语言·bug