当前位置：首页 > news >正文

MybatisPlus批量插入saveBatch不生效？别急，先检查你的spring.datasource.url里有没有这个参数

news 2026/6/15 5:40:04

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; // 默认状态为0

4. 完整配置检查清单

为确保批量插入正常工作，建议按照以下清单逐一检查：

数据库连接配置
- 确认JDBC URL包含rewriteBatchedStatements=true
- 推荐配置：jdbc:mysql://host:port/db?useSSL=false&rewriteBatchedStatements=true&serverTimezone=Asia/Shanghai
实体类检查
- 所有非自动填充字段必须非null
- 使用@TableField注解明确字段策略
- 自增主键使用@TableId(type = IdType.AUTO)
批量操作参数
- 适当设置batchSize（默认1000）
- 示例：saveBatch(list, 500)// 每500条提交一次
日志验证
- 开启MySQL查询日志：general_log = ON
- 或使用Druid等连接池的SQL监控功能