解决nginx无法获取带下划线的header值

问题描述:因为项目用到了xxl,需要header为xxl_sso_sessionid的值，本地没有问题，放到服务器上，nginx却无法获取到。

NGINX 默认会将所有包含连字符（-）的请求头转换为下划线（_）格式。这是为了符合一些系统的命名规则，因为环境变量通常不允许连字符。

要在 NGINX 中直接使用包含连字符的请求头，需要进行一些特殊配置。可以使用 underscores_in_headers 指令来禁用这种行为，从而保留原始的连字符格式。

解决1. 启用 underscores_in_headers

首先，确保在 HTTP 块中启用 underscores_in_headers 指令：

http {
    underscores_in_headers on;

    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent" "$http_host" "$http_xxl_sso_sessionid" ';

    access_log /var/log/nginx/access.log main;

    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;
    keepalive_timeout 65;
    types_hash_max_size 2048;

    include /etc/nginx/mime.types;
    default_type application/octet-stream;

    include /etc/nginx/conf.d/*.conf;
}

axios.interceptors.request.use(function (config) {
    // 在发送请求之前做些什么
    let token = localStorage.getItem("token");
    if (token != null && token != 'null') {
        config.headers["Xxl_sso_sessionid"] = token;
    }
    return config;
}, function (error) {
    // 对请求错误做些什么
    return Promise.reject(error);
});

这样的话，如果前端这样配置，后端可以直接获取到header的值。

解决2

前端配置如下,nginx会自动转换成下划线,也就是xxl_sso_sessionid,就不需要开启underscores_in_headers on

axios.interceptors.request.use(function (config) {
    // 在发送请求之前做些什么
    let token = localStorage.getItem("token");
    if (token != null && token != 'null') {
        config.headers["Xxl-sso-sessionid"] = token;
    }
    return config;
}, function (error) {
    // 对请求错误做些什么
    return Promise.reject(error);
});

nginx配置

http {

    log_format main '$remote_addr - $remote_user [$time_local] "$request" '
                    '$status $body_bytes_sent "$http_referer" '
                    '"$http_user_agent" "$http_host" "$http_xxl_sso_sessionid" ';

    access_log /var/log/nginx/access.log main;

    sendfile on;
    tcp_nopush on;
    tcp_nodelay on;
    keepalive_timeout 65;
    types_hash_max_size 2048;

    include /etc/nginx/mime.types;
    default_type application/octet-stream;

    include /etc/nginx/conf.d/*.conf;

    upstream takeout-back-api {
        server localhost:10086 weight=1;
    }

    upstream order-back-api {
        server 8.141.87.136:10000 weight=1;
    }

    server {
        listen 443 ssl;
        server_name www.domain.com;
        ssl_certificate xxx.cn_bundle.crt;
        ssl_certificate_key xxx.cn.key;
        ssl_session_timeout 5m;
        ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
        ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
        ssl_prefer_server_ciphers on;

        location / {
            root /usr/share/nginx/order-ui/dist;
            index index.html index.htm;
            try_files $uri $uri/ /index.html;
        }

        location /member {
            proxy_pass http://takeout-back-api;
        }

        location /order {
            proxy_set_header xxl_sso_sessionid $http_xxl_sso_sessionid;
            proxy_pass http://order-back-api;
        }
    }
}