Linux Nginx 请求头转发丢失怎么检查 location 嵌套规则-Nginx-PHP中文网

nginx location 块不支持嵌套，所谓“嵌套路由”是误解；请求头丢失主因是未启用 underscores_in_headers on 且未用 proxy_set_header 显式透传自定义头。

linux nginx 请求头转发丢失怎么检查 location 嵌套规则

Linux 下 Nginx 请求头转发丢失，通常和 location 配置无关——因为 Nginx 的 location 块根本不支持嵌套。所谓“嵌套规则”本身就是一个常见误解，Nginx 启动时会直接报错："location" directive is not allowed here。所以第一步不是检查嵌套，而是确认你有没有误写嵌套结构。

先排除 location 语法错误

检查配置中是否存在类似这样的非法写法：

location /api/ {
location /api/v2/ { ... } ← 这行会报错，Nginx 不允许
}

正确做法是所有 location 平级书写，靠匹配优先级区分逻辑层级，例如：

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载

location /api/ { ... }（前缀匹配，较宽泛）
location /api/v2/ { ... }（更长前缀，自动优先生效）
location ~ ^/api/v2/.+/delete$ { ... }（锚定正则，精确控制）

重点查请求头丢失的真正原因

请求头（尤其是带下划线的，如 X_User_ID）丢失，90% 以上不是 location 写法问题，而是以下两个配置缺失：

未开启下划线支持：在 http 或 server 块中加 underscores_in_headers on;，否则含 _ 的 Header 被直接丢弃
未显式转发自定义头：Nginx 默认不传递非标准头，需用 proxy_set_header 显式声明，例如：proxy_set_header X-User-ID $http_x_user_id;

验证是否命中了正确的 location 块

请求头转发行为只在生效的 location 块内起作用。可用以下方式确认：

在对应 location 中临时加一条日志：access_log /var/log/nginx/debug.log main;，并启用 $http_x_your_header 变量到 log_format 中
用 curl -H "X-Test: 123" http://your-domain/test 测试，并查日志看该 header 是否被记录
若日志里没有 X-Test，说明要么 header 被过滤（underscores_in_headers 未开），要么根本没进这个 location（路径或正则不匹配）