MyBatis依赖导入后包无法解析？问题排查与解决方案求助

一、先解决当前导入报错问题 #

首先看你的导入语句：

import org.apache.ibas.annotations.Mapper

这里存在明显拼写错误，ibas应为ibatis，正确导入语句是：

import org.apache.ibatis.annotations.Mapper;

如果修正拼写后仍报错，按以下步骤排查：

• 检查mybatis-spring-boot-starter是否指定版本号，Spring Boot项目中若未指定版本，需确保父pom已管理MyBatis版本，或手动添加适配你Spring Boot版本的Starter版本：

<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <!-- 示例版本，替换为适配你Spring Boot的版本，如2.3.0 -->
    <version>2.3.0</version>
</dependency>

• 执行Maven强制更新依赖命令：mvn clean install -U，-U参数会强制刷新快照依赖
• 在IDEA中点击右侧Maven面板的「Reload All Maven Projects」按钮，或使用快捷键Ctrl+Shift+O（Windows/Linux）/Cmd+Shift+O（Mac）重新导入依赖

二、mybatis-spring-boot-starter与ibatis-core的区别 #

1. 定位与用途差异

   • mybatis-spring-boot-starter是MyBatis官方提供的Spring Boot整合启动器，已整合MyBatis核心包、MyBatis-Spring适配包，还自动配置了SqlSessionFactory、MapperScannerConfigurer等核心组件，能让你在Spring Boot项目中快速启用MyBatis，无需手动编写大量配置。
   • ibatis-core是MyBatis前身iBatis的核心包，iBatis在3.x版本后更名为MyBatis，ibatis-core:3.0属于早期MyBatis核心包，未做任何Spring Boot整合，所有MyBatis组件都需手动配置，且版本老旧。

2. 依赖结构差异

   • mybatis-spring-boot-starter的依赖树包含mybatis（核心）、mybatis-spring（Spring适配）、Spring Boot自动配置模块，是一套完整的Spring Boot集成方案。
   • ibatis-core仅包含早期MyBatis核心功能，无任何Spring相关适配，单独导入无法与Spring Boot无缝集成，这也是你导入后出现其他错误的核心原因。

3. 维护状态差异

   • mybatis-spring-boot-starter由MyBatis官方持续维护，会跟随Spring Boot版本更新，修复bug并添加新特性。
   • ibatis-core早已停止维护，版本停留在3.0，后续MyBatis版本均以mybatis作为artifactId，不再使用ibatis-core。

三、导入ibatis-core后报错的解决 #

ibatis-core:3.0与当前Spring Boot版本完全不兼容，且无Spring集成支持，会导致配置类缺失、组件无法注入等各类错误。解决方法是立即移除ibatis-core依赖，改用适配你Spring Boot版本的mybatis-spring-boot-starter。

内容的提问来源于stack exchange，提问作者90_nk