Spring Boot + MyBatis 연동 시 나타나는 지독한 404 에러 해결기

신규 프로젝트에 MyBatis를 연동하다 보면 서버는 정상인데 정작 페이지는 '404 Whitelabel Error'를 뱉는 당혹스러운 순간이 있죠. 저도 최근 프로젝트 세팅 중에 이 에러 때문에 한참을 씨름했는데요. 결국 원인은 아주 기본적인 '설정'과 '패키지 구조' 문제였습니다. 혹시 비슷한 삽질을 하고 계신 분들을 위해 제가 겪은 원인 2가지를 정리해 보았습니다. 핵심 체크포인트 @SpringBootApplication 위치에 따른 컴포넌트 스캔 범위 문제 MyBatis @MapperScan 설정 누락 및 경로 불일치 단순히 코드만 복붙하기보다 왜 이런 구조적 문제가 발생하는지 블로그에 상세히 기록해 두었습니다. 같은 오류로 시간 낭비하고 계신 분들께 작은 도움이 되길 바랍니다! [링크] https://sunny4844.tistory.com/entry/Spring-Boot-Whitelabel-Error-Page-404-원인과-해결-방법-MyBatis-연동-시