[Spring Boot] Exception 지원되지 않는 문자 집합(클래스 경로에 orai18n.jar 추가)

웹 애플리케이션을 리뉴얼 하거나 기존 내용을 이용해서 새로운 기능을 넣을경우, 혹은 라이브러리가 달라질경우 다양한 경우들에서 Exception들을 마주하게 됩니다.

이번 포스팅에서는 지원되지 않는 문자 집합에 관련된 Exception이 발생했을때 해결방안에 대한 내용입니다.

---

지원되지 않는 문자 집합

이 Exception의 경우는 DB에 세팅된 문자 인코딩 방식이 JDBC에서 지원하지않는 인코딩 방식이기 때문에 발생되는 에어입니다.

HTML에서도 그렇고 Java에서도 그렇고 DB까지 한글에 관련된 인코딩 문제로 과거 많은 고생들을 했던것 같습니다. 제가 사용하던 애플리케이션에서는 기존에 ojdbc8.jar를 사용했습니다. 그리고 DB는 KO16MSWIN949이며 이는 JDBC에서 지원하지 않는 인코딩입니다.

그렇다면 해결방법은 무엇일까요?

---

지원되지 않는 문자 집합 해결 방법

로그를 보시면 알수 있습니다. Exception이 발생하면서 아래와 같은 로그를 보실 수 있으실 겁니다.

지원되지 않는 문자 집합(클래스 경로에 orai18n.jar 추가): KO16MSWIN949

즉, orai18n.jar를 추가해주시면 됩니다. 저는 Gradle을 이용해서 라이브러리 패키지 관리를 해주고 있으니 dependencies를 추가해 주었습니다.

Implementation ‘com.oracle.ojdbc:orai18n:19.3.0.0’

Dependencies에 추가하는 방법도 있지만 직접 다운로드해서 추가하는 방법도 있습니다. 편한 방법을 선택해서 추가해주시면 정상적으로 Exception 없이 실행됨을 알 수 있습니다.

---

이번 포스팅에서는 지원하는 언어에 관련된 Exception을 해결하는 방법을 알아보았습니다. 트러블슈팅은 경험에서 나오는 것이기 때문에 정리하고 알아두면 좋은것 같습니다. 도움이 되셨으면 합니다. 이상입니다.