如何将Azure App Gateway流量路由至Istio?Nginx场景出现HTTP 426错误如何解决
排障与修复方案
1. 426错误的核心根因定位
HTTP 426(Upgrade Required)通常由请求链路的协议层不匹配触发:
- 当前架构中Azure App Gateway作为前置层承担TLS终止职责,默认向后端转发明文HTTP流量;但你配置的Istio Gateway中,443端口开启了
AUTO_PASSTHROUGH模式,会强制要求连接方完成带TLS的升级握手流程。当AppGW的明文HTTP请求被错误转发到Istio的443端口时,就会触发协议校验失败返回426。 - 之前echo-server能正常访问,是因为其内置的HTTP服务没有强制协议升级校验;切换到Nginx+Node鉴权链路后,Nginx的HTTP实现开启了严格的协议匹配规则,才把这个转发层的配置问题暴露出来。
2. 分层修复步骤
(1)修正Azure AppGW的Ingress配置
原有配置缺少后端转发的协议、端口声明,容易让AppGW错误将流量转发到Istio的443端口,需要在Ingress注解中补充明确的转发规则:
annotations: appgw.ingress.kubernetes.io/backend-path-prefix: / kubernetes.io/ingress.class: azure/application-gateway appgw.ingress.kubernetes.io/ssl-redirect: "true" # 新增配置:明确AppGW到Istio后端的转发规则 appgw.ingress.kubernetes.io/backend-protocol: HTTP appgw.ingress.kubernetes.io/backend-port: 80
- 注意:Istio Gateway中443端口的
AUTO_PASSTHROUGH配置仅适用于外部直连Istio的HTTPS流量,当AppGW在前端终止TLS时,后端链路仅需要走Istio的80端口明文HTTP即可,绝对不要将AppGW的后端转发目标指向Istio的443端口。
(2)修复Nginx Deployment的sidecar注解失效问题
你之前的注解配置层级错误:Istio要求sidecar注入相关的注解必须写入Pod模板层级的metadata中,而非Deployment资源顶层的metadata,导致之前配置的排除规则完全没生效。
正确的Nginx Deployment注解示例:
apiVersion: apps/v1 kind: Deployment metadata: name: nginx labels: app: nginx spec: replicas: 1 selector: matchLabels: app: nginx template: metadata: labels: app: nginx # 注解必须放在Pod模板的metadata层级下 annotations: sidecar.istio.io/inject: "false" traffic.sidecar.istio.io/excludeInboundPorts: "80,443" traffic.sidecar.istio.io/includeInboundPorts: "" spec: containers: - image: nginx name: nginx ports: - containerPort: 80
- 补充:如果你的Nginx服务需要纳入Istio服务网格管理,不要强制开启
sidecar.istio.io/inject: "false",此时需要检查Nginx到后续Node.js鉴权服务的出向流量规则,确保Istio sidecar的出向端口和Node服务的监听端口匹配,避免因协议拦截触发426错误。
(3)对齐Istio路由规则避免链路断裂
你当前的VirtualService路由规则还是指向echo-server的集群地址,切换到Nginx服务时必须同步修改路由的destination目标:
http: - match: - uri: prefix: / route: - destination: port: number: 80 # 替换为你的Nginx Service对应的集群内地址 host: nginx.default.svc.cluster.local
- 额外注意Nginx重定向逻辑:如果Nginx返回的30x重定向使用了内部集群地址,会导致客户端请求绕回集群内部链路,需要确保Nginx的重定向返回地址和AppGW对外暴露的域名一致,避免路由环路。
- 如果Nginx需要保留在服务网格内,需要为Nginx对应的Service配置DestinationRule,关闭强制HTTP2升级逻辑,避免和Nginx到Node.js的重定向、鉴权流程冲突:
apiVersion: networking.istio.io/v1alpha3 kind: DestinationRule metadata: name: nginx spec: host: nginx.default.svc.cluster.local trafficPolicy: connectionPool: http: http2UpgradePolicy: DEFAULT
(4)快速定位故障点的排查手段
跳过Azure AppGW,直接访问Istio Ingress Gateway的80端口验证链路:curl -v http://<istio-ingress-service-ip>/
- 如果直连访问Nginx服务返回正常200响应,可确认故障点在AppGW到Istio的转发协议配置
- 如果直连也返回426,需要检查Istio Gateway的80端口配置:确保protocol字段定义为
HTTP,没有错误设置为HTTPS或强制HTTP2升级模式。
内容的提问来源于stack exchange,提问作者Sunil Agarwal
相关产品推荐
相关产品推荐

