Nginx如何校验可选请求头：缺失设为false，非法值返回错误

要实现「请求头不存在时默认取值为false，存在时必须是true/Y/false/N之一，否则返回400」的逻辑，可以通过map指令结合条件判断完成，具体配置如下：

1. 定义合法性校验变量 #

通过map区分三种场景：请求头不存在、请求头取值合法、请求头取值非法：

map $http_optional_header $is_header_valid {
    # 请求头不存在（空字符串）标记为合法
    ""          1;
    # 合法取值列表
    "true"      1;
    "Y"         1;
    "false"     1;
    "N"         1;
    # 其他所有非法取值标记为不合法
    default     0;
}

2. 拦截非法请求 #

仅当请求头存在且取值非法时返回400错误，避免将可选请求头强制变为必填项：

if ($http_optional_header != "" and $is_header_valid = 0) {
    return 400;
}

3. 可选：统一请求头取值（默认false） #

如果后续逻辑需要标准化的取值（不存在时默认false，合法取值统一转换为true/false），可再定义一个map：

map $http_optional_header $optional_header_value {
    # 请求头不存在时默认设为false
    ""          "false";
    # 把Y/true统一转为true
    "true"      "true";
    "Y"         "true";
    # 把N/false统一转为false
    "false"     "false";
    "N"         "false";
}

配置说明 #

• 第一个map的核心逻辑：空字符串（请求头不存在）属于合法范围，只有非空且不在指定列表的取值才会被标记为非法。
• if条件精准拦截「请求头存在但取值非法」的请求，不会误判无请求头的合法请求。
• 第二个map是可选增强，方便后续逻辑直接使用统一的布尔值，无需重复判断原始取值。

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