Nginx 处理 WebSession 的进阶方案：基于 Cookie 值的哈希负载均衡-Nginx-PHP中文网

Cookie值哈希路由最可控且扩展性好，因不依赖IP、无需共享Session存储；相比ip_hash（易受NAT/代理影响）和jsessionid解析（受限于应用实现），自定义Cookie一致性哈希（如hash $cookie_ROUTE_ID consistent）由Nginx完全掌控路由逻辑，节点增减时重散列最小，避免session复制与Redis开销。

nginx 处理 websession 的进阶方案：基于 cookie 值的哈希负载均衡

直接用 Cookie 值做哈希路由，是 Nginx 实现 WebSession 会话保持最可控、扩展性也较好的方式。它不依赖客户端 IP，也不需要后端共享 Session 存储，适合 Java 应用（如 Spring Boot）在无侵入前提下维持登录态、购物车等关键状态。

为什么用 Cookie 值哈希，而不是 ip_hash 或 jsessionid 提取？

ip_hash 容易因 NAT、代理或移动网络导致多个用户被压到同一节点，或单个用户因 IP 变动“跳节点”；而仅靠解析 Set-Cookie: JSESSIONID=xxx 并哈希，又受限于应用是否统一生成、是否加密、是否带路径/域限制。主动基于自定义 Cookie（如 ROUTE_ID 或 USER_HASH）做一致性哈希，把控制权交还给负载均衡层，更稳定、可预测。

Cookie 值由 Nginx 注入或由应用写入，但路由逻辑完全由 Nginx 执行，后端无需感知
一致性哈希（hash $cookie_ROUTE_ID consistent;）支持节点增减时最小化请求重散列
避免 session 复制或 Redis 查找的延迟与运维成本

Nginx 配置的关键写法（实测可用）

以下配置片段适用于主流 Nginx 版本（1.19+），需启用 ngx_http_upstream_module 和一致性哈希支持：

Browser Session Manager

使用 Playwright 为 jimeng.jianying.com 管理浏览器会话，导入 cookies/localStorage 以自动化视频生成工作流，支持图片上传等功能

下载

定义 upstream 时启用 hash 指令，并指定 cookie 名称：

upstream backend {<br>  hash $cookie_ROUTE_ID consistent;<br>  server 192.168.1.101:8080;<br>  server 192.168.1.102:8080;<br>  server 192.168.1.103:8080;<br>}

确保首次响应中注入该 Cookie（例如用 add_header Set-Cookie 或配合 Lua 模块生成唯一值）
若应用已写入 USER_TOKEN 等业务 Cookie，也可直接哈希：hash $cookie_USER_TOKEN consistent;，前提是该值具备用户粒度唯一性且不频繁变更

Java 应用侧需配合的细节

Spring Boot 不需要改认证逻辑，但要注意 Cookie 属性设置，否则 Nginx 可能读不到：

Cookie 必须设 Path=/（或匹配 location 路径），否则子路径请求不携带
跨域场景下注意 Domain 设置，如 .example.com 才能让主站与 API 子域共用
若开启 HTTPS，建议加 Secure 和 HttpOnly，Nginx 仍可读取 $cookie_* 变量（这是 Nginx 在 HTTP 解析层提取的原始 header 值，不受 HttpOnly 限制）
避免在登录接口返回多个同名 Cookie（如覆盖写），否则 Nginx 可能取到错误值