Spring Batch中TransactionManager Bean循环依赖报错原因及优化方案咨询

原因分析 #

你遇到的StackOverflowError是方法名与参数名冲突引发的递归依赖注入导致的：
当你定义名为transactionManager的@Bean方法时，Spring在注入参数TransactionManager transactionManager时，会优先根据方法名（而非类型）查找对应Bean。此时Spring会误将当前正在创建的JtaTransactionManager认定为要注入的对象，陷入无限递归调用——每次创建Bean都需要先注入自身，最终触发栈溢出。
改名为transactionManager2后，方法名与参数名不再冲突，Spring会正确根据TransactionManager类型查找容器中已存在的对应Bean，递归也就终止了。

更优解决方案 #

方案一：重命名方法参数 #

将参数名改为与方法名不同的名称，让Spring按类型正确注入：

@Bean
@Primary
public JtaTransactionManager transactionManager(UserTransaction userTransaction,
        TransactionManager tm) {
    JtaTransactionManager jtaTransactionManager = new JtaTransactionManager(userTransaction, tm);
    jtaTransactionManager.setAllowCustomIsolationLevels(true);
    return jtaTransactionManager;
}

方案二：用@Qualifier明确指定注入Bean #

如果容器中有多个TransactionManager类型Bean，或需要明确注入目标，给参数添加@Qualifier注解指定Bean名称：

@Bean
@Primary
public JtaTransactionManager transactionManager(UserTransaction userTransaction,
        @Qualifier("transactionManager") TransactionManager transactionManager) {
    JtaTransactionManager jtaTransactionManager = new JtaTransactionManager(userTransaction, transactionManager);
    jtaTransactionManager.setAllowCustomIsolationLevels(true);
    return jtaTransactionManager;
}

注：这里的@Qualifier值要对应容器中已存在的TransactionManager Bean名称，确保Spring不会递归注入当前正在创建的Bean。

方案三：保留方法名并依赖类型匹配 #

若希望保留transactionManager作为方法名，确保容器中存在明确的TransactionManager类型Bean（非当前创建的Bean），Spring会自动按类型匹配注入。不过结合@Qualifier使用会更稳妥，避免类型歧义。

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