Linux Nginx 后端服务收不到 Authorization 请求头怎么解决

胖明小哥_8169

胖明小哥_8169

2026-10-02

864人浏览

原创

后端收不到 authorization 头,主因是 nginx 默认不透传且配置存在变量名错误、覆盖指令或命名不规范;须显式配置 proxy_set_header authorization $http_authorization;,确保变量名准确、无重置语句,并开启 underscores_in_headers on 以支持下划线头。

linux nginx 后端服务收不到 authorization 请求头怎么解决

后端收不到 Authorization 头,绝大多数情况是 Nginx 默认不透传该头,且配置中存在变量名错误、覆盖指令或命名规范问题。解决核心就三点:显式透传、正确取值、避免丢弃。

必须显式配置 proxy_set_header Authorization $http_authorization

Nginx 默认剥离 Authorization 请求头,无论是否启用 proxy_pass,都不自动转发。必须在 location 或 server 块中添加:

  • proxy_set_header Authorization $http_authorization; —— 变量名严格为 $http_authorization(全小写,带下划线),不能写成 $http_Authorization、$http_auth 或 $sent_http_authorization
  • 检查是否有其他配置覆盖了它,例如某些模板或发行版默认含 proxy_set_header Authorization "";,会清空该头
  • 若上游(如 CDN、API 网关)已注入 Authorization,仍建议保留此行,确保沿用原始值

注意自定义认证头含下划线时需开启 underscores_in_headers

如果前端实际发的是 X-Auth-Token、auth_token 或 api_key 这类带下划线的头,Nginx 默认直接丢弃,后端根本收不到:

Alpine Linux
Alpine Linux

获取最新发布版本;聚合最新版本架构

下载
  • 在 http 或 server 块中启用:underscores_in_headers on;
  • 之后才能通过 $http_x_auth_token、$http_auth_token 等变量提取
  • 再用 proxy_set_header X-Auth-Token $http_x_auth_token; 透传给后端
  • 更推荐将头改为短横线命名(如 X-Auth-Token),兼容性更好

验证是否生效:从 Nginx 日志和后端日志双向确认

光配不等于通,必须验证请求头是否真正到达后端:

  • 在 Nginx 配置中临时加日志:log_format debug '$remote_addr - $request_uri $http_authorization $http_x_auth_token';,再查 access.log 确认变量有值
  • 后端服务打印原始请求头(如 Node.js 的 req.headers.authorization,Spring Boot 的 request.getHeader("Authorization"))
  • 用 curl 模拟请求:curl -H "Authorization: Bearer abc123" http://your-api.com/test,观察后端输出
  • 若后端收到空值但 Nginx 日志里有值,说明 proxy_set_header 生效;若 Nginx 日志也为空,说明客户端根本没发,或被浏览器/CDN 拦截

补充常见干扰场景

有些问题看似是 Nginx 配置问题,实则来自链路其他环节:

  • 浏览器跨域预检(OPTIONS)不带 Authorization,仅实际请求才携带,后端不要在 OPTIONS 响应里依赖该头做鉴权
  • Kubernetes Ingress-NGINX 默认在外部认证后 主动 unset Authorization,需用 nginx.ingress.kubernetes.io/auth-response-headers: "Authorization" 注解恢复
  • 若 Token 实际存在 Cookie 或 URL 参数中,需改用 proxy_set_header Authorization "Bearer $cookie_token"; 或配合 map 指令做多源 fallback

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

linux nginx

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2243

5

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

5930

13

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

5246

10

nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

383

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3207

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

5865

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

561

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1476

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

3938

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习