Spring Batch使用EclipseLink JPA出现transactionManager重复定义报错如何解决

问题根因 #

你自定义的EclipseLinkJpaConfiguration继承了JpaBaseConfiguration，父类会默认注册名为transactionManager的JPA事务管理器Bean；而Spring Batch的@EnableBatchProcessing注解默认加载的SimpleBatchConfiguration配置类，也会自动注册同名的事务管理器Bean，两者命名冲突导致启动失败。

解决方案（无需开启Bean覆盖） #

方案1：指定Spring Batch使用已有的JPA事务管理器（推荐，改动最小） #

找到你项目中添加了@EnableBatchProcessing注解的Spring Batch配置类，给注解添加transactionManagerRef参数，明确指定Batch使用已经存在的JPA事务管理器，Spring Batch就不会再自动创建同名Bean：

// 修改前：@EnableBatchProcessing
@EnableBatchProcessing(transactionManagerRef = "transactionManager")
@Configuration
public class YourBatchConfig {
    // 原有Batch相关配置保持不变
}

方案2：自定义JPA事务管理器名称（适合需要区分多事务管理器的场景） #

如果你需要明确区分JPA事务管理器和其他事务管理器，可以手动重写JPA配置中的事务管理器注册逻辑，指定自定义Bean名，再给Spring Batch绑定该事务管理器：

1. 修改EclipseLinkJpaConfiguration，手动指定事务管理器的Bean名：

@Configuration
public class EclipseLinkJpaConfiguration extends JpaBaseConfiguration {
    protected EclipseLinkJpaConfiguration(DataSource dataSource,
                                          JpaProperties properties,
                                          ObjectProvider<JtaTransactionManager> jtaTransactionManager) {
        super(dataSource, properties, jtaTransactionManager);
    }

    // 新增：重写事务管理器注册方法，指定自定义Bean名
    @Bean(name = "jpaTransactionManager")
    @Override
    public PlatformTransactionManager transactionManager() throws Exception {
        return super.transactionManager();
    }

    @Override
    protected AbstractJpaVendorAdapter createJpaVendorAdapter() {
        return new EclipseLinkJpaVendorAdapter();
    }

    @Override
    protected Map<String, Object> getVendorProperties() {
        Map<String, Object> map = new HashMap<>();
        map.put(PersistenceUnitProperties.WEAVING, "false");
        map.put(PersistenceUnitProperties.LOGGING_LEVEL, SessionLog.FINER_LABEL);
        return map;
    }
}

2. 修改@EnableBatchProcessing注解，绑定自定义命名的JPA事务管理器：

@EnableBatchProcessing(transactionManagerRef = "jpaTransactionManager")
@Configuration
public class YourBatchConfig {
    // 原有配置保持不变
}

两种方案都可以从根源上避免Bean命名冲突，无需开启spring.main.allow-bean-definition-overriding=true。

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