Nginx配置疑难：不同路径配置自定义响应头且统一回退指定文件，同时避免全局头重复添加

看到你的配置问题了，核心痛点其实是rewrite指令导致请求跳转到根location，丢失了原location设置的自定义header，再加上Nginx的add_header继承规则（子location有add_header就不会继承server块的），才出现了现在的问题。下面给你一套重构后的解决方案，既能满足不同路径自定义header、全局header不重复，又能保证所有请求回退到index.html。

一、先重构全局头配置，避免重复代码 #

先把所有全局通用的header单独抽成一个配置文件，比如${INCLUDE_DIR}/global_headers.conf，内容如下：

# 全局通用响应头
add_header X-FRAME-OPTIONS "DENY" always;
add_header Cache-Control "no-store, must-revalidate" always;
add_header Report-To "<global-config>" always;
add_header Content-Security-Policy "<global-config>" always;

这样后面所有需要用全局头的地方，直接include这个文件就行，不用重复写一堆代码。

二、修正主server块配置 #

把原来的server块调整成这样，核心是把根location作为默认处理，同时引入特定路径的配置：

server {
    listen   ${PORT};

    # 禁止重定向时包含本地服务器地址
    absolute_redirect off;

    index    index.html;
    root ${HTML_SRC};

    # 根路径：处理所有未匹配到特定规则的请求，应用全局头+回退逻辑
    location / {
        include  ${INCLUDE_DIR}/global_headers.conf;
        # 优先找文件/目录，找不到就返回index.html
        try_files     $uri $uri/ /index.html;
    }

    # 引入所有路径特定的配置（把原来headers.conf里的location规则移到这里，或者单独存成location_specific.conf）
    include  ${INCLUDE_DIR}/location_specific.conf;
}

三、修复各特定路径的配置（关键！去掉rewrite） #

把原来的路径规则全部修改，删掉所有rewrite .* / last;，改用try_files直接在当前location处理，这样自定义header就不会丢失了。下面是各个路径的配置示例，存到${INCLUDE_DIR}/location_specific.conf里：

1. 处理.well-known文件 #

location = /.well-known/apple-app-site-association$ {
    default_type    application/json;
    include ${INCLUDE_DIR}/global_headers.conf;
    # 先找目标文件，找不到回退到index.html
    try_files $uri /index.html;
}

2. 静态资源缓存配置 #

location ~* \.(jpg|jpeg|gif|png|svg|ttf)$ {
    include ${INCLUDE_DIR}/global_headers.conf;
    # 覆盖全局的Cache-Control，设置长缓存
    add_header Cache-Control "max-age=31557600" always;
    try_files $uri /index.html;
}

3. /login路径自定义header #

location = /login {
    include ${INCLUDE_DIR}/global_headers.conf;
    # 覆盖全局的Report-To和CSP规则
    add_header Report-To "<specific-config>" always;
    add_header Content-Security-Policy "<specific-config>" always;
    try_files $uri /index.html;
}

4. /some-other-path前缀路径配置 #

location /some-other-path {
    include ${INCLUDE_DIR}/global_headers.conf;
    # 覆盖全局的Report-To和CSP规则
    add_header Report-To "<other-specific-config>" always;
    add_header Content-Security-Policy "<other-specific-config>" always;
    try_files $uri $uri/ /index.html;
}

为什么这样改能解决问题？ #

1. 去掉rewrite避免location跳转：原来的rewrite .* / last;会让请求重新匹配根location，导致你在原location设置的header全部失效。现在用try_files直接在当前location处理请求，header会正常发送给客户端。
2. 用include复用全局头：避免了重复写全局header的麻烦，同时如果需要修改某个header，直接在location里重新定义即可——Nginx会优先使用当前location最后定义的header值。
3. 严格遵循Nginx的location匹配优先级：精确匹配（location = /login）> 正则匹配（location ~* ...）> 前缀匹配（location /some-other-path）> 根location，确保特定路径的规则会被优先触发。

额外注意事项 #

• 所有需要在错误响应（比如404）中也发送的header，记得加上always参数，否则只有2xx/3xx响应会带这些header。
• 如果某个路径不需要某个全局header，可以在include全局头之后，用add_header <Header-Name> "";来清空它，这样这个header就不会发送给客户端。
• 测试配置时，可以用nginx -t检查语法是否正确，再重启Nginx生效。

备注：内容来源于stack exchange，提问作者Rich