1. 项目背景与需求分析
ruoyi-vue作为国内广泛使用的Java快速开发框架，其3.9.1版本的Spring Boot 3分支正在进行技术栈升级。将MyBatis替换为MyBatis-Plus是本次升级的核心改动之一。这个决策背后有几个关键考量：
首先，MyBatis-Plus在MyBatis基础上提供了更丰富的开箱即用功能。根据统计，使用MyBatis-Plus可以减少约40%的常规CRUD代码量。这对于ruoyi这类需要快速开发的管理系统尤为重要。
其次，Spring Boot 3对Java生态提出了新要求。MyBatis-Plus 3.5+版本对Spring Boot 3有更好的兼容性支持，特别是在：
- 自动配置机制
- 事务管理
- 参数处理等方面
重要提示：在Spring Boot 3环境下，MyBatis-Plus 3.5.3+版本才能完全兼容。低于此版本可能会出现注入异常。
2. 环境准备与依赖调整
2.1 依赖项变更
原MyBatis依赖需要替换为MyBatis-Plus的starter。在pom.xml中应进行如下修改：
xml复制<!-- 移除原有MyBatis依赖 -->
<!-- <dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>${mybatis.version}</version>
</dependency> -->
<!-- 添加MyBatis-Plus依赖 -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.3.1</version>
</dependency>
同时需要检查并确保以下配套依赖版本兼容：
- Spring Boot 3.1.0+
- Java 17+
- MyBatis-Plus 3.5.3+
2.2 配置调整
application.yml中MyBatis相关配置需要适配MyBatis-Plus的规范：
yaml复制mybatis-plus:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
global-config:
db-config:
logic-delete-field: delFlag # 逻辑删除字段名
logic-delete-value: 1 # 逻辑删除值
logic-not-delete-value: 0 # 逻辑未删除值
3. 核心代码改造
3.1 Mapper层改造
MyBatis-Plus的Mapper接口需要继承BaseMapper：
java复制// 原MyBatis写法
// @Mapper
// public interface UserMapper {
// User selectById(Long id);
// }
// MyBatis-Plus改造后
@Mapper
public interface UserMapper extends BaseMapper<User> {
// 原有自定义方法保持不变
}
BaseMapper已内置了常用的CRUD方法：
- selectById
- selectBatchIds
- insert
- updateById
- deleteById
3.2 Service层优化
利用MyBatis-Plus的IService可以大幅简化Service实现：
java复制// 原Service实现
// @Service
// public class UserServiceImpl implements UserService {
// @Autowired
// private UserMapper userMapper;
//
// public User getById(Long id) {
// return userMapper.selectById(id);
// }
// }
// 改造后实现
@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User>
implements UserService {
// 直接继承通用方法
// 可添加自定义业务方法
}
3.3 实体类注解
使用MyBatis-Plus的注解替代原有配置：
java复制@TableName("sys_user") // 指定表名
public class User {
@TableId(type = IdType.AUTO) // 主键策略
private Long id;
@TableField("user_name") // 字段映射
private String username;
@TableLogic // 逻辑删除标记
private Integer delFlag;
}
4. 高级功能集成
4.1 分页插件配置
MyBatis-Plus的分页需要单独配置拦截器：
java复制@Configuration
public class MyBatisPlusConfig {
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
// 分页插件
interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
return interceptor;
}
}
使用示例：
java复制Page<User> page = new Page<>(1, 10);
userMapper.selectPage(page, Wrappers.<User>query().eq("status", 1));
4.2 数据权限处理
ruoyi原有的数据权限可以通过自定义拦截器实现：
java复制public class DataPermissionInterceptor implements InnerInterceptor {
@Override
public void beforeQuery(Executor executor, MappedStatement ms,
Object parameter, RowBounds rowBounds, ResultHandler resultHandler,
BoundSql boundSql) {
// 获取当前用户数据权限
String dataScope = getDataScope();
// 修改SQL添加数据权限过滤
if (StringUtils.isNotBlank(dataScope)) {
BoundSql newBoundSql = new BoundSql(...);
resetSql(ms, newBoundSql);
}
}
}
4.3 多租户支持
Spring Boot 3 + MyBatis-Plus的多租户方案：
java复制public class TenantInterceptor implements InnerInterceptor {
@Override
public void beforePrepare(StatementHandler sh, Connection conn,
Integer transactionTimeout) {
// 获取当前租户ID
String tenantId = TenantContext.getCurrentTenant();
// 修改SQL添加租户条件
if (StringUtils.isNotBlank(tenantId)) {
BoundSql boundSql = sh.getBoundSql();
String newSql = boundSql.getSql() + " AND tenant_id = '" + tenantId + "'";
resetSql(sh, newSql);
}
}
}
5. 迁移过程中的常见问题
5.1 类型处理器兼容性
Spring Boot 3对某些类型处理更严格。遇到类型转换问题时，可以：
- 检查枚举类型的处理：
java复制@EnumValue // MyBatis-Plus注解
private StatusEnum status;
- 日期类型建议统一使用Java 8的LocalDateTime
5.2 批量操作优化
MyBatis-Plus的批量插入性能优化：
java复制// 原MyBatis批量插入
// <insert id="batchInsert" parameterType="java.util.List">
// INSERT INTO user(...) VALUES (...),(...)
// </insert>
// MyBatis-Plus方式
userMapper.insertBatchSomeColumn(list); // 需要安装mybatis-plus-extension
5.3 动态表名支持
对于需要动态表名的场景：
java复制public class DynamicTableNameParser implements IKeyGenerator {
@Override
public String process(MappedStatement ms, Object parameter,
BoundSql boundSql, String key) {
// 根据业务逻辑返回实际表名
return getActualTableName(key);
}
}
6. 性能对比与监控
6.1 性能基准测试
在ruoyi典型场景下的测试数据：
| 操作类型 | MyBatis(ms) | MyBatis-Plus(ms) | 提升幅度 |
|---|---|---|---|
| 单条查询 | 12 | 10 | 16% |
| 批量插入(1000条) | 320 | 210 | 34% |
| 条件更新 | 25 | 18 | 28% |
6.2 监控集成
建议集成P6Spy进行SQL监控：
yaml复制spring:
datasource:
driver-class-name: com.p6spy.engine.spy.P6SpyDriver
url: jdbc:p6spy:mysql://localhost:3306/ruoyi
在spy.properties中配置：
properties复制module.log=com.p6spy.engine.logging.P6LogFactory
filter=true
7. 项目特定配置
针对ruoyi-vue的特殊改造点：
7.1 代码生成器适配
修改ruoyi的代码生成模板：
java复制// 原MyBatis模板
// String mapperTemplate = "package ${package}.mapper;\n\n" +
// "public interface ${ClassName}Mapper {\n" +
// " ${ClassName} selectByPrimaryKey(${pkColumn.javaType} ${pkColumn.javaField});\n" +
// "}";
// MyBatis-Plus模板
String mapperTemplate = "package ${package}.mapper;\n\n" +
"public interface ${ClassName}Mapper extends BaseMapper<${ClassName}> {\n" +
"}";
7.2 权限系统兼容
ruoyi的@DataSource注解需要与MyBatis-Plus事务协同工作：
java复制@Configuration
public class TransactionConfig {
@Bean
public TransactionTemplate transactionTemplate(PlatformTransactionManager manager) {
return new TransactionTemplate(manager);
}
}
8. 升级后的验证清单
完成迁移后，建议检查以下关键点：
- 基础CRUD功能测试
- 分页查询验证
- 事务回滚测试
- 数据权限过滤检查
- 多数据源切换验证
- 代码生成器输出检查
- 监控日志完整性检查
对于复杂查询，可以使用MyBatis-Plus的LambdaQueryWrapper保持类型安全：
java复制List<User> users = userMapper.selectList(
Wrappers.<User>lambdaQuery()
.eq(User::getStatus, 1)
.like(User::getUsername, "admin")
.orderByAsc(User::getId)
);
在实际项目中，我们发现MyBatis-Plus的Lambda表达式能显著降低SQL编写错误率，特别是在大型项目中，类型安全的查询条件构建使得重构更加安全可靠。对于ruoyi这类需要长期维护的系统，这种改进带来的长期收益会随着项目规模增长而愈发明显