容器与云原生 / 系统课时
理解 sessionAffinity 的作用
理解 sessionAffinity 的作用
本课解决两个容易混淆的问题:sessionAffinity: ClientIP 到底改变哪一层的选路,以及为什么它不等于应用 Session。你将通过可复现实验观察同一客户端 IP 在粘滞窗口内如何继续命中同一 Service 后端。
学习目标
- 解释
ClientIP会话亲和对 Service 后端选择的影响 - 配置
timeoutSeconds并验证同一客户端 IP 的粘滞行为 - 区分会话亲和、长连接复用与应用层 Session
sessionAffinity 改变的是 Service 选路
Service 的会话亲和属于网络数据平面的连接与流量选路语义。默认 sessionAffinity: None 时,新连接可以被转发到不同的就绪后端;设置为 ClientIP 后,Service 代理会依据它实际观察到的客户端源 IP 维持粘滞关系,使来自同一源 IP 的后续连接在有效期内继续选择同一个后端 Pod。
它不会保存 Cookie、登录状态或 HTTP Session,也不会让多个 Pod 自动共享进程内状态。sessionAffinityConfig.clientIP.timeoutSeconds 控制的是客户端 IP 到后端选择的粘滞时长,不是用户登录会话的过期时间。默认值为 10800 秒,也就是 3 小时。
还要避免把长连接复用误判为会话亲和。HTTP keep-alive、HTTP/2 等机制可能让多个请求沿已经建立的连接持续到达同一 Pod;这时即使没有 ClientIP,短时间内也可能看到相同后端。验证会话亲和时,应尽量建立多次独立连接。

配置并验证 ClientIP
下面创建三个会返回自身 Pod 名称的后端,把粘滞窗口缩短为 60 秒,再从同一个测试 Pod 连续发起五次独立 HTTP 请求。因为每次 wget 都重新建立连接,观察结果不依赖 HTTP keep-alive。
kubectl apply -f - >/dev/null <<'YAML'
apiVersion: apps/v1
kind: Deployment
metadata:
name: web
spec:
replicas: 3
selector:
matchLabels:
app: web
template:
metadata:
labels:
app: web
spec:
containers:
- name: web
image: busybox:1.36
command:
- sh
- -c
- mkdir -p /www && hostname > /www/index.html && httpd -f -p 8080 -h /www
ports:
- containerPort: 8080
---
apiVersion: v1
kind: Service
metadata:
name: web-sticky
spec:
selector:
app: web
sessionAffinity: ClientIP
sessionAffinityConfig:
clientIP:
timeoutSeconds: 60
ports:
- port: 80
targetPort: 8080
YAML
kubectl rollout status deployment/web >/dev/null
kubectl get svc web-sticky -o jsonpath='{.spec.sessionAffinity}{" "}{.spec.sessionAffinityConfig.clientIP.timeoutSeconds}{"\n"}'
kubectl delete pod affinity-client --ignore-not-found >/dev/null
kubectl run affinity-client --restart=Never --image=busybox:1.36 --command -- sleep 3600 >/dev/null
kubectl wait --for=condition=Ready pod/affinity-client --timeout=60s >/dev/null
kubectl exec affinity-client -- sh -c 'for i in 1 2 3 4 5; do wget -qO- http://web-sticky; sleep 1; done'
kubectl delete pod affinity-client >/dev/null预期输出
ClientIP 60
<POD_NAME>
<POD_NAME>
<POD_NAME>
<POD_NAME>
<POD_NAME>五次请求都由同一个 affinity-client Pod 发起,因此在常见的集群内访问路径中,Service 数据平面会持续看到同一个客户端源 IP;60 秒粘滞窗口内,五个 <POD_NAME> 应相同。Pod 名称是动态值,实际结果由 Deployment 生成。
亲和关系不是永久绑定
ClientIP 的目标是让同一源 IP 的后端选择保持稳定,而不是把客户端永久锁在某个 Pod。粘滞窗口到期后,新的连接可以重新选择后端;如果原后端不再属于 Service 的可用端点,例如 Readiness 失败后被移出 EndpointSlice,后续连接也需要改选仍可用的端点。
因此,排查“同一客户端总是访问同一 Pod”时,应先确认是否启用了 ClientIP,再区分它与连接复用、应用层 Session 和后端健康状态。会话亲和本身不负责健康检查,也不复制应用状态。
源 IP 决定亲和性的边界
ClientIP 使用的是 Service 数据平面实际看到的源 IP,不一定等于浏览器或最终用户的真实地址。流量经过反向代理、负载均衡器、网关或源地址转换后,多个用户可能以同一个源 IP 到达 Service;反过来,同一用户的出口地址变化也可能失去原有粘滞关系。
因此,只有确实需要“按可见源 IP 稳定选择后端”时才应使用 ClientIP。如果应用依赖本地 Session、缓存或其他状态,更稳妥的设计通常是把状态外置到共享存储,让后端保持无状态,这样扩缩容、滚动更新和故障恢复都不依赖某个客户端持续命中同一个 Pod。