SQS FIFO队列无法按正确顺序发送邮件问题排查求助

我来帮你梳理几个最可能导致这个问题的关键点，一步步排查：

1. 先确认SQS FIFO队列的基础配置是否合规 #

这是最容易踩的坑，很多人以为创建了FIFO队列就生效，其实有几个硬性要求：

• 队列名称必须以.fifo结尾，否则本质还是标准队列，完全没有FIFO顺序保障
• 所有需要按顺序处理的邮件消息，必须指定相同的MessageGroupId：只有同一个消息组内的消息才会严格按入队顺序处理，如果每条消息用不同的组ID，SQS会并行处理这些消息，自然就乱序了
• 创建队列时必须设置FifoQueue=true，这个参数是开启FIFO特性的核心开关

2. 检查消费端的并发控制逻辑 #

• 如果你启动了多个消费者进程/线程监听队列，同一个消息组的消息只能被一个消费者处理。如果多个消费者同时运行，SQS会把不同消息组的消息分给不同消费者，但同一个组的消息会被锁定给单个消费者，直到该消息被删除或超时。如果你的消息都在同一个组但还是乱序，要确认是不是多消费者实例导致的并行处理
• 消费消息时的MaxNumberOfMessages参数：如果设为大于1，同一个请求只能拉取不同消息组的消息；如果所有消息都在同一个组，这个参数设多少都只会拉取一条，直到前一条被处理完成

3. 验证代码中的消息处理细节 #

看你贴的代码逻辑（发完邮件再删除SQS消息）是合理的，但还要注意：

• 消息可见性超时设置：如果邮件发送耗时超过了队列的VisibilityTimeout，SQS会把这条消息重新设为可见，可能被其他消费者重复获取，导致顺序混乱。可以把这个超时时间调大到邮件最长发送耗时的2-3倍
• 控制台日志的顺序是否和消息入队顺序一致？如果日志顺序是对的，但邮件到达顺序乱，那大概率是消息组ID配置错误，导致多个消息被并行消费（毕竟SES本身不会随意打乱发送顺序）

4. 做个极简测试验证逻辑 #

可以快速验证核心逻辑是否正常：

• 只发送3条测试消息，全部使用同一个MessageGroupId
• 消费端只启动一个实例
• 观察控制台日志顺序和邮件到达顺序
  如果这次顺序正常，那之前的问题肯定出在消息组ID配置或多消费者的并发上；如果还是乱序，再去检查SES发送代码是否有隐性并行的逻辑（比如不小心用了Promise.all之类的并行处理）

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