Spring Boot 3.x 与 MyBatis-Plus 兼容问题笔记

Spring Boot 3.x 与 MyBatis-Plus 兼容问题笔记问题场景Spring Boot 3.2 版本使用 MyBatis-Plus 时出现Invalid value type等类型不匹配/依赖冲突报错核心原因是MyBatis-Plus 旧版本与 Spring Boot 3.x 不兼容。解决方案两种方案二选一方案一直接使用 Spring Boot 3 专属 Starter推荐直接替换为 MyBatis-Plus 官方适配 Spring Boot 3 的依赖包无需额外排除依赖。dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-spring-boot3-starter/artifactId version3.5.5/version !-- 或更新的兼容版本 -- /dependency✅ 优点配置简单、官方适配、无额外冲突风险✅ 适用新项目或可直接升级 MyBatis-Plus 版本的场景方案二手动排除旧依赖 引入兼容版本若暂时无法升级 MyBatis-Plus 版本可手动排除旧版mybatis-spring并引入兼容 Spring Boot 3 的版本。!-- 原有 mybatis-plus-boot-starter -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.4.1/version !-- 排除旧版 mybatis-spring -- exclusions exclusion groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId /exclusion /exclusions /dependency !-- 引入兼容 Spring Boot 3 的 mybatis-spring 版本 -- dependency groupIdorg.mybatis/groupId artifactIdmybatis-spring/artifactId version3.0.3/version !-- 或更高兼容版本 -- /dependency✅ 优点无需升级 MyBatis-Plus 主版本仅替换底层依赖✅ 适用旧项目升级 Spring Boot 3 但 MyBatis-Plus 版本不便变动的场景操作步骤**修改 **pom.xml按上述方案替换/调整 MyBatis-Plus 依赖配置清理并重新构建mvn clean compile -U-U强制更新依赖避免本地缓存问题重启项目启动 Spring Boot 应用验证报错是否消失IDEA 同步在 IDEA 中点击「Reload All Maven Projects」刷新依赖注意事项版本对齐确保mybatis-plus-spring-boot3-starter或mybatis-spring版本与当前 Spring Boot 3.x 版本兼容避免重复依赖不要同时引入mybatis-plus-boot-starter和mybatis-plus-spring-boot3-starter缓存清理若依赖下载失败删除本地 Maven 仓库中对应包目录后重试测试验证修改后需完整测试数据库操作确保 MyBatis-Plus 功能正常核心结论Spring Boot 3.x 必须使用适配 Spring Boot 3 的 MyBatis-Plus 依赖优先选择mybatis-plus-spring-boot3-starter官方原生适配无法升级时手动排除旧版mybatis-spring并引入 3.0.3 兼容版本