Nginx用if指令实现前端灰度发布，本质是基于请求特征（如Cookie、IP）动态选择后端或静态路径；它轻量易用但受限于单条件判断、不可嵌套，适用于小规模快速验证，需避免在if中使用proxy_set_header等高危指令。
用 Nginx 的 if 指令做前端灰度发布，本质是根据请求特征（如 Cookie、Header、IP）动态选择后端服务或静态资源路径。它轻量、无需额外组件，适合小规模、快速验证场景，但要注意 if 在 location 中的限制和潜在陷阱。
灰度原理：靠 if 切流量，靠 proxy_pass 或 alias 定向
Nginx 的 if 不能直接写在 server 块顶层，必须放在 location 内；它不支持嵌套，也不支持逻辑运算符（如 && ||），只能单条件判断。灰度的核心是：满足灰度条件 → 改变 proxy_pass 目标或 alias 路径；否则走默认逻辑。
- 常用判断依据：请求头（
$http_x_version）、Cookie（$cookie_version）、IP 段（$remote_addr）、User-Agent（$http_user_agent） - 注意：
if中的变量必须存在，否则可能被忽略；建议配合set预设默认值 - 不推荐用
if (!-f ...)做文件存在性判断来灰度，性能差且不可靠
实战示例：按 Cookie 灰度到新版静态资源
假设主站静态资源部署在 /dist/v1/，灰度版在 /dist/v2/，用户携带 version=v2 的 Cookie 即进入灰度。
location / {
# 先设默认版本
set $dist_path "/dist/v1";
<pre class="brush:php;toolbar:false;"># 满足灰度条件则覆盖
if ($cookie_version = "v2") {
set $dist_path "/dist/v2";
}
# 注意：alias 后路径需以 / 结尾，且不自动拼接 URI
alias /usr/share/nginx/html$dist_path/;
# 若用 root，则需配合 rewrite 或 index，更易出错，推荐 alias + set}
立即学习“前端免费学习笔记（深入）”；
⚠️ 关键点：alias 不像 root 那样自动拼接 URI，所以 alias /path/ + 请求 /js/app.js → 实际找 /path/js/app.js；确保路径结构一致。
进阶用法：按 IP 段灰度到不同后端服务
将内网测试人员（如 192.168.10.0/24）流量打到新 API 服务 backend-v2，其余走 backend-v1：
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
upstream backend-v1 {
server 10.0.1.10:8000;
}
<p>upstream backend-v2 {
server 10.0.1.20:8000;
}</p><p>location /api/ {</p><h1>默认走 v1</h1><pre class="brush:php;toolbar:false;">proxy_pass http://backend-v1;
# 满足 IP 条件则重写 proxy_pass（注意：if + proxy_pass 是允许的，但仅限简单字符串）
if ($remote_addr ~ "^192\.168\.10\.") {
proxy_pass http://backend-v2;
}}
立即学习“前端免费学习笔记（深入）”；
✅ 这里 proxy_pass 值是纯字符串，Nginx 允许；❌ 但不能写成 proxy_pass http://backend-$version（变量插值在 proxy_pass 中不生效）。
避坑提醒：哪些 if 不能用
if 是 Nginx 中“看起来能用、实际很危险”的指令，以下情况务必避免：
- 在
if块中使用proxy_set_header、rewrite（除简单跳转外）、return（除非你明确知道执行顺序） - 把多个
if并列写来模拟“与”逻辑（Nginx 不支持短路，且行为不可预测） - 依赖
if做安全控制（如鉴权），应改用auth_request或 Lua 模块 - 灰度比例控制（如 5% 随机）——
if无随机函数，得用map+$request_id或第三方模块
真正稳定的灰度方案，建议后续迁移到 map 指令或 OpenResty + Lua，但 for quick win，if 确实够用。
