在 nginx 灰度发布时,可以通过配置 map 指令匹配特定的请求头(如 x-gray-release),将命中该头的请求重定向到后端灰度服务器组,同时利用 proxy_cache_bypass 指令跳过全局缓存。具体做法是定义一个变量,当请求头存在时设为特定值,并在 location 块中结合 proxy_pass 实现流量分发与缓存绕过。

如何根据请求头区分灰度流量并路由到指定后端
通过 map 模块可以基于请求头动态选择上游服务器组。当请求携带 X-Gray-Release: true 时,Nginx 会将流量转发至 gray_backend,否则走默认的 main_backend。这种机制无需修改应用代码即可实现灰度控制。

upstream main_backend {
server 192.168.1.10:80;
}
upstream gray_backend {
server 192.168.1.20:80;
}
map $http_x_gray_release $target_backend {
default "main_backend";
"true" "gray_backend";
}
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://$target_backend;
proxy_set_header Host $host;
}
}上述配置中,map 块定义了变量 $target_backend 的值取决于请求头 $http_x_gray_release。如果请求头为 true,则指向灰度后端;否则指向主后端。测试时发送带 X-Gray-Release: true 的请求,应返回灰度服务器的响应。
如何在灰度路由的同时绕过全局缓存
在灰度发布期间,通常希望获取最新数据而不受缓存影响。通过在 location 块中设置 proxy_cache_bypass,可以强制 Nginx 不读取本地缓存并直接向源站发起请求。结合之前的灰度路由逻辑,可实现灰度流量的实时性保障。

upstream main_backend {
server 192.168.1.10:80;
}
upstream gray_backend {
server 192.168.1.20:80;
}
map $http_x_gray_release $target_backend {
default "main_backend";
"true" "gray_backend";
}
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://$target_backend;
proxy_set_header Host $host;
# 启用缓存
proxy_cache my_cache;
proxy_cache_valid 200 10m;
# 灰度请求或特定头部时绕过缓存
proxy_cache_bypass $http_x_gray_release;
proxy_no_cache $http_x_gray_release;
}
}此配置在原有灰度路由基础上增加了缓存控制。proxy_cache_bypass 和 proxy_no_cache 均使用 $http_x_gray_release 作为判断条件。当该请求头存在且非空时,Nginx 不会从缓存中获取响应,而是直接向后端请求。验证时,先访问普通页面确认缓存生效,再带 X-Gray-Release: true 访问,应始终获得最新内容。
当请求头值为 false 时是否仍会绕过缓存
在上述配置中,proxy_cache_bypass 的行为取决于变量的值。若 $http_x_gray_release 为空字符串或未设置,其值为 false 或 0,此时不会触发绕过,正常走缓存流程。只有当请求头明确设置为非空且非 0、false 等 falsy 值时,才会绕过缓存。因此,若显式传入 X-Gray-Release: false,需确保该值不被视为 falsy,否则可能意外绕过缓存。建议在实际使用中统一使用 true 表示灰度,其他情况视为非灰度。


















