SQS消息进入可见性超时但Lambda未接收问题排查

一、消息未被Lambda接收就进入可见性超时的原因 #

• Lambda的SQS事件源存在预取机制：Lambda服务会主动轮询SQS队列，提前拉取消息到内部缓存，这些预取的消息会立刻被标记为不可见（进入可见性超时），哪怕Lambda还没启动实例处理它们。
• 误配置ParallelizationFactor：这个参数控制单个Lambda实例可同时处理的批次数量，若设置大于1，即使你把BatchSize和并发数都设为1，Lambda也会预取多批次消息，导致这些消息被锁定，却因并发限制无法处理。
• 失败消息的重试预取：之前失败的Lambda调用导致消息重新入队，这些消息会被再次预取，但受限于并发设置，一直处于不可见状态等待处理。

二、Messages Sent指标显示多条消息的原因 #

Messages Sent是SQS的核心指标，统计的是所有生产者发送到该队列的消息总数，和Lambda是否接收、处理消息无关。只要有外部服务向队列发送了多条消息，这个指标就会增长，和你的Lambda触发配置没有直接关联。

三、实现预期效果的配置调整与方案 #

要达成“Lambda每次仅接收一条消息，且能访问删除队列中其他消息”的需求，可按以下步骤调整：

1. 修正Lambda事件源映射配置 #

• 保持BatchSize=1：确保每次Lambda调用只处理1条消息。
• 设置ParallelizationFactor=1：禁止Lambda预取多批次消息，避免不必要的消息锁定。
• 配置MaximumBatchingWindow=0：让Lambda无需等待凑批次，有消息就立即触发，减少预取导致的消息不可见时长。
• 确认Lambda并发数为1：保证同一时间只有一个实例运行，避免多实例同时预取消息。

2. 实现对队列其他消息的操作 #

当Lambda处理当前消息时，若要操作队列中的其他消息，需确保目标消息处于可见状态：

• 若目标消息被预取锁定（不可见），可调用SQS的ChangeMessageVisibility API，将其可见性超时设为0，让消息立即变回可见，之后就能用ReceiveMessage或DeleteMessage API操作。
• 分离操作逻辑：如果需要频繁操作队列任意消息，建议将这类逻辑和SQS触发的Lambda处理逻辑分离，比如用单独的服务或Lambda处理批量操作，避免和自动预取机制冲突。
• 配置消息过滤：在事件源映射中设置消息过滤规则，让Lambda只预取符合条件的消息，其他消息保持可见状态，方便后续操作。

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