Nginx中含proxy_pass的location匹配失效问题排查

你遇到的核心矛盾是：相同的location规则，用return 404能匹配请求，但换成proxy_pass后却触发了默认/ location的请求体大小限制，这说明要么是请求没真正命中自定义location，要么是client_max_body_size的配置存在误解。

以下是具体排查和解决方法：

• 验证请求是否命中目标location
  在你的自定义location块中添加调试响应头，确认请求是否真的匹配到该规则：

  location /my/route/ {
      add_header X-Debug-Location "my-route-matched";
      client_max_body_size 10M;  # 先替换成明确的大值，避免0的歧义
      proxy_pass http://your-backend;
  }
  

  发起请求后查看响应头，如果没有X-Debug-Location字段，说明存在优先级更高的location规则（比如正则匹配location ~ ...）抢占了匹配权。此时可以将自定义location改为正则匹配提升优先级：

  location ~ ^/my/route/ {
      client_max_body_size 10M;
      proxy_pass http://your-backend;
  }
  

• 修正client_max_body_size的配置误解
  注意Nginx中client_max_body_size 0M的行为：部分版本中设置为0并非允许无限大小，而是直接拒绝所有带请求体的请求（会返回413）。你需要设置一个大于5M的具体值，比如10M，来允许目标请求体通过。

• 检查配置语法并重新加载
  执行nginx -t验证配置文件是否存在语法错误，确认无误后执行nginx -s reload重新加载配置，确保修改生效。

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