트러블슈팅: redisson-spring-boot-starter Spring Boot 4.x 호환성 오류

상황

빌드 실패 

오류 메시지

java.lang.IllegalStateException: Failed to generate bean name for imported class
'org.redisson.spring.starter.RedissonAutoConfigurationV2'

Caused by: java.lang.ClassNotFoundException:
org.springframework.boot.autoconfigure.data.redis.RedisAutoConfiguration

원인 분석

redisson-spring-boot-starter 3.x는 Spring Boot 3.x 기준으로 작성된 라이브러리다. 내부적으로org.springframework.boot.autoconfigure.data.redis.RedisAutoConfiguration 클래스를 참조한다.

이 클래스는 Spring Boot 4.x에서 패키지 구조가 변경되면서 해당 경로에 존재하지 않게 됐다. 결과적으로 애플리케이션 컨텍스트 로드 시점에 클래스를 찾지 못해 기동이 실패한다.

 

해결 방법

Spring Boot 4.x 지원은 redisson-spring-boot-starter 4.0.0부터 추가됐다. build.gradle의 의존성 버전을 아래와 같이 변경한다.

// 변경 전
implementation 'org.redisson:redisson-spring-boot-starter:3.27.2'

// 변경 후
implementation 'org.redisson:redisson-spring-boot-starter:4.3.0'

결과

에러 해결

인사이트

• 서드파티 라이브러리를 추가할 때는 사용 중인 Spring Boot 버전과의 호환성을 먼저 확인해야 한다.
• Spring Boot 4.x는 Spring Framework 7.x 기반으로 내부 패키지 구조가 3.x와 다르기 때문에, 3.x 기준으로 작성된 라이브러리는 호환되지 않는 경우가 있다.