[Spring] Parameter 0 of constructor in xxx required a bean of type 'xxx' that could not be found.

문제 상황

1년전에 만들고 쳐다도 안본 프로젝트를 리팩토링하려고 베이스 패키지를 수정하다가

 

Parameter 0 of constructor in com.seungwook.r2r.service.IngredientService required a bean of type 'com.seungwook.r2r.repository.IngredientRepository' that could not be found.

 

이 오류를 만나게 되었다.

기존 패키지 구조는 com.receipt2recipe 에서 com.seungwook.r2r로 바꾸었더니 "IngredientService는 IngredientRepository가 필요한데 못찾겠다." 라고 오류를 뿜고있었고, IngredientRepository는 분명히 존재하고 패키지 경로도 올바르게 설정했는데 이렇게 오류가 발생하고 있었다.

 

컨트롤러, 서비스, 도메인 클래스 등은 잘 인식이 되는 것으로 보아 리포지토리 인터페이스를 스프링이 감지하지 못하는 것으로 추정하였다.

 

삽질 시작

@SpringBootApplication

이 애노테이션이 있는 위치(main 메서드가 있는 클래스 위치)가 src 폴더 최상위에 분명히 위치함을 확인했는데도 이런 오류가 발생했다.

@SpringBootApplication 어노테이션은 자동으로 @ComponentScan을 포함하는데, 이 Component Scan의 기본 범위는 해당 클래스가 속한 패키지와 그 하위 패키지다.

즉, Receipt2Recipe 클래스가 com.seungwook.r2r에 있어야만 com.seungwook.r2r.repository.IngredientRepository를 스캔할 수 있다.

-> 문제 없음

 

 

Spring Boot 3.x에서는 패키지 이름에 숫자가 들어간 경우,
Spring의 컴포넌트 스캔이 내부적으로 repository path를 제대로 파싱하지 못하는 버그성 이슈가 실제로 존재한다.

특히 Spring Boot 3.2.x + Java 17 환경에서 다음 조건을 만족하면 자동 스캔이 실패할 수 있다

-> 스프링 부트를 3.4.4 버전으로 업그레이드 했음에도 동일한 현상이 발생함

 

 

문제 해결

@EnableJpaRepositories 애노테이션으로 문제를 해결할 수 있었다.

@EnableJpaRepositories는 JPA 레포지토리를 스프링 빈으로 등록하는 역할을 하며, 보통 @SpringBootApplication 또는 설정 클래스 위에 붙여서 사용한다.

이 애노테이션은 리포지토리가 베이스 패키지 바깥에 있을때 사용하는 애노테이션인데 내 프로젝트는 리포지토리가 베이스 패키지 밖에 있지 않음에도 이 애노테이션을 왜 붙혀야하는지는 아직 파악하지 못했다.

@EnableJpaRepositories("com.seungwook.r2r.repository")
@SpringBootApplication
public class Receipt2Recipe {
	public static void main(String[] args) {
		SpringApplication.run(Receipt2Recipe.class, args);
	}

}