Spring Batch中JPA save()/saveAll()不生效且无报错求助

核心排查方向（仅commercial步骤异常，聚焦该步骤特殊性） #

1. 事务边界校验 #

Spring Batch的步骤事务由StepScope管控，需确保commercial步骤绑定了正确的事务管理器：

• 检查步骤构建时是否显式指定事务管理器，避免与全局配置不匹配：

@Bean
public Step commercialStep(JobRepository jobRepository, PlatformTransactionManager transactionManager) {
    return new StepBuilder("commercialStep", jobRepository)
            .<CommercialData, CommercialData>chunk(100, transactionManager) // 必须绑定正确的事务管理器
            .reader(commercialReader())
            .processor(commercialProcessor())
            .writer(commercialWriter())
            .build();
}

• 确认JPATransactionManager关联了正确的EntityManagerFactory：

@Bean
public PlatformTransactionManager transactionManager(EntityManagerFactory entityManagerFactory) {
    return new JpaTransactionManager(entityManagerFactory);
}

2. QueryDSL上下文冲突排查 #

若commercial步骤混用QueryDSL与JPA操作，需确保两者共享同一事务上下文：

• 禁止手动实例化JPAQueryFactory，必须注入Spring管理的EntityManager：

@Bean
public JPAQueryFactory jpaQueryFactory(EntityManager entityManager) {
    return new JPAQueryFactory(entityManager);
}

• 避免在Writer/Processor中手动调用entityManager.flush()或entityManager.clear()，交由Spring Batch的Chunk机制自动处理事务提交。

3. Writer实现检查 #

排查commercialWriter是否存在以下问题：

• 确保使用Spring依赖注入的Repository实例，而非手动new的对象；
• 检查是否存在吞掉异常的try-catch块（即使无报错提示，也可能隐藏了事务回滚的触发原因）；
• 正确的Writer实现示例：

@Component
public class CommercialItemWriter implements ItemWriter<CommercialData> {

    private final CommercialRepository commercialRepository;

    // 构造注入Spring管理的Repository
    public CommercialItemWriter(CommercialRepository commercialRepository) {
        this.commercialRepository = commercialRepository;
    }

    @Override
    public void write(List<? extends CommercialData> items) throws Exception {
        commercialRepository.saveAll(items); // 无需手动处理事务
    }
}

4. 实体类映射校验 #

检查Commercial实体类的持久化配置：

• 确认@Id注解及主键生成策略正确（主键生成失败会导致JPA静默不插入）；
• 排查是否误加@Transient注解在需要持久化的字段上；
• 确保equals()和hashCode()方法实现正确，避免JPA误判实体为detached状态。

5. 日志调试定位 #

开启DEBUG级日志，查看事务与JPA操作细节：

• 添加日志配置：

logging:
  level:
    org.springframework.transaction: DEBUG
    org.springframework.orm.jpa: DEBUG
    org.hibernate: DEBUG

• 重点查看commercial步骤的事务是否正常提交，是否存在Transaction rolled back because it has been marked as rollback-only类日志（此类日志说明事务被标记回滚但未抛出异常）。

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