ElasticMQ v1.3.3配置DLQ后消息未转移至死信队列问题咨询

• 1. 配置字段拼写错误
     你当前配置中死信队列的配置键使用了复数形式deadLettersQueue，但ElasticMQ所有版本的配置规范中，该字段为单数形式deadLetterQueue，拼写错误会导致ElasticMQ完全无法识别你的DLQ配置，相当于main队列没有配置死信队列规则，自然不会触发DLQ转移逻辑。
     正确配置示例：

queues {
   main {
     defaultVisibilityTimeout = 10 seconds
     delay = 2 seconds
     receiveMessageWait = 0 seconds
     // 注意此处为单数deadLetterQueue
     deadLetterQueue {
       name = "retry"
       maxReceiveCount = 1
     }
   }
}

• 2. DLQ触发逻辑未满足
     SQS（包括ElasticMQ实现）的DLQ触发条件为：消息被接收的次数超过maxReceiveCount阈值才会被转移到DLQ。你设置的maxReceiveCount=1，需要满足以下流程才会触发转移：
  3. 第一次接收消息后，不调用删除接口，等待10秒（你配置的defaultVisibilityTimeout）让消息重新回到main队列
  4. 第二次调用receive-message接口尝试接收该消息时，系统判定接收次数超过阈值，才会将消息转移到retry队列
     你如果只接收了一次就立刻检查队列，消息还处于不可见状态，既不会出现在main队列的可接收列表里，也不会被转移到DLQ。
• 3. Docker容器配置文件未正确挂载
     如果你启动ElasticMQ容器时没有将本地编写的elasticmq.conf挂载到容器内的指定路径，容器会使用默认配置启动，你自定义的队列、DLQ规则都不会生效。正确的Docker启动命令需要添加挂载参数：

docker run -p 9324:9324 -p 9325:9325 -v $(pwd)/elasticmq.conf:/opt/elasticmq.conf softwaremill/elasticmq:1.3.3

• 4. 版本已知Bug
     ElasticMQ v1.3.3存在已知的DLQ逻辑兼容问题：当队列配置了非0的delay属性时，部分场景下超过接收次数的消息会被直接清理，而不会转移到DLQ。你可以先删除main队列的delay = 2 seconds配置验证是否是该问题导致。

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