Spring Boot部署在WAS Liberty时使用REQUIRES_NEW事务传播抛出TransactionSuspensionNotSupportedException的解决咨询

你遇到的这个问题核心在于WAS Liberty默认未启用支持事务挂起的JTA特性，同时Spring Boot的事务管理器配置也需要适配Liberty的环境。结合你的版本信息（Java 21、Spring Boot 3.4.5、WAS Liberty 23.0.0.9），我给你以下分步解决方案：

1. 启用WAS Liberty的JTA事务特性 #

你的server.xml中缺少了关键的事务支持特性，这直接导致两个问题：一是Liberty无法暴露JTA事务管理器的JNDI条目，二是不支持事务挂起操作。需要在featureManager中添加transaction-2.0特性（该特性对应JTA 1.3规范，适配Java 17+环境，与你的Liberty版本兼容）：

修改后的featureManager配置：

<featureManager>
    <feature>localConnector-1.0</feature>
    <feature>servlet-6.0</feature>
    <feature>pages-3.1</feature>
    <feature>xmlBinding-4.0</feature>
    <feature>persistence-3.1</feature>
    <feature>messagingClient-3.0</feature>
    <feature>messagingServer-3.0</feature>
    <feature>appSecurity-5.0</feature>
    <feature>restConnector-2.0</feature>
    <!-- 新增JTA事务支持特性 -->
    <feature>transaction-2.0</feature>
</featureManager>

启用该特性后，Liberty会自动注册java:comp/UserTransaction和java:comp/TransactionManager的JNDI条目，解决你之前遇到的NameNotFoundException。

2. 正确配置Spring Boot的JTA事务管理器 #

当Liberty启用transaction-2.0后，你可以通过两种方式配置Spring的事务管理器，确保它能正确利用Liberty的JTA能力：

方式一：自动配置（推荐）

Spring Boot 3.x可以自动适配Liberty的JTA环境，你只需在配置文件中启用JTA支持即可，无需手动编写@Bean：
在application.properties中添加：

spring.transaction.jta.enabled=true

Spring Boot会自动检测并绑定Liberty提供的JTA事务资源，无需手动JNDI查找。

方式二：手动配置（适合需要精细控制的场景）

如果你需要自定义事务管理器的行为，可以保留@Bean配置，但建议使用Spring的JndiTemplate简化JNDI查找（避免手动InitialContext的潜在问题）：

import org.springframework.jndi.JndiTemplate;
import org.springframework.transaction.jta.JtaTransactionManager;
import javax.naming.NamingException;
import javax.transaction.UserTransaction;
import javax.transaction.TransactionManager;

@Bean
public JtaTransactionManager transactionManager() throws NamingException {
    JndiTemplate jndiTemplate = new JndiTemplate();
    UserTransaction utx = jndiTemplate.lookup("java:comp/UserTransaction", UserTransaction.class);
    TransactionManager tm = jndiTemplate.lookup("java:comp/TransactionManager", TransactionManager.class);
    return new JtaTransactionManager(utx, tm);
}

同时，确保你的Spring Boot启动类上显式添加@EnableTransactionManagement（虽然@SpringBootApplication已隐含该注解，但显式声明更保险）。

3. 验证事务挂起的有效性 #

配置完成后，重启Liberty和应用，按以下步骤验证：

1. 确保带有@Transactional(propagation = Propagation.REQUIRES_NEW)的方法所在类被Spring管理（即标注了@Service、@Component等注解）
2. 确保该方法通过Spring代理对象调用（同一类内的直接调用不会触发事务代理，需从外部类或控制器入口调用）
3. 测试JMS+JDBC的事务一致性，以及REQUIRES_NEW方法的独立事务行为

额外注意事项 #

• XA数据源配置：由于你的应用同时涉及JMS和JDBC操作，必须将JDBC数据源配置为XA类型（在Liberty的server.xml中使用<xaDataSource>而非普通<dataSource>），否则JTA事务无法跨资源协调。
• 日志排查：如果仍有问题，查看Liberty的messages.log，确认transaction-2.0特性是否成功加载，以及Spring的事务管理器是否正确初始化。
• 事务代理限制：避免在同一类内直接调用事务方法，需通过Spring容器获取的代理对象调用，否则事务注解不会生效。

内容来源于stack exchange