[JAVA]MyBatis DTD 오류 해결법 : DTD 리소스 로드 실패 시 대처법(Eclipse)

목차

1. 오류 발생 배경
2. 해결 방법
    2-1. Eclipse 에서 외부 DTD 다운로드 설정 확인
3. 마무리 및 정리

 

1. 오류 발생 배경

CRUD 게시판 기능을 개발하던 중, 예상치 못한 오류가 발생했습니다.

기능을 넣은 버튼을 클릭하면 아래와 같은 에러가 발생하며 프로그램이 정상적으로 작동하지 않은 것입니다.

 

Could not find resource mybatis-config.xml

 

처음에는 경로 문제나 파일 누락을 의심했지만, 확인 결과 mybatis-config.xml 파일은 정상적인 위치에 존재하고 있었습니다.

 

확인해보니 XML 파일 상단에 DTD 선언부를 추가했을 때 문제가 발생한다는 사실을 알 수 있었습니다.

 

<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">

 

이 선언부를 삽입하자마자 Eclipse 상에서 빨간 줄이 생기며 에러가 발생했습니다.

 

출처 : https://toddlerprogrammer.tistory.com/164

 

빨간 줄에 마우스를 갖다 대보니, 아래와 같은 메시지가 나타났습니다.

 

Downloading external resources is disabled.

 

즉, 외부 리소스를 다운로드 할 수 없다는 의미였습니다.

 

회사였다면 보안상의 이유로 망이 제한되어 있어 이런 현상이 발생할 수도 있겠지만,

이 상황은 개인 PC의 일반적인 네트워크 환경에서 발생한 것이기에 쉽게 납득이 가지 않았습니다.

 

그렇다고 DTD 선언부를 제거하니, 이번에는 콘솔 창에서 다음과 같은 메시지가 출력되며 기능이 정상적으로 작동하지 않았습니다.

 

Cannot load DTD from http://mybatis.org/dtd/mybatis-3-config.dtd

 

DTD 선언부를 넣어도, 빼도 오류가 발생하는 상황에서 점차 머리가 아파왔습니다.

 

 

2. 해결 방법

구글링을 통해 여러 해결 방안을 적용해보던 중, 드디어 정확한 원인과 해결 방안을 찾아냈습니다.

 

문제의 원인은 Eclipse의 설정 중 외부 DTD 리소스를 다운로드하지 않도록 차단하는 옵션에 있었습니다.

따라서 해당 설정을 변경해 외부 리소스 다운로드를 허용해주는 방식으로 문제를 해결할 수 있었습니다.

 

2-1. Eclipse 에서 외부 DTD 다운로드 설정 확인

 

1) 이클립스 상단 메뉴에서 Window > Preferences 를 클릭합니다.

 

2) 왼쪽 메뉴에서 XML (Wild Web Developer) 를 찾아 클릭합니다.

 

3) 오른쪽 화면에 뜨는 두 개의 옵션 중에서 "Download external resources like referenced DTD, XSD" 옵션을 체크합니다.

 

4) Apply and Close 버튼을 눌러서 설정을 적용하고 나옵니다.

 

 

그러자 빨간 줄이 사라지고, 기능도 정상 작동하는 것을 확인할 수 있었습니다.

 

3. 마무리 및 정리

해결 방법은 정말 간단했지만, 이걸 해결하기 위해 꽤 많은 시간을 쏟아야 했습니다.

같은 문제를 겪는 분들의 시간이 조금이라도 절약되기를 바라며 이만 마치겠습니다.

 

읽어주셔서 감사합니다.