Spring Batch Writer中PostgreSQL审计表插入失效的解决方法

核心原因 #

Spring Batch的ItemWriter默认运行在Step级别的事务中：如果Writer内的主数据操作（比如业务数据插入）触发事务回滚，同一事务里的审计插入也会被连带回滚；另外如果审计操作使用了独立于Batch的数据源/事务管理器，也会导致数据无法正常提交。

具体解决方法 #

1. 让审计操作纳入Batch当前事务 #

• 不要给审计插入方法添加@Transactional(propagation = Propagation.REQUIRES_NEW)这类强制开启新事务的注解，否则审计操作会脱离Batch事务上下文，出现主事务回滚但审计数据提交，或者主事务提交失败审计也跟着回滚的异常情况。
• 确保审计Repository/DAO与Batch Writer使用同一个数据源和事务管理器。

2. 实现审计日志独立于主事务（可选） #

如果需求是即使主数据操作失败，也要保留审计日志，需要让审计操作脱离Step事务：

• 给审计插入方法添加@Transactional(propagation = Propagation.REQUIRES_NEW)，强制开启独立事务。
• 注意必须保证该事务使用审计表所在的数据源，避免跨数据源事务问题。

3. 检查Batch事务配置正确性 #

• 确认Step的事务管理器关联了PostgreSQL数据源，示例配置：

  @Bean
  public PlatformTransactionManager batchTransactionManager(DataSource dataSource) {
      return new DataSourceTransactionManager(dataSource);
  }
  
  @Bean
  public Step myStep(ItemReader<MyData> reader, ItemWriter<MyData> writer, PlatformTransactionManager transactionManager) {
      return stepBuilderFactory.get("myStep")
              .<MyData, MyData>chunk(10)
              .reader(reader)
              .writer(writer)
              .transactionManager(transactionManager)
              .build();
  }
  

• 禁止在Writer中手动管理事务（比如手动调用commit()/rollback()），交由Spring Batch事务管理器统一处理。

4. 验证审计代码执行有效性 #

• 补充日志确认审计插入方法是否真的执行：除了"AUDIT DTO已创建"，添加类似"审计数据插入执行完成"的日志，排查是否存在分支逻辑未触发、代码被异常拦截的情况。
• 开启SQL执行日志，检查审计插入语句是否存在数据库约束违反（比如字段为空、主键冲突）等隐藏异常。

内容的提问来源于stack exchange，提问作者Sanjay Naik