如何配置WildFly 26集群以限制JMS消息重试次数

在WildFly 26集群环境中，JMS消息的重试次数可以通过队列/主题配置或消息驱动Bean（MDB）的局部配置来控制，无需依赖仅针对外部JMS子系统的JMS Bridge，具体实现方式如下：

1. 全局配置：在队列/主题层面设置重试次数 #

直接修改WildFly的核心配置文件（集群环境通常使用domain.xml，独立节点使用standalone.xml），在messaging-activemq子系统中为目标队列/主题添加max-delivery-attempts属性，指定最大重试次数：

队列配置示例 #

<subsystem xmlns="urn:jboss:domain:messaging-activemq:13.0">
    <server name="default">
        <!-- 其他已有配置 -->
        <jms-queue name="BusinessQueue" entries="java:/jms/queue/BusinessQueue">
            <durable>true</durable>
            <!-- 设置最大投递次数，超过次数后消息将转入死信队列 -->
            <max-delivery-attempts>3</max-delivery-attempts>
            <!-- 可选：自定义死信队列地址 -->
            <dead-letter-address>java:/jms/queue/CustomDLQ</dead-letter-address>
        </jms-queue>
    </server>
</subsystem>

• max-delivery-attempts：取值为正整数时代表最大重试次数，设为-1则表示无限重试（默认值为10）；
• 当消息投递失败次数达到设定值后，会自动转入死信队列，默认死信队列为DLQ，可通过dead-letter-address自定义目标地址。

2. 局部配置：在MDB中单独指定重试规则 #

如果你的消息消费逻辑通过MDB实现，可以直接在MDB的注解中配置重试参数，该配置优先级高于队列的全局设置：

MDB代码示例 #

@MessageDriven(
    activationConfig = {
        @ActivationConfigProperty(propertyName = "destinationLookup", propertyValue = "java:/jms/queue/BusinessQueue"),
        @ActivationConfigProperty(propertyName = "destinationType", propertyValue = "javax.jms.Queue"),
        // 设置该MDB对应的消息最大重试次数
        @ActivationConfigProperty(propertyName = "maxDeliveryAttempts", propertyValue = "3"),
        // 可选：自定义重试间隔（单位：毫秒）
        @ActivationConfigProperty(propertyName = "retryInterval", propertyValue = "2000")
    }
)
public class BusinessMDB implements MessageListener {
    @Override
    public void onMessage(Message message) {
        // 消息处理逻辑
    }
}

• maxDeliveryAttempts：单独指定当前MDB处理消息的最大重试次数；
• retryInterval：可自定义每次重试的间隔时间，避免短时间内频繁重试给系统带来压力。

集群环境注意事项 #

• 若使用域模式（domain mode）集群，修改domain.xml后配置会自动同步到所有受控节点；
• 若使用独立节点集群，需确保所有节点的配置文件保持一致，避免出现重试规则不一致的情况；
• 死信队列的配置需在集群内统一，防止消息分散到不同节点的死信队列中，增加运维复杂度。

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