apache mod_rewrite 的 [e=] 标志设环境变量是灰度请求精准标记最直接可控方式，通过cookie、header、query等条件匹配并写入gray_version等变量，再透传至后端。
在 Apache 中用 mod_rewrite 的 [E=] 标志设置环境变量，是实现灰度请求精准标记最直接、最可控的方式。它不依赖外部服务，也不需要修改应用代码逻辑，只需在请求进入代理层时完成识别与打标，后端服务通过读取 $_SERVER['ENV_NAME']（PHP）或类似机制即可感知灰度身份。
从请求特征提取灰度标识
灰度判断依据通常来自客户端可变且可控的输入，比如：
-
Cookie 值：如
version=canary或env=gray -
HTTP Header：如自定义头
X-Env: gray或X-Release: v2.1 -
Query 参数：如
?release=canary或&ab=testB -
IP 段或 User-Agent 特征：适用于内部测试或小范围定向（如只对
192.168.10.网段生效）
这些都可以用 RewriteCond 配合正则匹配捕获，再通过 RewriteRule 的 [E=] 写入环境变量。
配置示例：多条件灰度标记
以下配置片段放在虚拟主机或目录级（.htaccess）中，启用 RewriteEngine On 后生效：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
# 优先匹配灰度 Cookie
RewriteCond %{HTTP_COOKIE} (?:^|;\s*)version=(canary|beta|v[0-9]+) [NC]
RewriteRule ^ - [E=GRAY_VERSION:%1]
# 其次检查自定义 Header
RewriteCond %{HTTP:X-Env} ^gray$ [NC]
RewriteRule ^ - [E=GRAY_ENV:1]
# 再检查 Query 参数（需开启 QSA 保证参数透传）
RewriteCond %{QUERY_STRING} (^|&)release=(canary|staging)(&|$) [NC]
RewriteRule ^ - [E=GRAY_RELEASE:%1]
# 可选：为灰度请求统一打标，便于后续路由或日志区分
SetEnvIfExpr "reqenv('GRAY_VERSION') || reqenv('GRAY_ENV') || reqenv('GRAY_RELEASE')" IS_GRAY=1
配合反向代理转发灰度标识
仅设置环境变量还不够——后端服务需要实际收到该信息。常用两种方式传递：
-
透传为 HTTP Header：用
RequestHeader set将环境变量注入请求头RequestHeader set X-Gray-Version "%{GRAY_VERSION}e" env=GRAY_VERSIONRequestHeader set X-Is-Gray "true" env=IS_GRAY -
作为 CGI/PHP 环境变量暴露：默认已可用，PHP 中直接
$_SERVER['GRAY_VERSION']可读；若未出现，确认启用了PassEnv或使用SetEnvIf补充声明
注意：%{VAR}e 语法用于引用环境变量值，env=VAR 表示仅在该变量存在时执行对应指令。
验证与调试技巧
灰度标记容易因条件顺序、大小写、空格或编码问题失效。建议：
- 在配置中临时加入日志记录：
RewriteLog "/var/log/apache2/rewrite.log"（Apache 2.2）或使用LogLevel alert rewrite:trace3（2.4+） - 用
curl -H "Cookie: version=canary" http://host/path和curl "http://host/path?release=canary"分别测试 - 在 PHP 脚本开头加
print_r($_SERVER);查看是否含GRAY_*或IS_GRAY - 避免在同一条规则中多次
[E=]覆盖，如需组合，用RewriteRule ^ - [E=FLAG1:1,E=FLAG2:2]
