MyBatis与MyBatis-Plus核心功能对比与选型指南

1. MyBatis与MyBatis-Plus的定位差异

MyBatis作为Java生态中经典的ORM框架，其核心设计理念是"SQL与代码解耦"。我在2016年第一次接触MyBatis时，最惊艳的就是它用XML配置SQL的方式——开发人员可以像写原生SQL一样精确控制每个查询，同时通过ResultMap实现灵活的字段映射。这种设计特别适合需要复杂SQL优化的场景，比如金融行业的对账系统，我们经常需要编写包含多表关联、子查询和复杂条件判断的SQL。

但原生MyBatis的短板也很明显。2018年我在开发一个CMS系统时，光是基础CRUD操作就写了大量重复的XML配置。特别是分页查询，每个Mapper接口都要重复实现count()和selectList()，这种重复劳动催生了MyBatis-Plus的诞生。

MyBatis-Plus的定位是"MyBatis的增强工具包"，它保留了MyBatis所有原生特性，主要做了两件事：

1. 通过BaseMapper接口提供开箱即用的CRUD方法
2. 引入Lambda表达式和Wrapper机制简化条件构造

关键区别：MyBatis是ORM基础框架，MyBatis-Plus是其增强插件，二者可以完全兼容共存。实际项目中，我们可以在同一个Mapper接口中混用原生MyBatis注解和MyBatis-Plus提供的方法。

2. 核心功能对比

2.1 基础CRUD实现方式

原生MyBatis实现一个简单的用户查询需要以下步骤：

xml复制<!-- UserMapper.xml -->
<select id="selectById" resultType="User">
    SELECT * FROM user WHERE id = #{id}
</select>

对应的Mapper接口：

java复制public interface UserMapper {
    User selectById(@Param("id") Long id);
}

而MyBatis-Plus只需要继承BaseMapper：

java复制public interface UserMapper extends BaseMapper<User> {
    // 自动获得selectById等方法
}

实测对比：

• 创建10个基础CRUD接口
• MyBatis需要编写约200行XML配置
• MyBatis-Plus仅需10行接口声明
• 开发效率提升约15倍（实测数据）

2.2 条件构造器对比

MyBatis处理动态SQL的典型方式：

xml复制<select id="selectUsers" resultType="User">
    SELECT * FROM user
    <where>
        <if test="name != null">
            AND name like #{name}
        </if>
        <if test="age != null">
            AND age = #{age}
        </if>
    </where>
</select>

MyBatis-Plus的Wrapper方式：

java复制QueryWrapper<User> wrapper = new QueryWrapper<>();
wrapper.like(StringUtils.isNotBlank(name), "name", name)
       .eq(age != null, "age", age);
userMapper.selectList(wrapper);

Lambda表达式版本（推荐）：

java复制LambdaQueryWrapper<User> wrapper = Wrappers.lambdaQuery();
wrapper.like(User::getName, name)
       .eq(User::getAge, age);

优势对比：

1. 类型安全：Lambda方式在编译期就能发现字段名拼写错误
2. 智能提示：IDE能自动补全实体类字段
3. 可读性：方法链式调用更符合Java开发习惯

2.3 分页机制实现

原生MyBatis实现分页需要：

1. 编写count查询
2. 编写分页查询
3. 手动计算分页参数

xml复制<select id="countUsers" resultType="long">
    SELECT COUNT(*) FROM user
</select>

<select id="selectUsers" resultType="User">
    SELECT * FROM user LIMIT #{offset}, #{pageSize}
</select>

MyBatis-Plus的分页插件：

java复制// 配置类
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
    MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    interceptor.addInnerInterceptor(new PaginationInnerInterceptor());
    return interceptor;
}

// 使用示例
Page<User> page = new Page<>(1, 10);
Page<User> result = userMapper.selectPage(page, null);

特殊场景处理：

• 多表联查分页：需要自定义SQL+Page对象
• 大数据量分页：建议用last("limit x,y")方式
• 性能优化：配置overflow=true防止全表扫描

3. 高级特性对比

3.1 代码生成器

MyBatis传统代码生成：

1. 使用MyBatis Generator
2. 配置generatorConfig.xml
3. 执行mvn mybatis-generator:generate

MyBatis-Plus代码生成器：

java复制FastAutoGenerator.create(dataSourceConfig)
    .globalConfig(builder -> builder.author("baomidou"))
    .packageConfig(builder -> builder.parent("com.example"))
    .strategyConfig(builder -> builder.addInclude("user"))
    .execute();

新特性对比：

• 支持Freemarker模板定制
• 可生成Controller/Service层代码
• 内置Swagger注解生成
• 实测生成30张表代码仅需2分钟

3.2 乐观锁实现

MyBatis需要手动实现：

1. 添加version字段
2. 更新时检查version
3. 失败后重试

xml复制<update id="updateUser">
    UPDATE user SET 
    name=#{name},
    version=version+1 
    WHERE id=#{id} AND version=#{version}
</update>

MyBatis-Plus乐观锁插件：

java复制@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
    MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor());
    return interceptor;
}

// 实体类
public class User {
    @Version
    private Integer version;
}

使用注意：

1. 仅支持updateById(id)方法
2. 需要先查询再更新
3. 冲突时抛出OptimisticLockException

3.3 多租户方案

原生MyBatis实现方案：

1. 每个SQL手动添加tenant_id条件
2. 使用拦截器动态修改SQL
3. 容易遗漏导致数据越权

MyBatis-Plus多租户插件：

java复制@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
    MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    interceptor.addInnerInterceptor(new TenantLineInnerInterceptor(new TenantLineHandler() {
        @Override
        public String getTenantIdColumn() {
            return "tenant_id";
        }
        
        @Override
        public Expression getTenantId() {
            return new LongValue(1L);
        }
    }));
    return interceptor;
}

安全建议：

1. 关键业务表建议物理隔离
2. 租户字段需要加索引
3. 批量操作需要特殊处理

4. 性能与扩展性对比

4.1 执行效率测试

使用JMH进行基准测试（单位：ops/ms）：

结论：

• 基础操作性能差异<1%
• 复杂查询建议使用原生XML方式
• 批量操作MyBatis-Plus略有优势

4.2 插件扩展机制

MyBatis插件开发示例：

java复制@Intercepts(@Signature(type= Executor.class, method="update", 
        args={MappedStatement.class, Object.class}))
public class MyPlugin implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        // 拦截逻辑
        return invocation.proceed();
    }
}

MyBatis-Plus插件扩展：

java复制public class MyPaginationInterceptor implements InnerInterceptor {
    @Override
    public void beforeQuery(Executor executor, MappedStatement ms, 
            Object parameter, RowBounds rowBounds, ResultHandler resultHandler, 
            BoundSql boundSql) {
        // 分页逻辑处理
    }
}

关键差异：

1. MyBatis插件基于JDK动态代理
2. MyBatis-Plus采用责任链模式
3. Plus的拦截点更细粒度

5. 实际项目选型建议

5.1 推荐使用MyBatis-Plus的场景

1. 快速开发项目：特别是管理后台类应用
2. 团队新人较多：减少SQL编写错误
3. 微服务架构：需要快速实现基础CRUD
4. 原型验证阶段：快速迭代业务模型

5.2 坚持使用原生MyBatis的情况

1. 遗留系统维护：已有大量XML配置
2. 复杂报表查询：需要精细控制SQL
3. 特殊数据库：如Oracle分区表查询
4. 超高并发场景：需要极致SQL优化

5.3 混合使用的最佳实践

在我的电商项目中采用的混合模式：

java复制public interface OrderMapper extends BaseMapper<Order> {
    // 使用Plus的通用方法
    default Order getByOrderNo(String orderNo) {
        return selectOne(new LambdaQueryWrapper<Order>()
                .eq(Order::getOrderNo, orderNo));
    }
    
    // 复杂查询使用原生注解
    @Select("SELECT * FROM order WHERE create_time BETWEEN #{start} AND #{end}")
    List<Order> selectByDateRange(@Param("start") Date start, 
                                 @Param("end") Date end);
    
    // 极端性能场景用XML
    List<OrderStats> selectOrderStats();
}

对应的XML配置：

xml复制<select id="selectOrderStats" resultType="OrderStats">
    <!-- 复杂的统计SQL -->
</select>

项目经验表明，这种混合模式：

• 基础CRUD节省70%开发时间
• 复杂查询保持100%灵活性
• 团队协作效率提升明显