编程 Istio 1.32.0 升级后 Sidecar 起不来、上游 TLS 失败:五个没改配置却变了的默认值

2026-11-21 00:03:45

Istio 1.32.0 升级后 Sidecar 起不来、上游 TLS 失败:五个没改配置却变了的默认值

升级到 1.32.0(2026-11-09)之后,一批工作负载在配置没动的前提下出现了新问题:Sidecar 卡在启动、Envoy bootstrap 直接报无效、上游 TLS 校验失败、出口管控形同虚设。下面按「现象 → 判据 → 根因 → 处理」记录几个高频点。

参考:Istio 1.32.0 发布说明|官网|仓库

1. CIDR 形式的 ServiceEntry 在 15001 上生成通配 listener(#60666)

现象:某些命名空间的 Pod 一直 NotReady,istio-proxy 反复重启;istiod 侧看到 listener 更新被整体拒绝。

判据:

istioctl proxy-status
istioctl proxy-config listener
-n  --port 15001
kubectl logs
-n  -c istio-proxy | grep -i listener

如果 15001 上出现来自 ServiceEntry 的 0.0.0.0 通配 listener,就与 virtualOutbound 冲突了。

根因:地址为 CIDR 的 ServiceEntry 会在 0.0.0.0 通配符上,为保留的代理端口(例如出站捕获端口 15001)生成出站 listener。该通配 listener 与 virtualOutbound listener 冲突,整个 listener 更新被拒绝,Sidecar 因此起不来。

处理:升级到包含 #60666 修复的版本;此后这类端口会被跳过,与具有具体地址的 Service 行为一致。验证时注意:升级后 15001 的 listener 列表会少一项,这是预期变化,不要当成新故障。

2. statsFlushInterval 取值让 Envoy bootstrap 无效

现象:某个工作负载的代理起不来,日志里 Envoy 报引导配置无效;注解值是 1m、2m 或 500ms 这类。

判据:

kubectl get pod
-n  \
-o jsonpath='{.metadata.annotations.sidecar\.istio\.io/statsFlushInterval}'
kubectl logs
-n  -c istio-proxy
istioctl proxy-config bootstrap
-n

根因:sidecar.istio.io/statsFlushInterval 在值为一分钟及以上、以及亚秒级时,会生成无效的 Envoy 引导配置,导致代理无法启动。

处理:升级到含该修复的版本;短期内避开这两类取值。

3. 入站重试从硬编码变成可配(defaultInboundHttpRetryPolicy)

现象:升级并调整网格配置后,入站请求的重试行为变了;或者想去掉入站重试,发现旧版本根本没有开关。

判据:

kubectl get proxyconfig -n
istioctl proxy-config route
-n  -o json

看 inbound route 的 retryPolicy 是否还在、attempts 是多少。

根因:以前入站路由的重试策略被硬编码为在 reset-before-request 时重试 2 次(即最多 3 次尝试),无法调整或关闭。1.32.0 新增 defaultInboundHttpRetryPolicy 网格配置字段;其中只有 attempts、retryOn、backoff 会生效。

处理:要保持旧行为就显式写出 attempts: 2 + retryOn: reset-before-request;要全局关闭入站重试,设 defaultInboundHttpRetryPolicy: {}。

4. WORKLOAD_IDENTITY_SOCKET_TIMEOUT 默认 0s,SPIRE 后绑定套接字会失败(#61343)

现象:接入外部 SDS(SPIRE 等)的环境升级后,上游 TLS 验证失败;代理拿到的不是工作负载身份,而是系统根 CA。

判据:

istioctl proxy-config secret
-n
kubectl logs
-n  -c istio-proxy | grep -iE 'sds|root ca|identity'

根因:pilot-agent 新增的 WORKLOAD_IDENTITY_SOCKET_TIMEOUT 默认值为 0s,保留原有的一次性检查行为——只在启动时查一次套接字。如果外部 SDS 提供程序在 pilot-agent 启动之后才绑定套接字,代理就会向外部 SDS 提供程序请求系统根 CA,进而导致上游 TLS 验证失败。

处理:给 istio-proxy 容器设置 WORKLOAD_IDENTITY_SOCKET_TIMEOUT(例如 30s),让 pilot-agent 在启动时等待套接字就绪,而不是只查一次。也可让 SPIRE 的套接字先于 Pod 就绪。

5. 宽 CIDR + resolution: NONE 绕过 REGISTRY_ONLY

现象:明明配了 outboundTrafficPolicy: REGISTRY_ONLY,流量还是从 Sidecar 透传出去了。

判据:

kubectl get serviceentry -A -o yaml | grep -A3 addresses
kubectl get configmap istio -n istio-system -o jsonpath='{.data.mesh}'
istioctl analyze -n

根因:全匹配地址(0.0.0.0、::)、未指定网络的地址(0.0.0.0/N、::/N),或前缀短于 /8 的 CIDR,如果使用 resolution: NONE 和默认 exportTo,会让网格中每个 Sidecar 在该端口上透传流量,从而绕过 outboundTrafficPolicy: REGISTRY_ONLY。

处理:改用范围更窄的 CIDR,并加 exportTo: ["."];需要强制出口管控时,把出口网关与 NetworkPolicy 结合使用。1.32.0 对这类地址新增了验证警告,istioctl analyze 能直接报出来。

相邻的两个默认值

istiod panic(#61857):为 resolution: DNS、endpoints 跨多个 locality 的 ServiceEntry 生成 STRICT_DNS/LOGICAL_DNS 集群,同时又存在设置了 trafficPolicy.loadBalancer.localityLbSetting.failoverPriority 的 DestinationRule 时,istiod 会 panic。受影响的代理一旦连上来,istiod 就进入崩溃循环,任何配置都推不下去。判据:

kubectl get pods -n istio-system
kubectl logs -n istio-system deploy/istiod | grep -i panic

自签名 CA:istio-ca-secret 里的自签名 CA 证书过期时,istiod 以前会起不来,典型触发场景是 Deployment 缩容到零的时间超过证书 TTL;现在会用现有私钥自动续期。另外新增 PILOT_DISABLE_SELF_SIGNED_CA,默认 false;设为 true 时,如果没有插入的 cacerts 捆绑包,istiod 将不再生成或复用自签名根 CA,而是直接无法启动其 CA。

推荐文章

程序员茄子在线接单