如何在WildFly中禁用Qpid 6.1.7资源适配器的XA支持？

从你的错误栈和配置来看，核心问题是Qpid RA即使配置了LocalTransaction，仍然尝试创建XA会话，而RabbitMQ使用的AMQP 0-8协议本身不支持XA事务，所以抛出了这个异常。下面是具体的排查和解决步骤：

原因分析 #

Qpid RA的UseLocalTx=true配置理论上应该让适配器使用本地事务而非XA，但从错误栈看，QpidResourceAdapter.createXASession仍然被调用了。这说明要么是激活规范（ActivationSpec）的事务模式没有正确设置，要么是Qpid RA 6.1.7这个版本存在配置优先级的问题，导致LocalTx的设置没有生效。

解决方案 #

1. 明确配置MDB激活规范的事务类型 #

如果你的消息驱动Bean（MDB）是通过注解配置的，需要在@MessageDriven的activationConfig里显式指定事务类型为LocalTransaction，避免容器默认尝试XA：

@MessageDriven(
    activationConfig = {
        @ActivationConfigProperty(propertyName = "destinationLookup", propertyValue = "java:jboss/exported/queue/mail"),
        @ActivationConfigProperty(propertyName = "destinationType", propertyValue = "javax.jms.Queue"),
        @ActivationConfigProperty(propertyName = "acknowledgeMode", propertyValue = "Auto-acknowledge"),
        // 关键配置：强制使用本地事务
        @ActivationConfigProperty(propertyName = "transactionType", propertyValue = "LocalTransaction")
    }
)
public class YourMailMDB implements MessageListener {
    // ... 你的业务代码
}

如果是通过JBoss的standalone.xml配置激活规范，需要在对应的admin-object里添加事务类型参数：

<admin-objects>
    <admin-object class-name="org.apache.qpid.ra.admin.QpidQueueImpl" jndi-name="java:jboss/exported/queue/mail" use-java-context="true" pool-name="mail">
        <config-property name="DestinationAddress">queue/mail</config-property>
        <!-- 添加事务类型配置 -->
        <config-property name="TransactionType">LOCAL</config-property>
    </admin-object>
</admin-objects>

2. 调整Qpid RA的连接定义参数 #

在你的<connection-definition>里添加SessionTransacted=false和UseLocalTx=true的配置，确保连接工厂默认不使用XA：

<connection-definition class-name="org.apache.qpid.ra.QpidRAManagedConnectionFactory" jndi-name="qpid-ra" pool-name="qpid-ra">
    <config-property name="SessionDefaultType">javax.jms.Queue</config-property>
    <config-property name="UseLocalTx">true</config-property>
    <config-property name="SessionTransacted">false</config-property>
</connection-definition>

3. 明确ConnectionURL的协议参数 #

确保你的ConnectionURL明确指定AMQP 0-8协议，避免Qpid尝试协商更高版本的协议（虽然错误已经显示是0_8，但额外明确可以避免潜在问题）：

<config-property name="ConnectionURL">amqp://guest:guest@clientid/?brokerlist='tcp://localhost:5672?sasl_mechs='PLAIN'&amp;protocol='AMQP_0_8''</config-property>

4. 尝试升级Qpid RA版本 #

Qpid 6.1.7是比较旧的版本（发布于2017年），可能存在LocalTx配置不生效的bug。你可以尝试升级到Qpid RA 6.3.0或更高版本，这些后续版本修复了不少事务相关的问题，能更好地兼容RabbitMQ的本地事务模式。

5. 确认JBoss事务管理器配置 #

你的配置里指定了JBoss7TransactionManagerLocator，确保这个类在JBoss的类路径下能被正确加载，并且事务管理器的配置没有强制启用XA。可以检查JBoss的事务子系统配置，确保没有全局强制XA的设置。

验证步骤 #

修改配置后，重启JBoss服务器，观察日志是否还会出现0_8 version does not provide XA support的错误。如果MDB能正常启动并消费消息，说明配置生效了。

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