Nginx未在/version接口添加自定义响应头问题求助

核心原因 #

Nginx的add_header指令有个关键特性：当location块中存在if或return语句时，if块内的add_header会覆盖location块中之前定义的配置，且if块不会继承外部的add_header。

看你的/version配置：

• 先定义了add_header "TEST" "TEST"，但后续的if ($request_method = GET)和if ($request_method = OPTIONS)块中单独使用了add_header，导致GET请求时只有Access-Control-Allow-Origin会被添加，TEST头被丢弃；
• OPTIONS请求直接执行return 200，此时location块中提前定义的TEST头根本没机会生效。

解决方案 #

推荐用map指令替代if处理条件响应头，避免if带来的覆盖问题，同时确保所有需要的头正确添加：

步骤1：在http块中添加map配置

http {
    # 新增map定义CORS相关条件变量
    map $request_method $cors_origin {
        GET     *;
        OPTIONS *;
        default "";
    }

    map $request_method $cors_methods {
        OPTIONS "GET, OPTIONS, HEAD";
        default "";
    }

    # 原有的map和其他配置
    map $http_accept $img_suffix {
        "~*webp"  ".webp";
        "~*jxr"   ".jxr";
    }

    server {
        # 原server配置...
    }
}

步骤2：修改location = /version块

location = /version {
    default_type application/json;

    # 通用响应头，添加always参数确保所有响应码都带上
    add_header "TEST" "TEST" always;
    add_header "Access-Control-Allow-Headers" "Authorization, Origin, X-Requested-With, Content-Type, Accept, Cache-Control, Last-Modified" always;
    
    # 通过map变量实现条件响应头
    add_header "Access-Control-Allow-Origin" $cors_origin always;
    add_header "Access-Control-Allow-Methods" $cors_methods always;

    if ($request_method = OPTIONS ) {
        return 200;
    }

    index version;
}

关键说明 #

• always参数：默认add_header仅在200、301等特定响应码下生效，加上该参数可确保所有响应都携带这些头；
• 用map替代if：Nginx的if在location中属于易引发意外的“危险”指令，map是更安全的条件配置方式；
• 避免重复定义：通过变量统一管理条件头，减少冗余，彻底解决覆盖问题。

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