nginx做转发时，带‘_‘的header内容被丢失

最新推荐文章于 2025-02-18 11:26:47 发布
最新推荐文章于 2025-02-18 11:26:47 发布
阅读量383 收藏
点赞数
CC 4.0 BY-SA版权
分类专栏： webapp开发
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/baifucn/article/details/109022364
本文介绍了解决Nginx代理转发时丢失特定Header的问题，包括两种解决方案：一是避免使用下划线，二是修改Nginx配置以支持含有下划线的Header。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

今天在线上切换系统时，发现后端微服务报错，说xx header的数值为空，也就是没有传。查看browser信息，发现前端页面系统发出时是带了这个header (user_id)的。也是就header user_id达到后端微服务时没有了。

那么代码没有改动，怎么平白无故会丢失头信息？ 

于是想到两个环境的不同之处在于线上是通过nginx做的代理转发，会不会是nginx搞的鬼？于是搜索“nginx request header 丢失”，果不其然是这个问题，nginx对下划线的头信息做了限制，找到问题所在就等于完成了一大半，办法总比困难多。遂决定记录之。 

 

- 方法一：不用下划线 

既然nginx对下划线不支持，那没关系，不用下划线就是了。比如原来”app_version”改成”app-version”就可以了。（难怪一般header的name都是’-‘来拼接的，比如”User-Agent”） 

 

-  方法二：从根本解除nginx的限制  
nginx默认request的header的那么中包含’_’时，会自动忽略掉。 
解决方法是：在nginx里的 nginx.conf 配置文件中的http部分中添加如下配置： 
underscores_in_headers on; （默认 underscores_in_headers 为off）

【nginx】ngx_http_proxy_connect_module 正向代理
突围
09-14 1035
nginx 正向代理
记一次由gzip引起的nginx转发事故
极客中年的博客
03-28 1370
一个gzip引发的案件，原因是因为过waf的时候，waf会自动引入gzip压缩处理，导致前置应用没有处理，解决此问题的方案有2。
nginx做转发时，带’_’的header内容丢失
chuminghan0476的博客
04-28 453
原本在测试环境测试通过的APP，今天准备切到线上环境做最后测试，结果发现了错误。查看日志发现是APP端发送的http请求中的header内容丢失了。那么代码没有改动，怎么平白无故会丢失头信息？ 于是想到两个环境的不同之处在于：线上是通过nginx做的代理转发，会不会是nginx搞的鬼？于是搜索...
nginx配置携带header转发
samHuangLiang的博客
12-11 4103
underscores_in_headers on;开启header转发 http { include mime.types; default_type application/octet-stream; sendfile on; keepalive_timeout 65; underscores_in_headers on; #gzip on; gzip on; gzip_...
nginx代理转发导致header带下划线参数名丢失
GuessBUG的博客
04-27 1052
nginx代理转发导致header参数丢失问题描述原因猜想问题解决萌新发言，不喜勿喷，欢迎大佬们指出不当之处 问题描述 使用nginx代理转发A项目的时候，调用nginx，发现A项目报错，header中参数丢失（过滤器拦截，有提示缺失的参数） 原因猜想 因为其他项目也是走的nginx代理转发，header中的参数并没有丢失的情况，然后对比下A项目和其他正常的项目的参数，发现A项目丢失的参数都是带有...
nginx转发携带请求头，headers内容丢失解决办法
泉眼和溪流的关系，大概是泉眼会被溪流一点一滴的占据
11-12 4357
nginx转发headers内容丢失解决办法
不积跬步无以至千里
08-18 3331
问题原因： 在实际开发中请求头中有时候需要携带自己定义的一些参数，但是在命名参数时需要格外注意； nginx不会识别_ (下划线)这个符号，默认情况不识别下划线，所以会忽略这个参数数 解决方案 一、修改nginx配置 在nginx 的 http部分添加如下配置： underscores_in_headers on; （默认 underscores_in_headers 为off） 二、修改命名方式 例如： user_token修改为user-token或userToken 参考文档: https:/
nginx 反向代理proxy_set_header
weixin_64157795的博客
02-18 518
proxy_add_x_forwarded_for变量包含$http_x_forwarded_for与$remote_addr两部分，他们之间用逗号分开。4）$proxy_add_x_forwarded_for：获取的是前一节点的X-Forwarded-For的值。3）$http_x_real_ip：获取的是前一节点的X-Real-IP的值。2）$remote_addr：前一节点的IP，并不一定是用户的真实IP。$remote_addr是前一节点的IP，并不一定是用户的真实IP。
Nginx代理时header头中带”_”信息丢失问题的解决
01-10
开发网关项目时，在请求时往请求头header中放入了签名sign_key信息，在接收请求时再从header中拿出，在本地调试时是可以的，但上线之后通过Nginx代理之后发现拿不到。 location / { proxy_set_header X-Real-IP $...
Nginx session丢失问题处理解决方法
09-29
例如，通过`proxy_cookie_path`指令可以指定在Nginx转发请求时保留Cookie的路径。如下所示： ```nginx proxy_cookie_path /jhyx/ /; ``` 4. proxy_set_header指令：Nginx通过`proxy_set_header`指令可以设置转发给...
nginx转发请求header中的参数丢失问题
fang0604631023的博客
06-07 1909
nginx转发请求header中的参数丢失问题
nginx转发http请求时，headers内容丢失解决办法
青颜的天空的博客
05-22 2127
以上示例中，underscores_in_headers 指令被配置在 http 块中，保证了全局的下划线参数保留。以上示例中，Nginx会保留名为 “X-MyHeader” 的请求头参数，并将它的值设置为原请求头中名为 “x-my-header” 的参数的值。开发项目时，在请求时往请求头header中放入了索引 index_prefix 信息，供后端使用，但是后端总是查询不到headers中有此字段。需要在http配置里添加这个参数配置为on。nginx代理默认会把header中参数的 "
Nginx 请求headers被过滤
weixin_54345563的博客
10-25 2546
Nginx 请求headers被过滤
Nginx proxy_set_header配置
静坐听雨
04-01 4839
nginx head 配置
nginx转发报错问题/nginx转发丢失header头部信息
iBuDongIt的博客
07-16 1944
nginx转发报错问题/nginx转发丢失header头部信息 场景是 我用nginx监听80端口 然后把域名转发到8080端口 www.yuming.com > 80 > 8080 我用域名访问的时候后台会报错说我没有登录(我后台用的是shiro) , 但是我直接用ip访问就没有问题,本地也没有问题,意识到可能是nginx转发的问题,网上查找资料得知 nginx转发时头部信息中如果有下划线会默认过滤掉,所以导致我的access_token被过滤了后台才会出现未登录情况 解决办法 在nginx
nginx转发导致请求头header失效问题
weixin_39303215的博客
08-15 1961
遇到请求头失效问题的排查
nginx的代理head参数丢失问题
m0_51527921的博客
11-28 3385
http请求中除了一些公共header，我们还可以定义一些其他header：如token、移动端的唯一设备id、一些自己业务的基础属性如用户id、城市id等等。客户端通过head传递有下划线的参数，使用nginx做代理转发，nginx服务器默认会对http请求中带下划线的header做过滤丢失不会透传。1.个人比较推荐这种方式。常见的header变量都是遵循这种方式，例如：Content-Type,Content-Length,Accept-Ranges等。2.在nginx里的nginx.conf配置文件中
Nginx反向代理，header参数带下换线(_),导致接口调用不通，丢失header丢失的问题
一颗浑身披带雪花的松树---[雪松]
08-27 2992
求接口Header参数带下划线，Nginx反向代理后参数丢失
nginx 转发 head信息丢失
最新发布
02-22
<think>嗯，用户问的是关于Nginx转发时头部信息丢失的问题。首先，我需要回忆一下Nginx的配置中与代理相关的指令，特别是处理HTTP头部的部分。可能用户在使用Nginx作为反向代理的时候，发现后端服务器没有收到预期的请求头，比如自定义的Header或者一些重要的标准头信息，比如Host头。 首先，常见的原因可能包括Nginx默认不会转发所有客户端发送的头部，特别是下划线开头的头部，因为默认配置中underscores_in_headers被设置为off，这可能导致Nginx丢弃那些带有下划线的头。这时候需要检查Nginx的配置，是否有显式设置underscores_in_headers on。 另外，用户可能在配置proxy_pass的时候没有正确设置需要转发的头信息。例如，使用proxy_set_header指令来手动设置需要传递的头部。例如，Host头通常需要显式设置为$host变量，否则可能会被替换成后端服务器的地址，而不是客户端的原始Host头。 还有可能用户没有将客户端发送的头信息显式地传递给后端。比如，如果需要传递自定义的X-Forwarded-For或者Authorization头，必须确保这些头被包含在proxy_set_header的配置中。此外，有时候用户可能没有意识到某些头是Nginx默认不转发的，比如Connection和Upgrade头在WebSocket代理时需要特别处理。 另外，Nginx的版本也可能影响头部的转发行为，旧版本可能有不同的默认配置，需要确认是否是因为版本问题导致的。此外，检查是否有其他中间件或者防火墙修改了请求头，或者后端服务器自身是否有过滤或限制某些头的情况。 用户可能遇到的问题场景包括：开发API时，前端发送的Authorization头在到达后端时丢失，导致认证失败；或者在使用WebSocket时，Upgrade头没有正确转发，导致连接无法建立。这时候需要逐步排查，首先确认客户端的请求头是否确实发送正确，然后检查Nginx的访问日志和错误日志，看看是否有相关头的记录，再通过配置调整确保这些头被正确转发。 可能的解决方案包括：在Nginx的配置文件中，使用proxy_set_header指令显式设置需要转发的头，例如： location / { proxy_pass http://backend; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; # 其他自定义头 proxy_set_header Authorization $http_authorization; proxy_pass_request_headers on; } 同时，确保underscores_in_headers设置为on，以允许带下划线的头： http { underscores_in_headers on; ... } 另外，检查是否有使用proxy_hide_header指令意外隐藏了某些头，或者后端服务器是否有对某些头的限制。例如，某些安全策略可能会过滤掉未知的头部。 最后，建议用户使用工具如curl或浏览器的开发者工具，检查请求头是否确实发送，再通过Nginx的日志查看转发的头是否正确，逐步定位问题所在。</think>在使用 Nginx 作为反向代理时，**请求头（Header）信息丢失**是一个常见问题，通常由配置不当或 Nginx 默认行为导致。以下是原因分析及解决方案： --- ### **常见原因** 1. **默认转发规则限制** - Nginx **默认仅转发标准请求头**（如 `Host`, `User-Agent`），**非标准或自定义头**（如 `X-API-Key`）需显式配置才能传递。 - 若请求头名称包含**下划线**（如 `X_Custom_Header`），Nginx 默认会丢弃（需调整配置允许下划线）。 2. **配置缺失或覆盖** - 使用 `proxy_set_header` 指令时，若未显式保留原始头信息，可能覆盖或丢失已有头。 - 未启用 `proxy_pass_request_headers on;`（默认开启，但需确保未被关闭）。 3. **HTTP 协议版本问题** - 后端服务若使用 HTTP/2 或 WebSocket，需额外配置相关头（如 `Upgrade`, `Connection`）。 --- ### **解决方案** #### 1. **显式转发自定义头** 在 Nginx 配置的 `location` 块中，使用 `proxy_set_header` 指定需转发的头信息： ```nginx location / { proxy_pass http://backend_server; # 转发标准头 proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; # 转发自定义头（例如 Authorization） proxy_set_header Authorization $http_authorization; # 允许转发带下划线的头 underscores_in_headers on; } ``` #### 2. **保留所有原始头信息** 若需转发所有客户端请求头，可添加： ```nginx proxy_pass_request_headers on; # 默认开启，确保未被关闭 ``` #### 3. **处理带下划线的头名称** 在 `http` 或 `server` 块中启用下划线支持： ```nginx http { underscores_in_headers on; # 允许转发含下划线的头 ... } ``` #### 4. **特殊协议头配置（如 WebSocket）** 代理 WebSocket 时需额外配置： ```nginx location /websocket/ { proxy_pass http://backend_ws; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; } ``` --- ### **验证与调试** 1. **检查请求头是否发送** 使用 `curl -v` 或浏览器开发者工具，确认客户端实际发送的请求头： ```bash curl -v -H "X-Custom-Header: test" http://your-nginx-server ``` 2. **查看 Nginx 日志** 在 Nginx 配置中记录请求头，添加如下配置： ```nginx log_format custom_log '$remote_addr - $http_x_custom_header'; access_log /var/log/nginx/access.log custom_log; ``` 3. **后端服务日志** 检查后端服务接收到的请求头，确认是否包含预期内容。 --- ### **常见误区** - 误认为 `proxy_set_header` 是“追加”头，实际是覆盖（若需追加需手动拼接变量，如 `$http_x_custom_header`）。 - 忽略 HTTP 协议版本兼容性（如 HTTP/1.1 与 HTTP/2 的头处理差异）。 通过以上配置调整，可有效解决 Nginx 转发过程中请求头丢失的问题。若仍存在异常，建议逐步简化配置并对比测试，定位具体冲突点。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值