跳到主要内容

MyBatisGX 批量操作:比 MyBatis-Plus 和 MyBatis-Flex 更好用、更快

· 阅读需 6 分钟

一、批量操作本该很简单​

项目里批量操作场景太常见了:

  • 导入 Excel 数据
  • 同步第三方接口数据
  • 定时任务批量落库
  • 状态批量更新

但翻开不同框架的文档,你会发现:这么基础的能力,复杂度差了好几档。


二、各框架是怎么写批量的​

先看代码,直接感受差距。

原生 MyBatis​

原生 MyBatis 要用真正的 JDBC batch,需要手动打开 ExecutorType.BATCH 的 Session,自己管理生命周期:

// Mapper 接口(单条插入)
void insert(User user);
// 调用方:手动管理 BatchSession
SqlSession sqlSession = sqlSessionFactory.openSession(ExecutorType.BATCH, false);
try {
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
for (int i = 0; i < users.size(); i++) {
mapper.insert(users.get(i));
if ((i + 1) % 1000 == 0 || (i + 1) == users.size()) {
sqlSession.flushStatements(); // 手动 flush
}
}
sqlSession.commit();
} catch (Exception e) {
sqlSession.rollback();
throw e;
} finally {
sqlSession.close();
}

每次批量操作都要写这一套模板代码,容易遗漏 flush,也容易忘关 Session。

MyBatis-Plus​

批量操作在 IService 里,不在 Mapper 里。必须让 ServiceImpl 继承 ServiceImpl<Mapper, Entity>:

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {

public void importUsers(List<User> users) {
this.saveBatch(users, 500); // 只能通过 IService 的方法调
}
}

必须先有 Service 层、必须继承 ServiceImpl,DAO 层没有批量能力。

MyBatis-Flex​

BaseMapper 有个 insertBatch 方法,但它是 MyBatis for 循环,不是真正的 JDBC batch 协议。

真正的批量写法要用 Db.executeBatch:

Db.executeBatch(users, 1000, UserMapper.class, (mapper, user) -> mapper.insert(user));

能用,但 lambda + 类型 + 回调,写法比较重。

MyBatisGX​

userDao.insertBatch(list);
userDao.updateBatchById(list);
userDao.deleteBatchById(ids);

直接调 DAO,不需要继承任何东西,不需要任何工具类。


对比一下:

框架调用方式额外负担SQL 生成时机真 JDBC batch
原生 MyBatis手动 BatchSession手动管理 Session 生命周期手写是
MyBatis-PlusIService.saveBatch必须继承 ServiceImpl运行时是
MyBatis-FlexDb.executeBatchlambda + 类型 + 回调运行时是
MyBatisGXdao.insertBatch无启动期预生成是

三、为什么坚持这种设计​

DAO 是唯一入口​

批量操作本质上是数据访问层的能力。它不应该扩散到:

  • Service 层(MyBatis-Plus 的路子)
  • 全局静态 Db 工具(MyBatis-Flex 的路子)
  • 手动管理的 BatchSession(原生 MyBatis)

让它待在它该在的位置。

语义要直白​

insertBatch     = 批量插入
updateBatchById = 按主键批量更新
deleteBatchById = 按主键批量删除

方法名就是含义,不需要查文档。

分批大小可控​

默认 batchSize=1000,可以自己传:

userDao.insertBatch(list, 500);   // 每 500 条提交一次

不用担心数据量大了撑爆内存。


四、性能不打折​

先说结论:

批量插入:MyBatisGX ≈ 原生 MyBatis,比 Flex 快约 14%,比 Plus 快约 25%。 批量更新:MyBatisGX 与 Flex 差距约 5%,均优于 Plus。

测试环境:JVM -Xms1g -Xmx4g,单条记录约 10 个字段,每框架跑 15 次,去掉第 1 次冷启动取稳定区间。

批量插入 100 条​

框架稳定区间均值
MyBatisGX7ms ~ 17ms~10ms
原生 MyBatis6ms ~ 19ms~10ms
MyBatis-Flex10ms ~ 32ms~19ms
MyBatis-Plus10ms ~ 30ms~18ms

批量插入 1W 条​

框架稳定区间均值
MyBatisGX264ms ~ 409ms~320ms
原生 MyBatis239ms ~ 459ms~290ms
MyBatis-Flex293ms ~ 580ms~370ms
MyBatis-Plus350ms ~ 686ms~430ms

1W 条批量插入,MyBatisGX 比 MyBatis-Plus 快约 25%,比 MyBatis-Flex 快约 14%。

批量更新 100 条​

框架稳定区间均值
原生 MyBatis12ms ~ 25ms~16ms
MyBatisGX16ms ~ 28ms~20ms
MyBatis-Flex18ms ~ 29ms~23ms
MyBatis-Plus19ms ~ 31ms~25ms

批量更新 1W 条​

框架稳定区间均值
原生 MyBatis1294ms ~ 1618ms~1450ms
MyBatis-Flex1397ms ~ 1674ms~1560ms
MyBatisGX1423ms ~ 1855ms~1640ms
MyBatis-Plus1497ms ~ 1965ms~1720ms

批量更新 1W 条,MyBatisGX 与 Flex 差距约 80ms(约 5%),原生 MyBatis 最快。

为什么批量插入能做到这个性能?​

MyBatisGX 的批量操作本质上仍然是:

  • JDBC batch 协议(addBatch + executeBatch)
  • MyBatis BatchExecutor 执行
  • SQL 在启动期预生成,运行时不再拼接
  • 无 persistence context 干预
  • 无反射取字段,无 Lambda 包装

运行时只剩"传参 + 执行"两步,这是批量插入性能贴近原生的根本原因。


五、执行流程​

@startuml
skinparam backgroundColor #FEFEFE
skinparam sequenceArrowThickness 2
title MyBatisGX 批量操作执行流程

actor "Service" as service
participant "DAO\n(insertBatch)" as dao
participant "MybatisgxRoutingExecutor\n(路由执行器)" as routing
participant "MybatisgxBatchExecutor\n(批量执行器)" as batchExec
participant "MyBatis BatchExecutor\n(底层 JDBC Batch)" as mybatis
database "MySQL" as db

note over dao, routing
启动期:SQL 已预生成
运行时:仅传参 + 执行
end note

service -> dao : insertBatch(list, 1000)
dao -> routing : update(MappedStatement, params)
note right of routing
resolveExecutor()
@BatchOperation → getBatch() == true
→ 路由至 batchExecutor
end note
routing -> batchExec : update(ms, params)

loop 遍历 list(共 N 条)
batchExec -> mybatis : delegate.update(ms, item[i])
mybatis -> db : addBatch()
alt 每满 batchSize 条,或到达末尾
batchExec -> mybatis : flushStatements()
mybatis -> db : executeBatch()
batchExec -> mybatis : clearLocalCache()
end
end

batchExec --> service : return N
@enduml

六、写在最后​

批量操作本来就不应该复杂。

它只是数据库最基础的写入方式,却被各框架包装成了"必须先学一套约定"才能调的能力。

MyBatisGX 想做的事情很朴素:

把一个本来应该简单的能力,还原成简单的样子。

调用最短,语义最直,性能不打折。

从命名到约束,从定义到归属,这些追求背后有一个更简单的信念:

Coding 是一种艺术。

好的代码有结构、有表达、有边界。持久层尤其如此——它离数据最近,也最容易成为系统混乱的根源。MyBatisGX 的每一个设计决策,都是在试图让这层代码更像一门手艺,而不是临时凑合。

如果你也在追求代码的清晰与可控

欢迎来试试 MyBatisGX。

也欢迎来挑战我的设计理念。

因为:

技术的进步,来自于不断的质疑和对话。


社区交流​

欢迎交流 MyBatisGX 使用问题、ORM 设计与 SQL 架构实践。

微信:xcc137396549 备注:进 MyBatisGX 群

相关链接​