# Spring Boot 3.5.5 + MyBatis 사용 시 factoryBeanObjectType 에러 해결

1. 발생한 에러

Spring Boot 3.5.5 프로젝트 실행 시 다음과 같은 에러가 발생했다.

org.springframework.beans.factory.BeanDefinitionStoreException: 
Invalid bean definition with name 'memberMapper' 
Invalid value type for attribute 'factoryBeanObjectType': java.lang.String

 

@mapper도 넣고 @mapperscan도 넣어봤지만 아무 소용 없었다.

결국 버전문제..

 

2. 원인 분석

프로젝트의 build.gradle을 보면 MyBatis Starter 버전이 다음과 같았다.

implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.1'

문제는 Spring Boot 버전과의 `호환성`이다.

• 3.0.1 버전은 Spring Boot 3.0 ~ 3.4 범위에 최적화됨
• 현재 프로젝트는 Spring Boot 3.5.5 → 최신 버전과 맞지 않아 Bean 등록 과정에서 충돌 발생

3. 버전 호환표

공식 문서 기준으로 정리한 Spring Boot ↔ MyBatis Starter 호환 관계는 다음과 같다.

Mybatis Spring Boot Starter	호환 Spring Boot 버전
2.3.x ~ 2.4.x	Spring Boot 2.3 ~ 2.7
3.0.x (3.0.0 ~ 3.0.4)	Spring Boot 3.0 ~ 3.4
3.1.x	Spring Boot 3.1.x
3.2.x	Spring Boot 3.2.x
3.3.x 이상	Spring Boot 3.3 이상 (최신)

👉 따라서 Spring Boot 3.5.5 환경에서는 3.0.4 이상의 버전을 사용하는 것이 안정적이다.

---

4. 해결 방법

MyBatis Starter 버전을 최신 안정 버전(3.0.4)으로 올리면 해결된다.

dependencies {
    implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.4'
}

그리고 `gradle clean build` 후 다시 실행하면 정상 동작한다.

 

5.추가 권장 설정

Application.java에 @MapperScan을 추가하면 Mapper 스캔이 더 명확해진다.

@SpringBootApplication
@MapperScan("org.example.weeks.member.mapper")
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

6. 정리

• 에러 메시지: factoryBeanObjectType invalid (String 타입 문제)
• 원인: MyBatis Starter 버전과 Spring Boot 3.5.5의 호환성 불일치
• 해결: mybatis-spring-boot-starter:3.0.4로 업그레이드

👉 결론: Spring Boot 버전을 올리면 MyBatis Starter도 반드시 최신 버전으로 맞춰줘야 한다.