如何在Nginx中为上游响应设置默认头部（含5xx错误场景）

我需要确保上游服务无论是否可用（包括返回5xx错误时），都能给客户端返回至少默认的Access-Control-Allow-Origin头部。之前尝试了几种Nginx配置，但都存在问题：

尝试过的配置 #

server {
  ...
  #add_header "Access-Control-Allow-Origin" "*"; №0
  #add_header "Access-Control-Allow-Origin" "*" always; №1
  #more_set_headers "Access-Control-Allow-Origin: *"; №2
  #more_set_headers -s '403 500 502 504 503' "Access-Control-Allow-Origin: *"; №3

  location /upstream {
    proxy_pass http://localhost:1234;
  }
  ...
}

各配置的问题 #

• №0：正常请求会重复头部，且5xx错误时不返回该头部
• №1：正常请求会重复头部
• №2：直接覆盖上游返回的头部值
• №3：上游返回正常状态码但未携带该头部时，不会添加默认头部

正确配置方案 #

通过map指令判断上游是否返回了目标头部，结合add_header always实现需求，具体配置如下：

1. 在http块中添加map定义：

http {
  ...
  # 根据上游返回的CORS头部设置变量，无则用默认值*
  map $sent_http_access_control_allow_origin $cors_default {
    default "*";
    ~.+ $sent_http_access_control_allow_origin;
  }
  ...
}

2. 在你的server或location块中添加：

server {
  ...
  # 始终返回CORS头部，值取map定义的变量
  add_header Access-Control-Allow-Origin $cors_default always;

  location /upstream {
    proxy_pass http://localhost:1234;
  }
  ...
}

方案说明 #

• 避免重复/覆盖：map会优先读取上游返回的Access-Control-Allow-Origin值，只有当上游未返回时才使用默认的*，确保不会重复或覆盖上游的合法值
• 覆盖5xx场景：always参数确保即使Nginx返回5xx错误（上游不可用），该头部也会被发送给客户端
• 兼容正常无头部场景：上游返回200等正常状态但未携带CORS头部时，自动添加默认的*

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