You need to enable JavaScript to run this app. 如何将Azure App Gateway流量路由至Istio?Nginx场景出现HTTP 426错误如何解决
优惠活动
大模型
产品
解决方案
定价
更多

如何将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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 08:45:04