Tomcat 세션 클러스터링 가이드: 고가용성(HA) 환경의 세션 복제 설정

February 23, 2026

서론

서비스 규모가 커지면 L4나 L7 로드 밸런서를 통해 여러 대의 WAS(Tomcat)를 운영하게 됩니다. 이때 사용자의 세션 정보가 특정 서버에만 남아있다면, 로드 밸런싱 과정에서 세션 끊김 현상이 발생합니다. 이를 해결하기 위해 서버 간 세션을 동기화하는 세션 클러스터링(Session Clustering) 설정이 필수적입니다.

1. Tomcat 기본 설정 (server.xml)

Tomcat은 멀티캐스트(Multicast) 방식을 이용한 자체 세션 복제 기능을 제공합니다. server.xml의 <Host> 태그 내부에 <Cluster> 설정을 추가합니다.

<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"
         channelSendOptions="8">
    <Manager className="org.apache.catalina.ha.session.DeltaManager"
             expireSessionsOnShutdown="false"
             notifyListenersOnReplication="true"/>
    <Channel className="org.apache.catalina.tribes.group.GroupChannel">
        <Membership className="org.apache.catalina.tribes.membership.McastService"
                    address="228.0.0.4"
                    port="45564"
                    frequency="500"
                    dropTime="3000"/>
        <Receiver className="org.apache.catalina.tribes.transport.nio.NioReceiver"
                  address="auto"
                  port="4000"
                  autoBind="100"
                  selectorTimeout="5000"
                  maxThreads="6"/>
    </Channel>
</Cluster>

2. 애플리케이션 활성화 (web.xml)

클러스터링 대상이 되는 웹 애플리케이션의 WEB-INF/web.xml 파일에 반드시 다음 태그를 추가해야 합니다. 이 태그가 없으면 세션 복제가 작동하지 않습니다.

<web-app>
    ...
    <distributable />
</web-app>

3. 실무에서의 한계와 대안 (Redis/Spring Session)

Tomcat 자체 세션 복제는 소규모 환경에서는 간편하지만, 서버 수가 늘어날수록 멀티캐스트 통신 오버헤드가 급격히 증가하는 단점이 있습니다.

Sticky Session: 클라이언트 IP를 해싱하여 동일한 서버로만 보내는 방식 (가장 간편하나 서버 장애 시 세션 유실).
Redis Session Storage: 별도의 Redis 서버에 세션을 저장하고 모든 WAS가 이를 공유하는 방식 (가장 권장되는 실무 패턴).

핵심 SEO 포인트: 고가용성과 세션 유실

distributable: web.xml에 이 설정이 누락되어 세션 복제가 안 되는 경우가 실무 장애의 90%입니다.
Multicast vs Unicast: 클라우드 환경(AWS, GCP 등)에서는 멀티캐스트를 지원하지 않는 경우가 많으므로 설정 전 확인이 필요합니다.

결론

Tomcat 세션 클러스터링은 중단 없는 서비스를 위한 핵심 인프라 기술입니다. 운영 환경의 규모와 클라우드 지원 여부에 따라 Tomcat 자체 클러스터링이나 Redis 기반 세션 공유 방식을 적절히 선택하여 적용해 보시기 바랍니다.