[Spring Boot] ConflictingBeanDefinitionException 오류 해결 방법

📌 오류 원인

• org.springframework.context.annotation.ConflictingBeanDefinitionException
• 패키지 이동, 파일명 변경 등으로 동일한 파일 이름이 중복되었을 때 발생

 

📌 해결 방법

1. 프로젝트 Clean
   • IDE 메뉴에서 Project > Clean 또는 CLI에서 ./gradlew clean, mvn clean 명령어 사용
2. 빌드 폴더 삭제 후 재빌드
   • Maven 프로젝트: target 폴더 삭제
   • Gradle 프로젝트: out 폴더 삭제
3. 프로젝트 다시 빌드
   • IDE에서 Rebuild Project 또는 ./gradlew build, mvn package 명령어 사용

 

📍 Tip

• Bean 이름 중복을 피하려면 패키지 구조를 체계적으로 관리하고, @Component, @Service, @Repository 등의 Bean 이름을 명시적으로 설정하는 것이 좋음