Nginx代理后HTTP头部丢失问题的解决方案

前言

在日常开发和运维中，我们经常会使用 nginx 作为反向代理服务器，将客户端的请求转发到后端服务。然而，在某些情况下，通过 nginx 代理后，后端服务可能会丢失部分 http 头部信息，尤其是包含下划线（_）的头部，例如 access_token。本文将详细介绍如何解决这一问题。

一、问题描述

今天遇到一个典型的问题：通过 nginx 代理访问后端服务时，后端服务报错：

该接口的认证类型为授权码认证类型，请在请求头中添加 access_token 参数

直接访问后端服务的地址可以正常返回数据，但通过 nginx 代理后却报错。经过排查，发现是 access_token 头部在代理过程中丢失了。

二、问题原因

nginx 默认会忽略包含下划线（_）的 http 头部。这是因为下划线在 http 头部中是非标准的字符，可能会导致某些服务器或客户端无法正确处理。因此，nginx 默认会丢弃这些头部。

三、解决方案

3.1 启用 underscores_in_headers

为了让 nginx 能够传递包含下划线的头部，需要在 nginx 配置中启用 underscores_in_headers 指令。需要注意的是，这个指令必须放在 http 块或 server 块中，而不能放在 location 块中。

修改 nginx 配置文件（通常是 /etc/nginx/nginx.conf 或 /etc/nginx/conf.d/default.conf）：

http {
    # 允许传递包含下划线的头部
    underscores_in_headers on;

    server {
        listen 80;
        server_name your_domain.com;

        location /proxy-data/ {
            proxy_pass http://172.17.17.17:18081;
            proxy_pass_request_headers on;

            # 可选：转发特定的 header
            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;
        }
    }
}

3.2 重新加载 nginx 配置

修改配置文件后，测试配置文件是否正确，并重新加载 nginx：

./nginx -t          # 测试配置文件是否正确
./nginx -s reload   # 重新加载 nginx

总结

通过启用 underscores_in_headers 指令，可以解决 nginx 代理后 http 头部丢失的问题。

具体步骤如下：

• 在 http 块或 server 块中添加 underscores_in_headers on
• 重新加载 nginx 配置
• 验证配置是否生效

到此这篇关于nginx代理后http头部丢失问题的解决方案的文章就介绍到这了,更多相关nginx代理后http头部丢失内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！