如何获取Nginx上游返回的所有Set-Cookie内容并完整传递给客户端

问题根因 #

Nginx 标准的 $upstream_http_* 系列变量对于上游返回的多个同名响应头，默认只会取第一个头的值，后续的同名头会被自动忽略。同时标准 add_header 指令不支持单次传入多个值生成多个同名头，这两个原因共同导致了你只有第一个cookie能透传成功。

解决方案1：使用headers-more-nginx-module（通用原生Nginx场景） #

这是最常用的稳定方案，无需硬编码任何cookie名称，仅需要编译Nginx时引入headers-more-nginx-module第三方模块（多数云服务商、发行版的Nginx预装包已经默认集成了该模块）：

location /auth/ {
    proxy_pass         http://auth/;
    proxy_pass_request_body off;
    proxy_redirect     off;
}

location / {
    auth_request       /auth/loggedin;
    # 抓取auth请求返回的所有Set-Cookie值
    auth_request_set $all_auth_cookies $upstream_http_set_cookie;
    # 为每个cookie单独生成Set-Cookie头返回给客户端
    more_set_headers -s 200 'Set-Cookie: $all_auth_cookies';
    # 拼接Cookie头传递给下游业务服务
    proxy_set_header Cookie "$http_cookie; $all_auth_cookies";
    proxy_pass         http://someservice/;
}

解决方案2：OpenResty环境Lua实现（无需额外模块） #

如果你使用的是OpenResty，可以直接通过Lua API读取所有Set-Cookie头，灵活度更高：

location /auth/ {
    proxy_pass         http://auth/;
    proxy_pass_request_body off;
    proxy_redirect     off;
    header_filter_by_lua_block {
        -- 读取auth服务返回的所有Set-Cookie头存入上下文
        local cookies = ngx.resp.get_headers()["Set-Cookie"]
        ngx.ctx.auth_cookies = type(cookies) == "table" and cookies or {cookies}
    }
}

location / {
    auth_request       /auth/loggedin;
    auth_request_set $auth_cookie_str $upstream_http_set_cookie;
    header_filter_by_lua_block {
        -- 把所有auth返回的Cookie追加到响应头返回给客户端
        if ngx.ctx.auth_cookies then
            for _, ck in ipairs(ngx.ctx.auth_cookies) do
                table.insert(ngx.header["Set-Cookie"], ck)
            end
        end
    }
    proxy_set_header Cookie "$http_cookie; $auth_cookie_str";
    proxy_pass         http://someservice/;
}

无模块兼容方案 #

如果既无法加装模块也无法使用OpenResty，可以修改auth服务的逻辑：将所有Set-Cookie内容用不会出现在cookie值中的特殊分隔符（如|||）拼接为单个自定义响应头返回，Nginx读取后拆分多次调用add_header即可。该方案需要你确认auth服务最多返回的Cookie数量，提前配置对应数量的add_header规则。

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