如何将后端自定义Header添加到Nginx X-Accel-Redirect跳转的S3响应中

你的实现思路是正确的，配置不生效主要有三个核心问题：

• rewrite指令缺少last参数，导致内部重定向未终止当前location的处理流程，自定义变量赋值逻辑未按预期执行
• add_header指令默认仅对200、201、204、206、301、302、303、304、307、308状态码生效，缺少always参数时，其他状态码的响应不会携带目标头，部分场景下正常响应也可能出现添加失效的问题
• 额外冗余配置proxy_pass_header X-Accel-Redirect属于不必要配置，Nginx原生支持X-Accel-Redirect头的处理，不需要额外声明

upstream platform {
    server localhost:8000;
}

server {
    error_log /dev/stderr;
    access_log /dev/stdout;
    listen 80;

    # 接收后端X-Accel-Redirect跳转的入口location，负责存储后端返回的自定义头
    location ^~ /document_store/ {
        internal;
        # 此时上游还是后端服务，可正常读取X-Foo头存入自定义变量
        set $custom_header_value $upstream_http_x_foo;
        # 加last参数，重定向后直接匹配新的location，终止当前location的处理
        rewrite ^/(.+) /redirect_$1 last;
    }

    # 实际代理S3资源的location
    location ~ ^/redirect_document_store/(.*?)/(.*?)/(.*) {
        internal;
        resolver 8.8.8.8 ipv6=off;
        set $download_protocol $1;
        set $download_host $2;
        set $download_path $3;
        set $download_url $download_protocol://$download_host/$download_path;
        
        proxy_hide_header Content-Disposition;
        proxy_hide_header Access-Control-Allow-Origin;
        # 所有add_header指令添加always参数，强制所有状态码都返回对应头
        add_header Content-Disposition $upstream_http_content_disposition always;
        add_header Access-Control-Allow-Origin * always;
        # 写入之前存储的自定义头
        add_header X-Foo $custom_header_value always;
        
        proxy_max_temp_file_size 0;
        proxy_pass $download_url$is_args$args;
    }

    location / {
        proxy_pass http://platform;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $host;
        proxy_redirect off;
    }
}

如果修改配置后仍然未返回X-Foo头，可通过打印日志确认变量取值：

1. 新增自定义日志格式，打印自定义变量的值

log_format debug 'custom_x_foo: "$custom_header_value", request_uri: "$request_uri", status: $status';
access_log /dev/stdout debug;

2. 发起请求后查看日志，若$custom_header_value为空，确认后端返回的头名称是否为标准的X-Foo格式，无拼写错误、无额外下划线或其他符号。Nginx的$upstream_http_*变量会自动将头名转为小写，横杠转为下划线，X-Foo对应变量名$upstream_http_x_foo是正确的。

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