Nginx配置CORS时add_header重复调用致跨域头多值错误排查

这个问题的核心原因是Nginx的add_header指令会在匹配的多个块中追加头信息，而不是覆盖。你的配置里在OPTIONS、POST、GET三个独立的if块里都重复添加了Access-Control-Allow-Origin: *，如果某个请求（比如OPTIONS）触发了多轮规则匹配，或者你的后端服务本身也返回了这个头，就会导致响应头里出现多个相同的*值，触发浏览器的CORS错误。

修复方案一：统一CORS头配置，避免重复添加 #

把通用的CORS头移到location块的最外层，只设置一次；然后针对不同请求方法补充特定的头即可，这样就不会重复添加相同的头信息。修改后的配置如下：

server {
    listen 443;
    server_name myserver.earth;
    ssl on;
    ssl_certificate cert.crt;
    ssl_certificate_key private.key;
    ssl_protocols TLSv1.2;
    ssl_ciphers 'ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:AES:CAMELLIA:DES-CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA';
    ssl_prefer_server_ciphers on;
    ssl_dhparam dhparams.pem;
    client_max_body_size 256M;

    location / {
        proxy_pass http://localhost:9000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;

        # 通用CORS头：所有请求只添加一次
        add_header 'Access-Control-Allow-Origin' '*';
        add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
        add_header 'Access-Control-Allow-Headers' 'DNT,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,Range,Authorization';

        # 处理OPTIONS预请求，补充专属头
        if ($request_method = 'OPTIONS') {
            add_header 'Access-Control-Max-Age' 1728000;
            add_header 'Content-Type' 'text/plain; charset=utf-8';
            add_header 'Content-Length' 0;
            return 204;
        }

        # 为GET/POST请求添加额外需要暴露的头
        if ($request_method ~* "(GET|POST)") {
            add_header 'Access-Control-Expose-Headers' 'Content-Length,Content-Range';
        }
    }
}

修复方案二：处理后端返回重复头的情况 #

如果你的后端服务（localhost:9000）本身也配置了CORS并返回Access-Control-Allow-Origin头，那么需要在proxy_pass指令后添加proxy_hide_header来隐藏后端的这个头，确保只有Nginx添加的头生效：

proxy_pass http://localhost:9000;
proxy_hide_header Access-Control-Allow-Origin; # 隐藏后端返回的CORS源头

额外提示 #

• Nginx的add_header指令默认只在响应码为200、201、204、206、301、302、303、304、307、308时生效，如果需要在所有响应码下都添加头，可以加上always参数，比如：add_header 'Access-Control-Allow-Origin' '*' always;
• 尽量避免在Nginx中使用过多的if块，复杂的if逻辑可能会导致意外的匹配行为，简单场景下用上述统一配置的方式更稳妥。

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