nginx用302重定向实现多环境流量切换，核心是按请求头、ip或参数等条件临时导向测试/灰度/预发环境，保持生产url权重、支持快速回滚；需避免误配301、确保$request_uri完整传递、统一用return 302而非rewrite redirect。
Nginx 配置 302 重定向做多环境流量切换，核心是按条件把特定请求临时导向测试/灰度/预发环境，同时不干扰生产索引和用户 bookmark。它不是永久搬家，而是“这次先去那边看看”，对 SEO 友好、可随时切回。
302 重定向用于多环境切换的关键逻辑
- 浏览器每次都会重新请求原地址，不会缓存跳转结果
- 搜索引擎保留原 URL 权重，不转移也不稀释
- 适合 A/B 测试、功能灰度、运维验证等需快速回滚的场景
- 必须避免误配成 301，否则可能被搜索引擎固化跳转，导致灰度变“永久”
常见切换维度与配置写法
按请求头（如自定义 header 或 cookie）分流
适用于内部测试人员或白名单用户访问预发环境：
server {
listen 80;
server_name app.example.com;
# 若携带 x-env=staging 或 cookie 中有 env=staging，则 302 到预发站
if ($http_x_env = "staging") {
return 302 https://staging-app.example.com$request_uri;
}
if ($cookie_env = "staging") {
return 302 https://staging-app.example.com$request_uri;
}
# 默认走生产
location / {
proxy_pass https://prod-backend;
}
}
按来源 IP 或 IP 段切流
适合运维、QA 团队直连灰度服务：
geo $is_gray_ip {
default 0;
192.168.10.0/24 1; # 内网测试段
203.0.113.42 1; # 某 QA 工作机
}
server {
listen 80;
server_name app.example.com;
if ($is_gray_ip) {
return 302 https://gray-app.example.com$request_uri;
}
location / {
proxy_pass https://prod-backend;
}
}
按路径前缀或参数动态跳转
比如带 ?env=beta 的链接自动导向 beta 环境：
server {
listen 80;
server_name app.example.com;
if ($arg_env = "beta") {
return 302 https://beta-app.example.com$request_uri;
}
# 或匹配路径：/beta/xxx → beta 环境（去掉 /beta/ 前缀再转发）
location ^~ /beta/ {
rewrite ^/beta/(.*)$ /$1 break;
proxy_pass https://beta-backend;
proxy_set_header Host beta-app.example.com;
}
location / {
proxy_pass https://prod-backend;
}
}
注意事项与避坑点
-
不要在
location块里混用rewrite ... redirect和return 302：两者都触发客户端跳转，但return更轻量、语义更清晰；rewrite ... redirect会额外触发一次 location 匹配，易引发意外行为 -
$request_uri要带上：确保查询参数（如?utm_source=test）完整传递，避免灰度用户丢失上下文 -
避免链式跳转：比如 A → B → C，Nginx 最多响应一次 302；若需多级判断，用
if + return统一出口，别嵌套rewrite -
HTTPS 保持协议一致：目标地址最好显式写
https://，尤其当入口是 HTTPS 时，避免混合内容或跳转失败 -
测试务必用
curl -v验证：检查返回状态码确实是302，且Location头正确，无 301 残留或 500 报错
不复杂但容易忽略。
