4.13. 将未发送的消息移到死信地址

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 在与 队列名称匹配的 <address-setting > 元素中，为死信地址名称和最大交付尝试数设置值。例如：

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="exampleQueue">
               <dead-letter-address>DLA</dead-letter-address>
               <max-delivery-attempts>3</max-delivery-attempts>
            </address-setting>
         ...
         <address-settings>
   <configuration ...>

   match

   代理应用此 address-setting 部分中的配置的地址。您可以为 < address-setting> 元素的 match 属性指定通配符表达式。如果您希望将 <address-setting> 项中配置的死信设置与一组地址相匹配，可以使用通配符表达式。

   dead-letter-address

   死信地址的名称。在本例中，代理将未发送的消息从队列 exampleQueue 移到死信地址 DLA。

   max-delivery-attempts

   在将未发送的消息移到配置的死信地址前，代理进行的最大交付尝试数量。在本例中，代理会在 3 次失败发送尝试后将未发送的消息移到死信地址。默认值为 10。如果您希望代理进行无限数量的重新发送尝试，请指定 -1 的值。

3. 在 addresses 部分中，为死信地址 DLA 添加 address 元素。要将死信队列与死信地址关联，请为 队列 指定名称值。例如：

   <configuration ...>
      <core ...>
         ...
         <addresses>
            <address name="DLA">
               <anycast>
                  <queue name="DLQ" />
               </anycast>
            </address>
         ...
         </addresses>
      </core>
   </configuration>

流程

1. 打开 & lt;broker_instance_dir> /etc/broker.xml 配置文件。

2. 找到您之前添加的 &lt ;address-setting > 元素，以便为匹配的队列或一组队列定义死信地址。例如：

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="exampleQueue">
               <dead-letter-address>DLA</dead-letter-address>
               <max-delivery-attempts>3</max-delivery-attempts>
            </address-setting>
         ...
         <address-settings>
   <configuration ...>

3. 在 <address-setting > 元素中，添加指示代理自动创建死信资源（即地址和队列）的配置项目以及如何命名这些资源。例如：

   <configuration ...>
      <core ...>
         ...
         <address-settings>
            ...
            <address-setting match="exampleQueue">
               <dead-letter-address>DLA</dead-letter-address>
               <max-delivery-attempts>3</max-delivery-attempts>
               <auto-create-dead-letter-resources>true</auto-create-dead-letter-resources>
               <dead-letter-queue-prefix>DLQ.</dead-letter-queue-prefix>
               <dead-letter-queue-suffix></dead-letter-queue-suffix>
            </address-setting>
         ...
         <address-settings>
   <configuration ...>

   auto-create-dead-letter-resources

   指定代理是否自动创建死信地址和队列来接收未发送的消息。默认值为 false。

   如果 auto-create-dead-letter-resources 设置为 true，则代理会自动创建一个 & lt;address > 元素来定义死信地址和一个关联的死信队列。自动创建的 <address& gt; 元素的名称与您为 < dead-letter-address> 指定的值 匹配。

   代理自动创建的 < address > 元素中定义的死信队列具有 multicast 路由类型。默认情况下，代理命名死信队列以匹配未发送消息的原始地址，例如 库存。

   代理还定义了使用 _AMQ_ORIG_ADDRESS 属性的死信队列的过滤器。此过滤器可确保死信队列仅接收发送到相应原始地址的消息。

   dead-letter-queue-prefix

   代理应用到自动创建的死信队列的名称的前缀。默认值为 DLQ。

   当您定义前缀值或保留默认值时，死信队列的名称是前缀和原始地址的串联，如 DLQ.stocks。

   dead-letter-queue-suffix

   代理应用到自动创建的死信队列的后缀。未定义默认值（即代理不会应用后缀）。