最稳定轻量的方案是用map指令提取cookie值并映射为变量，再proxy_pass动态路由至预定义upstream；禁用location中if+set，因易出错且官方不推荐用于核心路由。
直接用 map 指令提取并映射 Cookie 值，再结合 proxy_pass 动态路由到不同 upstream，是目前最稳定、最轻量的方案。别碰 if + set 在 location 里做路由判断——容易出错，Nginx 官方明确不推荐用于核心分发逻辑。
怎么从 Cookie 提取值并映射成变量
Nginx 不解析 Cookie 自动转为变量，必须手动从 $http_cookie 字符串里正则匹配。比如要读 gray=v2：
- 写法必须是
~*gray=v2（~*表示忽略大小写），不能漏掉~*，否则大小写敏感导致匹配失败 - 正则要覆盖完整字段边界，避免误匹配：例如
~*gray=v2(;|$)更严谨，但多数场景~*gray=v2已够用 - 一定要设
default值，比如default v1_backend，否则未命中时变量为空，proxy_pass http://后面跟空值会报502 Bad Gateway - 如果 Cookie 名含下划线（如
user_id），注意 Nginx 默认不把带下划线的 Cookie 映射为$cookie_user_id变量；此时只能走$http_cookie+ 正则，或启用underscores_in_headers on并改用$cookie_user_id
为什么 upstream 名必须提前定义，且不能动态拼接
proxy_pass http://$upstream_name 中的 $upstream_name 必须是已声明的 upstream 块名，Nginx 不支持运行时拼接字符串生成 upstream（比如 http://v2_backend 写死可以，http://v2_backend_$env 不行）。
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 所有 upstream 必须在
http块顶层定义，不能放在server或location里 - 每个 upstream 至少配
max_fails=2 fail_timeout=30s，否则后端挂了请求仍会持续打过去，造成雪崩 - 不要用
ip_hash或hash $cookie_xxx和map分流混用，会导致权重/灰度逻辑被覆盖
如何让灰度流量透传标识给后端服务
光转发不够，后端常需知道“这个请求是灰度来的”，所以得把原始 Cookie 或自定义 Header 透传下去：
- 用
proxy_set_header X-Gray-Version $gray_upstream把映射后的变量传给后端，比解析原始 Cookie 更可靠 - 若需保留原始 Cookie，加
proxy_pass_request_headers on（默认就是 on，一般不用显式写） - 注意：如果后端是 Next.js、Vue SSR 等框架，建议额外透传
X-Forwarded-For和X-Real-IP，否则getServerSideProps或中间件拿不到真实客户端 IP - 测试时用
curl -H "Cookie: gray=v2" http://example.com/，别只靠浏览器点，浏览器可能缓存旧 Cookie 或发送多余字段干扰匹配
真正容易被忽略的是：Nginx 的 map 块在配置加载时就编译完成，它不支持嵌套或运行时计算；所以所有分支必须静态可枚举，没法写“如果 Cookie 不存在就查 Redis”。灰度规则一旦变复杂，就得考虑上一层网关或服务网格了。
