mybatis-spring-boot-starter报错

### 解决方案 在使用 `mybatis-spring-boot-starter` 时，报错问题通常与依赖版本不匹配或配置错误有关。以下是一些可能的解决方案： #### 1. 检查 Spring Boot 和 MyBatis 版本兼容性 确保 `spring-boot-starter-parent` 和 `mybatis-spring-boot-starter` 的版本兼容。例如，在引用中提到，当 `spring-boot-starter-parent` 的版本为 `3.4.3` 时，`mybatis-spring-boot-starter` 的版本需要升级到 `3.0.3`[^2]。如果版本不匹配，可能会导致类似 `Invalid bean definition with name 'userMapper'` 的错误。 #### 2. 配置文件检查 确认 `application.properties` 或 `application.yml` 文件中的 MyBatis 配置是否正确。例如，确保以下配置项存在并正确设置： ```properties mybatis.mapper-locations=classpath:mapper/*.xml mybatis.type-aliases-package=com.example.domain ``` 上述配置指定了 Mapper 文件的位置和实体类的包路径。如果这些路径不正确，可能导致 Bean 定义无效的问题。 #### 3. 排查冲突依赖 如果项目中同时引入了 `mybatis-spring-boot-starter` 和其他类似的依赖（如 `mybatis-plus-spring-boot-starter`），可能会导致冲突。例如，引用中提到两者可能存在冲突[^1]。解决方法是明确排除不需要的依赖，或者调整依赖的加载顺序。 #### 4. 使用正确的 Mapper 注解 确保所有的 Mapper 接口都正确使用了 `@Mapper` 注解，并且在 Spring Boot 启动类上添加了 `@MapperScan` 注解。例如： ```java @Mapper public interface UserMapper { // 方法定义 } ``` ```java @SpringBootApplication @MapperScan("com.example.mapper") public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` #### 5. 检查 Bean 定义类型 根据引用内容，错误信息显示 `Invalid value type for attribute 'factoryBeanObjectType': java.lang.String`[^2]。这表明 MyBatis 在解析 Mapper 时，可能将 Bean 类型错误地识别为 `String`。可以通过以下方式排查： - 确保 Mapper 接口的方法签名与 XML 文件中的 SQL 定义一致。 - 检查 XML 文件路径是否正确，并确保其能够被正确加载。 #### 示例代码 以下是一个完整的 Maven 配置示例，展示了如何正确引入依赖并配置版本： ```xml <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>3.4.3</version> <relativePath/> </parent> <dependencies> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>3.0.3</version> </dependency> </dependencies> ``` ### 注意事项 - 如果问题仍然存在，可以尝试清理项目缓存并重新构建： ```bash mvn clean install ``` - 确保 IDE 的自动导入功能未引入多余的依赖。