MybatisPlus批量插入失效排查指南：从数据库日志到源码解析
最近在项目中使用MybatisPlus的saveBatch方法时，发现数据库日志里依然是单条插入语句，完全没有预期的批量执行效果。这让我意识到，很多开发者可能都遇到过类似问题——明明按照文档配置了批量插入，为什么性能没有提升？本文将带您完整重现这个问题的排查过程，从数据库连接配置到MybatisPlus源码分析，最终找到真正的解决方案。
1. 问题现象与初步排查
当我们在Spring Boot项目中调用saveBatch方法时，期望看到的是类似这样的SQL语句：
INSERT INTO user (name, age) VALUES (?, ?), (?, ?), (?, ?);但实际查看数据库日志，却发现是一连串的单条插入：
INSERT INTO user (name, age) VALUES (?, ?); INSERT INTO user (name, age) VALUES (?, ?); INSERT INTO user (name, age) VALUES (?, ?);这种差异会导致性能上的显著区别。在我的测试中，插入1000条记录时：
| 插入方式 | 耗时(ms) |
|---|---|
| 单条循环插入 | 1200 |
| 真正的批量插入 | 150 |
首先检查的是数据库连接配置。在application.yml中，我们需要确认JDBC URL是否包含关键参数：
spring: datasource: url: jdbc:mysql://localhost:3306/test?useSSL=false&rewriteBatchedStatements=true注意：
rewriteBatchedStatements参数对MySQL批量操作至关重要，它告诉MySQL驱动将多个单条语句重写为真正的批量语法。
2. 深入MybatisPlus批量处理机制
即使配置了正确的连接参数，saveBatch仍然可能回退到单条插入。这需要我们理解MybatisPlus内部的批量处理逻辑。通过阅读源码，可以发现SqlHelper类的executeBatch方法中有这样一段判断逻辑：
if (parameterObj instanceof Map) { Map<?, ?> map = (Map<?, ?>) parameterObj; if (CollectionUtils.isEmpty(map) || map.values().stream().anyMatch(Objects::isNull)) { return false; } }这意味着：
- 如果实体对象中有任何字段为null，MybatisPlus会主动回退到单条插入
- 即使数据库表字段允许NULL，或者设置了默认值，这个检查依然会生效
在实际项目中，常见的null值场景包括：
- 未显式设置创建时间、更新时间等字段
- 逻辑删除标记字段未初始化
- 某些可选字段故意留空
3. 字段处理策略的三种解决方案
针对字段可能为null的情况，MybatisPlus提供了几种处理方式：
3.1 自动填充策略
对于创建时间、更新时间等系统字段，可以使用@TableField注解的fill属性：
@TableField(fill = FieldFill.INSERT) private LocalDateTime createTime; @TableField(fill = FieldFill.INSERT_UPDATE) private LocalDateTime updateTime;然后实现MetaObjectHandler接口：
@Component public class MyMetaObjectHandler implements MetaObjectHandler { @Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now()); } @Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now()); } }3.2 字段忽略策略
对于确实需要保留null值的字段，可以使用insertStrategy：
@TableField(insertStrategy = FieldStrategy.IGNORED) private String optionalField;3.3 默认值设置
在实体类构造函数或字段声明中设置默认值：
private Integer status = 0; // 默认状态为04. 完整配置检查清单
为确保批量插入正常工作，建议按照以下清单逐一检查：
数据库连接配置
- 确认JDBC URL包含
rewriteBatchedStatements=true - 推荐配置：
jdbc:mysql://host:port/db?useSSL=false&rewriteBatchedStatements=true&serverTimezone=Asia/Shanghai
- 确认JDBC URL包含
实体类检查
- 所有非自动填充字段必须非null
- 使用
@TableField注解明确字段策略 - 自增主键使用
@TableId(type = IdType.AUTO)
批量操作参数
- 适当设置batchSize（默认1000）
- 示例：
saveBatch(list, 500)// 每500条提交一次
日志验证
- 开启MySQL查询日志：
general_log = ON - 或使用Druid等连接池的SQL监控功能
- 开启MySQL查询日志：
5. 性能对比与最佳实践
在不同数据量下，批量插入与单条插入的性能差异非常明显：
| 记录数 | 单条插入(ms) | 批量插入(ms) | 性能提升 |
|---|---|---|---|
| 100 | 120 | 30 | 4x |
| 1,000 | 1,100 | 80 | 13x |
| 10,000 | 11,200 | 650 | 17x |
基于项目经验，我总结了几点最佳实践：
- 批量操作前先做数据清洗，确保无null值
- 根据服务器内存合理设置batchSize（通常500-2000）
- 大批量导入考虑使用MybatisPlus的
saveBatch配合事务分批提交 - 生产环境务必监控批量操作的执行时间和内存使用
在一次数据迁移项目中，通过正确配置rewriteBatchedStatements和处理好实体字段，我们将50万条记录的导入时间从15分钟缩短到了45秒。这种性能提升在数据处理密集型应用中非常可观。
