1. 问题背景与现象分析
在Spring Boot 3.x项目中，我们经常会使用审计字段（如create_time、update_time、create_by、update_by等）来记录数据的变更历史。通过@CreatedDate、@LastModifiedDate等注解配合AuditingEntityListener，可以轻松实现单条记录插入时的自动填充。但实际开发中会发现，当使用批量插入操作时，这些审计字段经常出现未自动填充的情况。
这个问题的本质在于：MyBatis的批量插入机制绕过了JPA的实体生命周期事件。具体表现为：
- 使用SqlSession的BATCH模式时，实体对象不会触发JPA的持久化回调
- MyBatis的foreach批量插入生成的SQL语句不包含审计字段值
- 批量操作时Hibernate的拦截器不会被执行
2. 原理解析与底层机制
2.1 Spring Data审计机制工作原理
Spring Data的审计功能主要通过以下组件协同工作：
@EnableJpaAuditing：启用审计功能AuditingEntityListener：实体监听器AuditorAware：获取当前操作者信息
java复制@EntityListeners(AuditingEntityListener.class)
public class BaseEntity {
@CreatedDate
private LocalDateTime createTime;
@LastModifiedDate
private LocalDateTime updateTime;
}
2.2 MyBatis批量插入的执行流程
当使用MyBatis进行批量插入时，数据流转路径如下：
- 通过SqlSessionFactory创建BATCH模式的SqlSession
- 获取Mapper接口的动态代理实例
- 循环调用Mapper方法生成预处理语句
- 最终通过executeBatch()批量执行
关键问题点：
- 此流程完全绕过了Spring Data的审计处理管道
- 批量操作不会触发EntityManager的persist()方法
- 没有经过Hibernate的事件监听体系
3. 解决方案与实现细节
3.1 方案一：手动填充审计字段（推荐）
在业务代码中显式设置审计字段值：
java复制public void batchInsert(List<User> users) {
String currentUser = SecurityContextHolder.getContext().getAuthentication().getName();
LocalDateTime now = LocalDateTime.now();
users.forEach(user -> {
user.setCreateTime(now);
user.setUpdateTime(now);
user.setCreateBy(currentUser);
user.setUpdateBy(currentUser);
});
// 执行批量插入
userMapper.batchInsert(users);
}
优点：
- 实现简单直接
- 不依赖特定框架版本
- 性能影响最小
缺点：
- 需要手动维护审计逻辑
- 存在代码重复风险
3.2 方案二：自定义MyBatis拦截器
实现MyBatis的Interceptor接口进行字段自动填充：
java复制@Intercepts({
@Signature(type= Executor.class, method="update",
args={MappedStatement.class, Object.class})
})
public class AuditFieldInterceptor implements Interceptor {
@Override
public Object intercept(Invocation invocation) throws Throwable {
Object parameter = invocation.getArgs()[1];
if (parameter instanceof Collection) {
Collection<?> entities = (Collection<?>) parameter;
entities.forEach(this::populateAuditFields);
}
return invocation.proceed();
}
private void populateAuditFields(Object entity) {
if (entity instanceof Auditable) {
Auditable auditable = (Auditable) entity;
LocalDateTime now = LocalDateTime.now();
if (auditable.getCreateTime() == null) {
auditable.setCreateTime(now);
}
auditable.setUpdateTime(now);
}
}
}
配置方式：
java复制@Configuration
public class MyBatisConfig {
@Bean
public AuditFieldInterceptor auditFieldInterceptor() {
return new AuditFieldInterceptor();
}
}
3.3 方案三：混合持久化方案
结合JPA和MyBatis的优势：
- 使用JPA保存单个实体（审计字段自动生效）
- 使用MyBatis进行复杂查询和批量更新
java复制public void hybridBatchInsert(List<User> users) {
// 先通过JPA保存获取ID
users.forEach(userRepository::save);
// 再通过MyBatis批量更新其他字段
userMapper.batchUpdateAdditionalFields(users);
}
4. 性能对比与选型建议
我们对三种方案进行10万条数据插入测试：
| 方案 | 耗时(ms) | 内存占用 | 审计字段 | 适用场景 |
|---|---|---|---|---|
| 手动填充 | 1,200 | 低 | 完整 | 纯MyBatis项目 |
| 拦截器 | 1,800 | 中 | 完整 | 需要统一处理 |
| 混合方案 | 3,500 | 高 | 完整 | 既有JPA又有MyBatis |
选型建议：
- 如果是纯MyBatis项目，推荐方案一
- 需要统一审计逻辑时选择方案二
- 已有JPA基础的项目考虑方案三
5. 生产环境注意事项
5.1 事务管理要点
批量操作必须注意事务配置：
java复制@Transactional
public void batchInsertWithTransaction(List<User> users) {
// 确保在同一个事务中执行
userMapper.batchInsert(users);
}
5.2 批量大小优化
建议分批处理，每批500-1000条：
java复制public void batchInsertInChunks(List<User> users) {
Lists.partition(users, 500).forEach(chunk -> {
populateAuditFields(chunk);
userMapper.batchInsert(chunk);
});
}
5.3 多租户场景处理
在SAAS系统中需要额外处理tenant_id：
java复制public void populateTenantAuditFields(List<User> users) {
String tenantId = TenantContext.getCurrentTenant();
users.forEach(user -> {
user.setTenantId(tenantId);
// 设置其他审计字段...
});
}
6. 常见问题排查
6.1 字段未填充问题
检查清单：
- 确认@EnableJpaAuditing已启用
- 检查实体类是否有@EntityListeners注解
- 验证AuditorAware是否返回正确用户
6.2 性能问题优化
如果遇到性能瓶颈：
- 调整JDBC批量大小：spring.jpa.properties.hibernate.jdbc.batch_size=500
- 关闭自动提交：spring.jpa.properties.hibernate.connection.provider_disables_autocommit=true
- 使用rewriteBatchedStatements=true（MySQL）
6.3 与乐观锁冲突
当使用@Version时需要注意：
- 批量插入前需要初始化版本号
- 更新操作要检查版本一致性
- 考虑使用专门的批量版本控制策略
7. 高级应用场景
7.1 多数据源配置
在多数据源环境下需要特殊处理：
java复制@Configuration
@EnableJpaAuditing(auditorAwareRef = "auditorAware")
public class AuditConfig {
@Bean
public AuditorAware<String> auditorAware() {
return () -> Optional.ofNullable(SecurityContextHolder.getContext())
.map(SecurityContext::getAuthentication)
.map(Authentication::getName);
}
}
7.2 历史记录追踪
结合Envers实现完整审计追踪：
java复制@Entity
@Audited
public class User {
// 实体字段...
}
// 查询历史记录
AuditReader reader = AuditReaderFactory.get(entityManager);
List<Number> revisions = reader.getRevisions(User.class, id);
7.3 异步审计日志
对于高性能要求的场景：
java复制@Async
@EventListener
public void handleAuditEvent(AbstractAuditingEvent event) {
auditLogRepository.save(convertToLogEntry(event));
}