Nginx读取客户端Header后设置Cookie的代码未执行问题排查

核心误解：指令用途错误 #

你的需求是将请求头中的remote_user作为Cookie发送给上游服务器，但当前代码使用的add_header Set-Cookie是用来给客户端设置Cookie（让浏览器保存该Cookie），并非把Cookie添加到转发给上游的请求中，这是最关键的错误。

正确做法是使用proxy_set_header指令，在转发请求到上游时添加Cookie头：

if ($http_remote_user) {
    proxy_set_header Cookie "UCM_INFO=$http_remote_user; $http_cookie";
}

其中$http_cookie会保留客户端原本发送的Cookie，避免覆盖原有Cookie内容。

其他可能导致代码不执行的原因 #

• add_header的响应码限制：如果你的需求确实是给客户端设置Cookie，add_header默认仅在响应码为200、201、204、206、301、302、303、304、307、308时生效。若上游返回其他状态码（如404、500），该指令不会执行。如需覆盖所有响应码，需添加always参数：

  if ($http_remote_user) {
      add_header Set-Cookie "UCM_INFO=$http_remote_user" always;
  }
  

• if指令的优先级冲突：nginx的if指令在location块中可能与proxy_pass等指令存在执行顺序问题；若location块中已有其他add_header指令，if块内的add_header会覆盖主块配置，也可能导致条件满足时不生效。建议改用map指令提前处理变量，避免滥用if：

  map $http_remote_user $ucm_cookie {
      default "";
      ~.+ "UCM_INFO=$http_remote_user";
  }
  
  server {
      # ...其他配置
      location / {
          if ($ucm_cookie != "") {
              proxy_set_header Cookie "$ucm_cookie; $http_cookie";
          }
          proxy_pass http://your_upstream;
      }
  }
  

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