SQL state [99999]; error code [17056;

🐞 문제

쿼리 실행 시 다음과 같은 에러 발생

Error attempting to get column 'PTN_ID' from result set.  
Cause: java.sql.SQLException: 지원되지 않는 문자 집합(클래스 경로에 orai18n.jar 추가): KO16MSWIN949
; uncategorized SQLException for SQL []; SQL state [99999]; error code [17056];
지원되지 않는 문자 집합(클래스 경로에 orai18n.jar 추가): KO16MSWIN949

🔍 원인

• Oracle DB가 KO16MSWIN949 문자 집합을 사용 중인데, JDBC 드라이버에 해당 인코딩을 지원하는 라이브러리(orail18n.jar)가 없음
• MyBatis에서 PTN_ID 조회 시 문자셋 매핑 실패 → SQLException 발생

✅ 해결

• Oracle JDBC 라이브러리 경로에 orail18n.jar 추가(ojdbc6.jar 또는 ojdbc8.jar만 있을 경우 인코딩 매핑이 지원되지 않음)
• WEB-INF/lib 또는 프로젝트 빌드 경로에 jar 파일을 넣고 서버 재실행

✨배운 점

• 단순히 쿼리/코드 문제가 아니라 환경 설정(jar 의존성, 문자셋)에서 문제가 발생할 수 있음.
• 레거시 환경(Oracle, eGovFrame 등)에서는 기본적으로 orai18n.jar 같은 추가 의존성이 필요할 수 있다.