nginx有时无法转发自定义header头内容的问题

使用nginx做负载均衡或http代理时，碰到http header不转发的问题。

 

配置里只有转发设置原始ip和host的

proxy_set_header Host $host; 
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header     X-Forwarded-Server $host;

但我自定义的header却都忽略掉了。百思不得其解：

1、理论上转发header是基本功能啊，apache都没问题
2、网上也搜不到此类问题说明
3、可能大家都不用客户端自定义提交header？

 

打开nginx的debug：
 
配置中：
daemon off;
error_log logs/error.log debug;
 
看error_log
发现解析header时出现：
 
client sent invalid header line: “wiz_api_version: 2″ while reading client request headers, client: 223.254.100.103, server: localhost, request: “POST /wizkm/a/upload HTTP/1.1″
 
明显是忽略掉了我自定义的header。
 
差点绝望。还好开源软件可以看源码。
 
找出个所以然，果然被我找到问题了：
rc = ngx_http_parse_header_line(r, r->header_in, cscf->underscores_in_headers);
 if (r->invalid_header && cscf->ignore_invalid_headers)
 
在ngx_http_parse_header_line() 函数中
if (ch == ‘_’) {
                if (allow_underscores)

 

Unknown macro: {                    hash = ngx_hash(hash, ch);                    r->lowcase_header[i++] = ch;                    i &= (NGX_HTTP_LC_HEADER_LEN -- 1);\                 }

 

else

 

Unknown macro: {                    r->invalid_header = 1;                }

 
红色部分就是问题所在了
原来是对header name的字符做了限制，默认 underscores_in_headers 为off，表示如果header name中包含下划线，则忽略掉。
 
恰好我自定义的header中都是用的下划线。
 
处理办法：
 
1：配置中http部分 增加underscores_in_headers on; 配置
2：用减号-替代下划线符号_，避免这种变态问题。nginx默认忽略掉下划线可能有些原因。