Apache 2.x + JBoss 6.1 反向代理 Session Sticky 配置實戰：mod_proxy_balancer 與 ROUTEID 會話保持

前言

Apache 作為反向代理分發請求至多個 JBoss 節點時，Session 會話保持是關鍵挑戰。本文對比 Session Sticky（會話粘滯）與 Session Replication（會話複製）兩大策略，詳細實踐基於 mod_proxy_balancer + mod_headers 的 ROUTEID Cookie 粘滯方案，含完整配置模板與原理解析。

一、Session 處理策略對比

二、mod_proxy_balancer Sticky Session 原理

1. Apache 收到請求，檢查 Cookie 中是否有 ROUTEID
2. 有 → 解析路由值（如 route=2），直接轉發至對應 BalancerMember
3. 無 → 按負載算法選擇節點，響應時通過 Header add Set-Cookie 種植 ROUTEID
4. 後端節點需配置 jvmRoute 與 route 一致

三、完整 Apache 配置模板

<!-- 1. 載入必要模塊 -->
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule headers_module modules/mod_headers.so
LoadModule status_module modules/mod_status.so

<!-- 2. 種植路由 Cookie（關鍵） -->
Header add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e; path=/" env=BALANCER_ROUTE_CHANGED

<!-- 3. 定義負載均衡集群 -->
<Proxy balancer://mycluster>
    <!-- route 值必須與 JBoss jvmRoute 一致 -->
    BalancerMember https://192.168.77.213:9005 route=1
    BalancerMember https://192.168.77.213:9004 route=2
    BalancerMember https://192.168.77.213:9002 route=3
    BalancerMember https://192.168.77.213:9003 route=4
    
    <!-- 指定粘滯會話 Cookie 名 -->
    ProxySet stickysession=ROUTEID
    
    <!-- 可選：健康檢查 -->
    ProxySet lbmethod=byrequests
</Proxy>

<!-- 4. 代理規則：所有請求轉發至集群 -->
ProxyPass / balancer://mycluster/
ProxyPassReverse / balancer://mycluster/

四、JBoss 6.1 配置協同

<!-- server.xml / standalone.xml -->
<jboss-web>
    <!-- 必須與 Apache route 值完全一致 -->
    <jvmRoute>1</jvmRoute>  <!-- 節點1 -->
</jboss-web>

每個節點修改對應 jvmRoute（1/2/3/4），重啟生效。

五、關鍵指令詳解

六、驗證與調試

1. 瀏覽器開發者工具：檢查 Response Headers 是否有 Set-Cookie: ROUTEID=.2; path=/
2. 後續請求：Request Headers 應攜帶 Cookie: ROUTEID=.2
3. Apache 日誌：啟用 LogLevel debug 觀察路由選擇邏輯
4. 負載均衡器狀態頁：https://apache-host/balancer-manager（需配置 <Location /balancer-manager> SetHandler balancer-manager </Location>）

七、生產環境優化建議

1. 會話排水：擴容/縮容前，標記節點 Draining，待現有 Session 自然結束再下線
2. 備用節點：配置 BalancerMember ... status=+H 熱備，主節點故障自動切換
3. 健康檢查：ProxySet hcmethod=GET hcinterval=30 hcuri=/health
4. SSL 終結：Apache 端終結 HTTPS，後端走 HTTP，減輕 JBoss 壓力
5. 監控告警：節點健康狀態、Session 粘滯率、路由變更頻率

八、總結

• Apache + JBoss 粘滯會話核心：ROUTEID Cookie + jvmRoute 對應
• 配置三步驟：載入模塊 → 種植 Cookie → 定義 BalancerMember(route) + ProxySet(stickysession)
• 優勢：零代碼侵入、性能損耗極低、運維直觀
• 劣勢：單點故障導致 Session 丟失，需配合備用節點、排水機制
• 長期演進方向：無狀態化 + 分布式 Session（Redis）或 Token 驗證