[JBOSS EAP] java.sql.SQLException: 지원되지 않는 문자 집합(클래스 경로에 orai18n.jar 추가): KO16MSWIN949
JBoss EAP에서 Oracle DB 연동 시 문자셋 오류 해결을 위한 orai18n.jar 모듈 등록 방법을 정리합니다. 문제 JBoss EAP 7에서 Oracle DB 연동 후 다음과 같은 오류가 발생하는 경우가 있습니다. java.sql.SQLException: 지원되지 않는 문자 집합(클래스 경로에 orai18n.jar 추가): KO16MSWIN949 원인 이 오류는 ojdbc8 드라이버가 KO16MSWIN949 와 같은 특정 문자셋을 지원하지 않기 때문에 발생합니다. 오류 메시지에서도 명시하듯이, 해당 문자셋을 지원하려면 클래스 경로에 orai18n.jar 파일을 추가해야 합니다. 해결 문제 해결을 위해서는 KO16MSWIN949 문자셋을 지원하는 orai18n.jar 파일을 JDBC 드라이버에 추가해야 합니다. 단, JBoss에서는 단순히 jar 파일을 배포하는 방식이 아닌, 모듈로 등록하는 절차가 필요합니다. 따라서 orai18n.jar 파일을 포함한 Oracle JDBC 드라이버를 JBOSS_HOME/modules 디렉터리 하위에 모듈 방식으로 구성해야 정상적으로 인식됩니다. orai18n.jar가 포함된 OJDBC 드라이버 추가 방법 Step 1: 드라이버 파일 준비 Oracle 공식 사이트에서 ojdbc8-full.tar.gz 파일을 다운로드합니다. 이 파일에는 ojdbc8.jar 와 orai18n.jar 가 함께 포함되어 있으므로, 하나만 다운로드한 후 압축을 해제하면 됩니다 https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html 압축 해제 후 다음 두 파일을 확보합니다 ojdbc8.jar orai18n-11.2.0.4.jar Step 2: ojdbc 모듈 등록 다운로드한 jar 파일들과 함께 module.xml 파일을 생성하여 지정된 모듈 경로에 배치하면 JBoss가 해당 드라이버를 모듈로 인식할 수 있습니다. 다운로...