mybatis和mybatis-plus版本对照表

### MyBatis 与 MyBatis-Plus 兼容性版本对照表 MyBatis-Plus 是基于 MyBatis 框架构建的一个增强工具，因此其运行依赖于 MyBatis 的核心功能。为了确保项目的正常运行，在选择 MyBatis 和 MyBatis-Plus 的版本时需要注意两者的兼容性关系。以下是常见的版本对照表： | **MyBatis 版本** | **MyBatis-Plus 版本** | **适用场景/备注** | |-------------------|------------------------|----------------------------------------------------------------------------------| | ≥3.5.x | ≥3.4.0 | 支持 Spring Boot 2.x 及以上版本[^1] | | ≥3.5.x | ≥3.5.5 | 针对 Spring Boot 3.2+ 进行优化，解决部分兼容性问题[^5] | | ≤3.4.x | ≤3.3.1 | 主要用于较老项目迁移或维护，不推荐新项目使用 | #### 如何配置 MyBatis-Plus？ 在 Maven 项目中引入 MyBatis-Plus 时，需注意以下事项： 1. 添加 `mybatis-plus-boot-starter` 或其他扩展组件（如 Join 功能）到 `pom.xml` 文件中。 2. 使用的版本号应根据上述表格中的建议进行调整。 示例代码如下： ```xml <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>最新稳定版</version> </dependency> ``` 对于特定的功能需求（如联表查询），还需额外引入相关依赖[^2]: ```xml <dependency> <groupId>com.github.bobo667</groupId> <artifactId>mybatis-plus-join-boot-starter</artifactId> <version>最新版本号</version> </dependency> ``` #### 注意事项 当升级至更高版本（如 Spring Boot 3.2+）时，可能遇到一些兼容性问题。例如，某些属性类型的值无效等问题可以通过更新配套库来解决，具体参见避坑指南。 ---

<think>好的，用户现在问的是mybatis-plus-boot-starter里哪个版本包含TableNameHandler。首先，我需要回忆之前对话中提到的信息。之前用户询问了TableNameHandler属于哪个包，我告诉他是MyBatis-Plus 3.4.0及以上版本引入的，并且属于com.baomidou.mybatisplus.extension.plugins.handler包。 现在用户的问题转向了具体的starter版本，也就是mybatis-plus-boot-starter。这时候我需要确定这个starter的版本与MyBatis-Plus核心库版本的关系。因为starter通常和核心库的版本是同步的，比如mybatis-plus-boot-starter 3.4.0对应MyBatis-Plus 3.4.0。 首先，我需要确认TableNameHandler是在MyBatis-Plus 3.4.0加入的，所以对应的starter版本应该也是从3.4.0开始包含这个类。用户可能是在寻找他们项目中使用哪个版本的starter才能使用TableNameHandler功能，或者他们可能遇到了版本不兼容的问题，比如使用了旧版本的starter导致找不到这个类。 接下来，我需要检查是否有任何例外情况，比如某些starter版本可能没有包含对应的类，但通常starter会包含核心库的所有功能。不过为了准确性，可能需要查阅官方文档或者版本发布说明来确认。比如查看3.4.0版本的发布说明，是否有提到动态表名处理相关的更新。 另外，用户可能需要知道如何正确引入这个starter版本，比如Maven或Gradle的依赖配置。同时，提醒用户注意版本兼容性，特别是Spring Boot的版本是否与MyBatis-Plus的starter兼容。例如，MyBatis-Plus 3.4.0可能需要Spring Boot 2.x，而如果用户使用的是Spring Boot 3.x，可能需要更高版本的MyBatis-Plus。 用户可能的需求是希望在自己的项目中实现动态表名切换，例如分表或多租户场景，所以需要确保他们使用的starter版本支持这个功能。同时，用户可能在升级过程中遇到问题，需要知道最低需要的版本号。 最后，总结回答时要明确说明starter版本与核心版本的关系，给出具体的版本号，并建议用户使用推荐的稳定版本，比如3.5.3以上，同时提供依赖配置示例和注意事项，确保用户能够顺利应用。</think>在 MyBatis-Plus 的 Spring Boot Starter 中，`TableNameHandler` 最早出现在 **3.4.0 版本**中。以下是版本对应关系： --- ### 版本对照表 | mybatis-plus-boot-starter 版本 | MyBatis-Plus 核心版本 | 包含 TableNameHandler | |------------------------------|---------------------|---------------------| | **3.4.0** | 3.4.0 | ✅ | | **3.5.0 ~ 最新版** | 3.5.0+ | ✅ | --- ### 推荐版本 建议使用 **3.5.3+**（最新稳定版），修复了早期动态表名的部分边界问题： ```xml <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.6</version> <!-- 2024年最新版 --> </dependency> ``` --- ### 验证方式 若已引入依赖，可通过以下步骤确认是否包含该接口： 1. 查看 `pom.xml` 或 `build.gradle` 中 `mybatis-plus-boot-starter` 版本号 2. 检查依赖树中 `mybatis-plus-core` 版本是否为 3.4.0+ ```bash mvn dependency:tree | grep mybatis-plus-core ``` --- ### 重要说明 1. **版本升级注意**：从 3.4.x 升级到 3.5.x 时，动态表名配置方式有变化： ```java // 3.5.x 新配置方式 @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new DynamicTableNameInnerInterceptor()); return interceptor; } ``` 2. **Spring Boot 兼容性**： - MyBatis-Plus 3.4.x → Spring Boot 2.x - MyBatis-Plus 3.5.x → Spring Boot 2.x/3.x --- 如果遇到 `ClassNotFoundException: TableNameHandler`，大概率是版本低于 3.4.0 导致。