AWS SQS死信队列问题：异常处理消息未流入DLQ

以下是你可能遗漏的配置或步骤，按优先级排查：

1. 确认主队列的DLQ触发条件配置 #

SQS的DLQ仅在**消息被接收次数达到设置的最大接收次数（Maximum Receives）**时才会触发。你需要：

• 登录AWS控制台，检查主队列的死信队列配置，确认Maximum Receives值已正确设置（例如设为3，表示消息失败3次后转入DLQ）。
• 注意：该值统计的是SQS将消息推送给消费者的次数，而非本地代码的重试次数。

2. 调整Spring Cloud AWS的本地重试策略 #

默认情况下，Spring Cloud AWS的SQS Listener会对失败消息进行本地重试，这会导致消息没有被放回SQS队列，进而无法累积接收次数触发DLQ：

• 如果你希望完全由SQS控制重试和DLQ触发，可禁用本地重试：

  cloud:
    aws:
      sqs:
        listener:
          retry:
            enabled: false
  

• 若需要保留本地重试，需让本地重试次数 +1 等于主队列的Maximum Receives值（例如本地重试2次，主队列设为3），确保最后一次失败后消息被放回队列，触发DLQ。

3. 校验消息可见性超时（Visibility Timeout） #

如果可见性超时设置过短，可能在你的应用处理（或重试）消息时，超时到期导致消息提前回到队列，干扰接收次数统计：

• 建议将可见性超时设置为消息最长处理时间的3倍，避免消息被提前重新分发。

4. 检查主队列到DLQ的权限配置 #

主队列必须具备向DLQ发送消息的权限，否则即使触发条件满足，消息也无法转入DLQ：

• 检查主队列的访问策略，确保包含允许向DLQ发送消息的语句（替换占位符为你的实际资源信息）：

  {
    "Effect": "Allow",
    "Principal": "*",
    "Action": "sqs:SendMessage",
    "Resource": "arn:aws:sqs:你的区域:账号ID:你的DLQ名称",
    "Condition": {
      "ArnEquals": {
        "aws:SourceArn": "arn:aws:sqs:你的区域:账号ID:你的主队列名称"
      }
    }
  }
  

5. 确保代码未吞掉异常 #

如果你的消息处理逻辑中捕获了所有异常且未重新抛出，Spring Cloud AWS会认为消息处理成功，自动删除消息，导致失败消息无法进入DLQ：

• 检查getMessage方法内的代码，确保处理失败时异常被抛出到方法外部，不要用try-catch吞掉所有错误。

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