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

 更新时间:2025年02月20日 08:57:34   作者:Mr-Wanter  
在日常开发和运维中,我们经常会使用 Nginx 作为反向代理服务器,将客户端的请求转发到后端服务,然而,在某些情况下,通过 Nginx 代理后,后端服务可能会丢失部分 HTTP 头部信息,所以本文给大家介绍了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头部丢失内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Nginx服务器中配置GeoIP模块来拦截指定国家IP

    Nginx服务器中配置GeoIP模块来拦截指定国家IP

    Nginx中自带GeoIP模块可以屏蔽指定IP的请求,只不过默认没有被编译,打开以后我们只要再下载一个IP规则就行,Nginx服务器中配置GeoIP模块来拦截指定国家IP
    2016-06-06
  • Nginx+FastDFS搭建图片服务器的方法实现

    Nginx+FastDFS搭建图片服务器的方法实现

    这篇文章主要介绍了Nginx+FastDFS搭建图片服务器的方法实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-03-03
  • Nginx下实现pathinfo及ThinkPHP的URL模式

    Nginx下实现pathinfo及ThinkPHP的URL模式

    本篇文章主要介绍了Nginx下实现pathinfo及ThinkPHP的URL模式。小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-05-05
  • nginx转发内网图片的代码示例

    nginx转发内网图片的代码示例

    这篇文章主要给大家介绍了nginx转发内网图片,文章通过代码示例介绍的非常详细,对大家的学习或工作有一定的帮助,感兴趣的小伙伴可以自己动手试一下
    2023-10-10
  • Nginx出现504 Gateway Time-out的解决方法

    Nginx出现504 Gateway Time-out的解决方法

    nginx访问出现504 Gateway Time-out,一般是由于程序执行时间过长导致响应超时,本文就来介绍一下解决方法,感兴趣的可以了解一下
    2023-10-10
  • 加速nginx性能: 开启gzip和缓存

    加速nginx性能: 开启gzip和缓存

    nginx 是一个高性能的 Web 服务器,之前也写过一些关于 nginx 的文章。为了提高博客的响应速度,可以从设置 nginx 的 gzip 和缓存这2方面入手。为字体开启 gzip 和缓存能大大减少带宽的消耗
    2017-03-03
  • 使用Nginx解决前端跨域问题

    使用Nginx解决前端跨域问题

    这篇文章主要为大家详细介绍了使用Nginx解决前端跨域问题的相关知识,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2024-12-12
  • nginx禁用ip实现方法

    nginx禁用ip实现方法

    Nginx禁特定IP访问的方法包括使用deny指令、组合使用allow和deny指令以及利用HTTP模块的limit_conn和limit_req指令限制连接数和请求频率,这些方法能有效禁止或限制特定IP的访问
    2026-05-05
  • 为什么我推荐Nginx作为后端服务器代理(原因解析)

    为什么我推荐Nginx作为后端服务器代理(原因解析)

    这篇文章主要介绍了为什么我推荐Nginx作为后端服务器代理,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-07-07
  • 深入浅析nginx四种调度算法和进阶

    深入浅析nginx四种调度算法和进阶

    这篇文章主要介绍了深入浅析nginx四种调度算法和进阶,文中给大家提到了upstream 支持4种负载均衡调度算法,需要的朋友可以参考下
    2018-06-06

最新评论