envoy网关实现精准流量切换的核心是基于l7层请求特征（如header、cookie、user-agent、路径、grpc方法等）的动态条件路由，而非简单权重分配；结合gateway api声明式配置、rtds运行时开关及完备可观测性保障安全可控。
用Envoy网关实现精准流量切换，核心在于利用其动态路由能力与细粒度匹配规则，而不是简单地“切一半流量”。关键不是配权重数字，而是明确“按什么条件切”和“切到哪里去”。
按请求特征做条件路由
精准切换的前提是识别真实业务上下文。Envoy支持基于Header、Cookie、Query参数、路径前缀、甚至gRPC方法名等L7层信息做判断，比纯权重更可控。
- 比如灰度研发人员流量：匹配 Header: x-user-group: dev → 转发到
api-v2集群 - 比如只切iOS用户的新功能：匹配 Header: user-agent 正则
.*iPhone.*→ 路由至api-new - 比如按用户ID哈希分流（避免会话漂移）：用 envoy.filters.http.router + 自定义元数据插件提取
user_id，再通过hash_policy分发
用Gateway API声明式配置（推荐K8s环境）
在Kubernetes中，优先使用 HTTPRoute 资源，它天然支持多条件匹配与权重组合：
- 一条规则可同时指定
matches（条件）和backendRefs（目标），支持weight和filters（如 header 修改、重写） - 例如：先匹配
cookie: version=canary，命中则100%走新版本；否则再检查header: x-canary: true，再否则才按90/10权重兜底 - 所有变更通过
kubectl apply生效，无需重启，毫秒级生效
结合运行时动态开关（RTDS）做安全兜底
即使配置了条件路由，也建议接入 Runtime Discovery Service (RTDS)，把关键开关外置化：
- 把“是否开启灰度”、“新版本流量上限”等设为运行时键值，如
feature.canary.enabled: true - 在路由规则中引用该值：
runtime_key: feature.canary.enabled，Envoy自动监听变化 - 线上出问题时，运维可秒级关闭灰度（改一个配置项），比删YAML或调权重更稳妥
验证与可观测性不能少
精准切换必须配套可观测手段，否则等于“盲切”：
- 在Envoy中启用
access_log并记录%REQ(x-envoy-original-path)%、%UPSTREAM_CLUSTER%、%RESP(X-Envoy-Upstream-Service-Time)% - 用Prometheus采集
envoy_cluster_upstream_rq_xx指标，按cluster和response_code维度拆分，确认新版本错误率是否异常 - 配合Jaeger或Zipkin打标，确保一次请求的完整链路能区分旧版/新版处理路径
