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
相关推荐
TeleostNaCl3 小时前
一种解决 Win10的微软输入法无法禁用 shift + 空格 切换半角/全角切换bug的方法
经验分享·微软·bug
wy31362282116 小时前
android——开发中的常见Bug汇总与解决方案(闪退)
android·bug
Swift社区2 天前
RN 项目中“页面存在 ≠ 页面可见”会导致哪些隐藏 Bug?
react native·bug·react
tongyue2 天前
天问esp32驱动DHT11官方程序BUG修复
bug
laocooon5238578863 天前
写代码 调bug相关信息
bug
鸿儒5173 天前
记录一个C++操作8位影像的一个bug
开发语言·c++·bug
·云扬·3 天前
【Bug】 Elasticsearch启动失败(exit code 78):2个bootstrap检查问题排查与解决
elasticsearch·bootstrap·bug
BrianGriffin4 天前
get_download_file_path: command not found (asdf bug已解决)
bug
咸虾米_4 天前
解决九两酒商城[uni-pay-co]: Error:执行失败,积 分需要大于等于1的bug
bug·unicloud云开发·微信小程序商城·uniapp项目