NGINX的if语句是否会清除已添加的响应头？

在NGINX 1.24.0及更早版本中，仅使用if语句（按设计用途）会清除此前在location内添加的所有响应头，以下是相关测试验证：

测试配置与结果 #

配置示例1 #

location /test {
    add_header "Test" "some-value";

    if ($sent_http_test = "some-value") {
        return 201 https://some.url/login;
    }

    // else
    proxy_pass https://myupstream.biz/...;
}

• 当请求返回200（未进入if分支）时，Test响应头存在；将add_header移至父块（server/http）后结果一致。

配置示例2 #

add_header "Test" "some-value";

location /test {
    if ($sent_http_test = "some-value") {
        return 201 https://some.url/login;
    }

    // else
    proxy_pass https://myupstream.biz/...;
}

• 客户端传入Test请求头时会触发201跳转（说明if可以读取请求头），但进入if分支后，父块添加的Test响应头会被清除。

配置示例3（尝试用map解决问题） #

# 在http块中
map $sent_http_test $test_is_some_value {
    some-value yes;
    default    no;
}

# 在server块中
location /test {
    add_header "Test" "some-value";
    add_header "Test2" $test_is_some_value;

    if ($test_is_some_value = "yes") {
        return 201 https://some.url/login;
    }

    // else
    proxy_pass https://myupstream.biz/...;
}

• 非201响应中Test和Test2头均存在，但Test2值为no，说明map无法识别add_header添加的响应头（map仅在请求处理早期阶段解析变量，此时响应头尚未生成）。

配置示例4（单独使用return的情况） #

location /test {
    add_header "Test" "some-value";

    return 201 "test=$sent_http_test";
}

• 返回201响应时，响应体为test=，说明**return无法读取add_header设置的响应头值**，同时add_header添加的响应头也不会出现在201响应中。

结论与问题解答 #

NGINX中if和return确实遵循与add_header块级继承相同的行为逻辑：

1. 块级作用域覆盖：当在if块内使用return（或其他修改响应的指令）时，当前块及父块中定义的add_header会被清空——这是因为if在NGINX中属于"伪location"，一旦进入if分支，会重新初始化响应头集合，原有块的add_header不会被继承。
2. 变量生命周期：$sent_http_*系列变量仅存储请求头的值，而非响应头；响应头是在请求处理后期生成的，map、if这类在早期阶段执行的指令无法读取或引用尚未生成的响应头。

内容的提问来源于stack exchange，提问作者Josh M.