전자정부 프레임워크 Mybatis Invalid bound statement (not found) 에러

Question

안녕하세요, 전자정부로 작성된 프로젝트에서 Mybatis Invalid bound statement (not found) 에러가 납니다. 다른 매퍼들은 다 문제없이 작동하는데 파일 하나만 문제네요 ㅠ 이것저것 시도해 봤는데 해결이 안돼서 혹시 Mybatis 잘 아시는 분이 도와주실 수 있을까 하여 질문 올려 봅니다..

추가) MapperScan, namespace, statement id 시도해봤어요!

커리어리 AI 봇 · Answer

Mybatis에서 Invalid bound statement (not found) 에러가 발생하는 경우, 몇 가지 가능한 원인과 해결 방법을 살펴볼 수 있습니다. 여기에 몇 가지 대표적인 사례를 안내해드리겠습니다:

1. Mapper 인터페이스와 XML 파일의 연결 오류: Mapper 인터페이스와 XML 파일의 연결이 정확하지 않을 수 있습니다. 이 경우, Mapper 인터페이스의 @Mapper 어노테이션 또는 MapperScan 설정이 제대로 되어 있는지 확인하고, XML 파일의 namespace와 Mapper 인터페이스의 메서드 이름이 일치하는지 확인해야 합니다.

2. XML 파일 위치 및 이름 오류: XML 파일의 위치와 이름이 올바르게 설정되어 있는지 확인해야 합니다. XML 파일이 올바른 경로에 위치해 있는지 확인하고, 파일 이름과 확장자가 정확한지 확인해야 합니다.

3. Mapper XML 파일 내의 statement id 오류: Mapper XML 파일 내의 각 statement의 id가 올바르게 작성되어 있는지 확인해야 합니다. statement id가 매핑되지 않은 메서드 이름과 일치하는지 확인하고, namespace와 함께 유일한 값을 가지는지 확인해야 합니다.

4. MapperScan 설정 오류: MapperScan 어노테이션 또는 XML 설정이 올바르게 설정되어 있는지 확인해야 합니다. BasePackage 설정이 올바른 패키지 경로를 가리키고 있는지 확인하고, Mapper 인터페이스가 올바른 패키지에 위치해 있는지 확인해야 합니다.

5. 매퍼 파일 로드 오류: Mybatis가 매퍼 파일을 로드하지 못하는 경우도 있습니다. 이 경우, Mybatis 설정 파일에서 매퍼 파일의 경로를 올바르게 설정하고, 매퍼 파일이 프로젝트 빌드 경로에 있는지 확인해야 합니다.

이 외에도 다양한 원인이 있을 수 있으므로, 발생한 에러 메시지와 함께 코드와 설정 파일의 일부를 공유해주시면 더 정확한 도움을 드릴 수 있습니다.