HAProxy的StickyTable是基于服务端session ID查表实现会话保持的机制，通过内存哈希表绑定JSESSIONID与后端服务器，支持加密验证、自动过期和多维度匹配，无需修改Java应用代码。
HAProxy 的 StickyTable 是一种高效、可扩展的会话保持机制，特别适合 Java 应用（如 Spring Boot、Tomcat）在集群部署中实现跨节点的会话一致性。它不依赖客户端 Cookie 值本身做路由，而是通过服务端生成的 session ID（如 JSESSIONID）查表匹配后端服务器，从而避免 Cookie 被篡改或客户端禁用 Cookie 时的失效风险。
StickyTable 的核心原理与优势
StickyTable 在 HAProxy 内存中维护一张哈希表，记录 session ID 与后端服务器（server）的绑定关系。每次请求到达时，HAProxy 提取请求中的 session ID（例如从 Cookie 或 URL 中），查找该表；若命中，则转发到对应 server；若未命中（新会话），则按负载均衡算法（如 roundrobin）选择一台 server，并将该 session ID 与 server 的映射写入表中。
相比传统 cookie insert 或 cookie rewrite 模式，StickyTable 的优势在于：
- 支持 session ID 加密/签名验证（配合
stick store-response和stick match），防止客户端伪造 - 可配置过期时间（
expire），自动清理无效会话，节省内存 - 支持多维度 stickiness（如结合 IP、User-Agent 等做复合匹配）
- 与 Java 应用解耦——无需修改应用代码或 session 存储方式（如仍可用本地内存、Redis 等）
Java 应用侧的关键配合点
要让 StickyTable 正常工作，Java 应用需确保以下几点：
立即学习“Java免费学习笔记（深入）”；
-
Session ID 必须可被 HAProxy 提取：默认使用
JSESSIONIDCookie，且不能被标记为HttpOnly或Secure阻止读取（HAProxy 在七层解析 HTTP，不依赖浏览器行为，HttpOnly不影响其读取） -
避免重写或覆盖 JSESSIONID：如 Spring Session 默认会重写 cookie 名（如
SESSION），需显式配置回JSESSIONID或在 HAProxy 中适配新名称 -
响应中需携带 Set-Cookie：首次请求返回 200 时，应用必须设置
Set-Cookie: JSESSIONID=xxx，HAProxy 才能通过stick store-response捕获并写入表 -
注意路径和域范围：Cookie 的
Path和Domain应覆盖所有子路径，否则后续请求可能不携带该 Cookie
HAProxy 配置示例（关键片段）
以下为典型的 backend 配置，启用基于 JSESSIONID 的 StickyTable：
backend java_app
balance roundrobin
# 定义 sticky table：最大 100k 条目，5 分钟无访问则过期
stick-table type string len 64 size 100k expire 5m
<pre class="brush:php;toolbar:false;"># 从请求 Cookie 中提取 JSESSIONID 值作为匹配键
stick on cookie(JSESSIONID) domain example.com
# 从响应 Set-Cookie 中捕获 JSESSIONID 并写入表（仅当响应含 Set-Cookie 且值非空）
stick store-response cookie(JSESSIONID) domain example.com
# 后端服务器定义
server app1 192.168.1.10:8080 check
server app2 192.168.1.11:8080 check
说明：
-
type string len 64：session ID 通常为 UUID 或 Base64 字符串，64 字节足够 -
domain example.com：限定只处理指定域名下的 Cookie，提升安全性 - 若 Java 应用使用 HTTPS，HAProxy 通常终止 SSL，此时 Cookie 的
Secure标志会被忽略（因 HAProxy 视为 HTTP 流量），无需额外处理
进阶：防伪造与故障恢复
为增强健壮性，可启用 session ID 签名验证：
- 在 backend 中添加
stick match str+stick store-response组合，配合自定义 header（如X-Session-Sig）传输签名 - Java 应用在创建 session 时，用共享密钥对 JSESSIONID 做 HMAC-SHA256，并写入响应 header；HAProxy 解析该 header 并校验，仅校验通过才写入 sticky table
- 当某台后端宕机，HAProxy 可配置
on-marked-down shutdown-sessions清理关联会话，避免“幽灵会话” - 搭配
http-check expect status 200和健康检查，确保只将流量导给真正可用的节点
StickyTable 是 HAProxy 中兼顾性能、安全与灵活性的会话保持方案，尤其适用于对会话一致性要求高、又不愿引入外部 session 存储（如 Redis）的 Java 中小规模集群场景。
