Nginx同location块中多个if指令的执行逻辑及问题咨询

我来帮你拆解这个问题——Nginx的if指令在同一个location里的行为很容易踩坑，尤其是结合add_header和终止类指令的时候。

核心机制：顺序执行，但注意终止指令的影响 #

首先明确：同一个location内的多个if指令是按书写顺序依次判断执行的，只要条件满足就会执行块内的指令。但有个致命的细节：如果某个if块里包含了return、rewrite ... last或者rewrite ... permanent这类会终止当前请求处理流程的指令，那么后续的if指令就不会再执行了。

你的CORS问题大概率出在这里 #

结合你的场景：当请求同时是OPTIONS方法且来自特定域名时，你的第一个if（匹配域名）确实会先执行，但如果第二个if（匹配OPTIONS）里有return 204;这类终止指令，这里有个容易忽略的add_header特性：

Nginx的add_header指令，只有当响应的最终状态码属于200、201、204、206、301、302、303、304、307、308这个列表时，设置的头才会被发送到客户端。

但更关键的是：很多人会误以为return会清空之前设置的头，但其实只要前面的if条件满足且执行了add_header，这些头会被携带到响应里——除非你的第二个if块里用了同名的add_header覆盖了之前的设置，或者你的域名匹配逻辑有问题（比如误用了$host而不是$http_origin来判断请求来源域名）。

给你一个修正后的可靠配置示例，解决这个问题：

location /your-target-path {
    # 用$http_origin判断请求来源域名，更符合CORS场景的逻辑
    if ($http_origin = https://your-specific-domain.com) {
        add_header Access-Control-Allow-Origin $http_origin;
        add_header Access-Control-Allow-Credentials true;
    }

    # 处理OPTIONS预请求，这里的add_header会和上面的累加
    if ($request_method = OPTIONS) {
        add_header Access-Control-Allow-Methods "GET, POST, OPTIONS, PUT, DELETE";
        add_header Access-Control-Allow-Headers "Content-Type, Authorization";
        # return不会影响前面已设置的头，只要域名匹配条件满足，CORS头会被正常发送
        return 204;
    }

    # 你的其他业务配置，比如反向代理、静态文件服务等
    proxy_pass http://your-upstream-service;
}

进阶优化：尽量减少if的使用 #

Nginx官方其实不推荐在location里过多使用if（甚至称其为"evil"），你可以用map指令提前在http块做条件判断，让配置更清晰可靠：

# 在http块全局定义map，提前判断允许的CORS域名
map $http_origin $cors_allowed {
    default "";
    https://your-specific-domain.com "true";
}

# 提前标记OPTIONS请求
map $request_method $is_options {
    OPTIONS "true";
    default "";
}

server {
    # ...其他server级配置

    location /your-target-path {
        # 仅当域名允许时设置CORS基础头
        if ($cors_allowed = "true") {
            add_header Access-Control-Allow-Origin $http_origin;
            add_header Access-Control-Allow-Credentials true;
        }

        # 处理OPTIONS预请求
        if ($is_options = "true") {
            add_header Access-Control-Allow-Methods "GET, POST, OPTIONS, PUT, DELETE";
            add_header Access-Control-Allow-Headers "Content-Type, Authorization";
            return 204;
        }

        # 业务配置
        proxy_pass http://your-upstream-service;
    }
}

关键总结 #

• 多个if在同一个location里顺序执行，满足条件就执行块内指令；
• 若某个if包含return等终止指令，后续if不会执行，但之前设置的头会保留（只要状态码符合要求）；
• add_header的生效依赖最终响应状态码，多个add_header会累加（除非用同名头覆盖）；
• 优先用map做全局条件判断，减少location内if的使用，避免踩坑。

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