Nginx使用Ingress注解将x-auth-request-email头写入请求参数异常求助

你遇到的问题核心原因是Nginx Ingress默认不会保留非预设的自定义请求头/认证响应头，导致你在configuration-snippet中读取时变量为空，可按照以下步骤排查解决：

情况1：x-auth-request-email为认证服务返回的响应头 #

如果你配置了nginx.ingress.kubernetes.io/auth-url使用外部认证，这个头是认证服务返回的，那么需要添加auth-response-headers注解明确要求Ingress保留该头：

nginx.ingress.kubernetes.io/auth-response-headers: "x-auth-request-email"

添加该注解后，认证阶段返回的头会被存入Nginx上下文，你原来的set $args user=$http_x_auth_request_email&$args;逻辑就能正常读取到值。

情况2：x-auth-request-email为客户端原始请求携带的头 #

如果该头是用户端请求直接带的，需要检查两项配置：

• 检查Ingress控制器启动参数是否添加了--enable-underscores-in-headers=true，该参数默认关闭，会导致部分非标准自定义头被丢弃，开启后可解决自定义头解析问题
• 检查是否配置了全局或Ingress级别的请求头过滤规则，若存在则将x-auth-request-email加入允许传递的白名单

调试验证方法 #

你可以在配置片段中加入调试日志，确认变量实际取值：

nginx.ingress.kubernetes.io/configuration-snippet: |
  error_log /var/log/nginx/ingress_debug.log debug;
  set $args user=$http_x_auth_request_email&$args;

配置生效后进入对应Ingress Pod读取/var/log/nginx/ingress_debug.log即可查看变量实际解析结果，快速定位问题。

内容的提问来源于stack exchange，提问作者user3124206