Nginx 中 if 条件判断语句在 location 中怎么配置
在 nginx 的 location 块中使用 if 指令时，必须将其嵌套在目标 location 内部，且仅支持特定的变量比较操作。这种配置通常用于根据请求头、uri 或环境变量动态调整行为，例如重定向或设置标志位。需要注意的是，if 会创建一个新的配置上下文，导致继承关系中断，因此应尽量避免复杂的逻辑组合。
如何基于 URI 路径进行精确匹配与重定向
当需要根据具体的 URL 路径执行重定向时，可以使用 $uri 变量配合 = 运算符进行精确匹配。这种方式适用于将旧版接口指向新版地址，或者对特定静态资源应用不同的处理策略。通过 return 指令直接返回状态码和跳转地址，可以高效地完成流程控制。
server {
listen 80;
server_name example.com;
# 基础位置块
location /api/ {
# 针对特定旧版本接口的重定向
if ($uri = /api/v1/old-endpoint) {
return 301 /api/v2/new-endpoint;
}
# 其他请求转发给后端
proxy_pass http://backend_server;
}
}
如何基于请求头或自定义变量进行访问控制
除了路径匹配，if 还常用于检查 HTTP_USER_AGENT 或自定义变量以实现简单的访问控制。例如，可以通过判断用户代理是否包含特定关键词来拦截爬虫，或者根据查询参数中的令牌有效性来决定是否允许访问。这种用法依赖于 Nginx 内置变量的值，无需额外模块即可实现。
server {
listen 80;
server_name example.com;
location /secure/ {
# 检查 User-Agent 是否包含恶意爬虫特征
if ($http_user_agent ~* "badbot|spider") {
return 403 "Access Denied";
}
# 正常请求处理
proxy_pass http://backend_server;
}
}
如果 location 中同时存在多个 if 条件会发生什么
当在一个 location 块中定义多个 if 条件时，Nginx 会按顺序评估每个条件，但每个 if 都会创建一个独立的配置上下文。这意味着前一个 if 中设置的变量不会自动传递给后一个 if，除非使用全局变量。此外，如果多个条件都匹配，只有第一个匹配的 if 块内的指令会生效，后续的 if 将被忽略。这种“短路”行为和上下文隔离特性可能导致意外的配置失效，因此在复杂场景下建议使用 map 指令替代 if。
