JBoss 장애 사례: 문자 인코딩, 클러스터, 포트 설정 이슈

JBoss 장애 사례: 문자 인코딩, 클러스터, 포트 설정 이슈

이 시리즈는 실무에서 발생한 JBoss 장애 사례들을 정리한 내용입니다.
이번 글에서는 문자 인코딩 문제, 클러스터 설정 오작동, 멀티캐스트 포트/방화벽 설정 문제에 대해 다룹니다.

---

✅ 1. 한글 깨짐 (문자 인코딩 문제)

🔹 증상

• 웹 화면 또는 로그에서 한글이 깨짐
• EUC-KR 기반 시스템에서 발생

🔹 원인

• Apache는 AddDefaultCharset EUC-KR
• JBoss는 기본 UTF-8 사용

🔹 해결 방법

Apache 설정 (httpd.conf)

AddDefaultCharset EUC-KR

JBoss JAVA_OPTS

-Dorg.apache.catalina.connector.URI_ENCODING=EUC-KR
-Dorg.apache.catalina.connector.USE_BODY_ENCODING_FOR_QUERY_STRING=false
-Dfile.encoding=EUC-KR

---

✅ 2. 클러스터가 물리 서버 간 동작 안함

🔹 증상

• 로컬에서는 JBoss 클러스터 동작함
• 물리적으로 분리된 서버 간 클러스터가 동작하지 않음

🔹 원인

• 0.0.0.0 바인딩 사용 시 로컬에서는 정상
• 실제 통신 시 멀티캐스트/포트 충돌 또는 인터페이스 문제

---

✅ 3. Windows에서 클러스터 통신 실패

🔹 원인

• Windows 방화벽에서 UDP 차단

🔹 해결 방법

JGroups 소켓 바인딩 설정

<socket-binding name="jgroups-udp"
  port="55200"
  multicast-address="230.0.0.4"
  multicast-port="45688"/>

방화벽 설정

• 45688/UDP, 55200/UDP 포트 허용 필요

---

✅ 마무리

• 인코딩 설정은 Apache와 JBoss가 일치해야 하며,
• 클러스터링 시 멀티캐스트 주소/포트/방화벽 설정을 반드시 확인해야 합니다.