Nginx add_header指令配置后未正常生效的问题排查

Nginx的add_header指令生效逻辑和location匹配规则共同导致了这个问题：

• 你配置的try_files $uri $uri/ /index.html规则在访问/start/629852d359d2a400034698a2这类不存在真实对应文件的路径时，会触发内部重定向到/index.html，请求会重新匹配location块，最终命中location /的规则。
• add_header的继承规则是：只有当前匹配的location块内没有定义任何add_header指令时，才会继承上层（server块、http块）的头配置。你在location ^~ /start/里定义的头，不会自动带到内部重定向后命中的location /块中，而location /块里没有配置这两个跨域头，最终响应自然不会返回对应头。
• 额外排查点：你贴出的配置只监听了80端口（HTTP协议默认端口），但实际访问的是https://开头的HTTPS链接，如果这部分头配置没有同步写到监听443端口的HTTPS server块中，也会出现头不生效的问题。

根据你的需求选择对应方案即可：

• 方案1：全局生效（推荐，适合/start路径和根路径都需要跨域头的场景）
  把跨域头配置提升到server块层级，统一给所有响应加头，同时给add_header加上always参数，保证所有响应码场景下头都能正常返回。配置示例：

server {
    listen 80;
    # HTTPS服务需在监听443的server块中同步添加以下头配置
    root /usr/share/nginx/html;
    index index.html index.htm;

    # 全局添加跨域头，加always保证4xx/5xx等异常响应也返回头
    add_header 'Cross-Origin-Embedder-Policy' 'require-corp' always;
    add_header 'Cross-Origin-Opener-Policy' 'same-origin' always;

    location ^~ /start/ {
        try_files $uri $uri/ /index.html;
    }

    location / {
        try_files $uri $uri/ /index.html;
    }
}

• 方案2：仅/start路径生效（适合只有/start路径下需要跨域头的场景）
  用命名location处理/start路径的回退逻辑，避免内部重定向到根location，同时在回退的location中补全头配置：

server {
    listen 80;
    root /usr/share/nginx/html;
    index index.html index.htm;

    location ^~ /start/ {
        add_header 'Cross-Origin-Embedder-Policy' 'require-corp' always;
        add_header 'Cross-Origin-Opener-Policy' 'same-origin' always;
        try_files $uri $uri/ @start_fallback;
    }

    # 专门处理/start路径的回退
    location @start_fallback {
        add_header 'Cross-Origin-Embedder-Policy' 'require-corp' always;
        add_header 'Cross-Origin-Opener-Policy' 'same-origin' always;
        rewrite ^ /index.html break;
    }

    location / {
        try_files $uri $uri/ /index.html;
    }
}

配置修改完成后，先执行nginx -t检查配置语法是否正确，确认无误后执行nginx -s reload重载Nginx配置，再清除浏览器缓存访问对应路径即可看到响应头。

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