Google PubSub乱序ACK报错：开启消息排序与ExactlyOnce后重复推消息

问题核心 #

当订阅同时开启Message Ordering和ExactlyOnceDelivery时，PubSub对消息确认（ack）的顺序有强制要求：同一排序键下的消息，必须严格按照接收顺序执行ack操作。一旦打乱顺序提交ack请求，就会触发INVALID_ARGUMENT: Some acknowledgement ids in the request were sent out of order错误，且失败的ack不会生效，导致消息被重复推送。

针对性解决方案 #

• 串行处理同一排序键的消息：为每个排序键维护独立的串行处理队列，禁止并行处理同一键下的消息。例如通过线程池按排序键分组，每个键对应一个单线程执行器，确保消息处理和ack操作的顺序性。
• 规范批量ack的顺序：如果使用批量ack，必须保证批量内的ack ID属于同一排序键，且严格遵循消息接收顺序，禁止混合不同排序键或乱序的ID。
• 优化ack失败重试逻辑：收到乱序错误时，不要直接重试整个批量，拆分后按顺序逐个重新提交ack请求；或单独记录未成功ack的消息ID，按正确顺序单独发送ack。
• 升级客户端SDK版本：你当前使用的gax-2.31.1、gax-grpc-2.31.1等依赖存在旧版本bug的可能，建议升级到最新稳定版，修复排序场景下的ack处理问题。
• 禁止篡改ack ID：确保发送的ack ID完全是拉取请求返回的原始值，任何手动修改都会导致顺序验证失败。

临时应急措施 #

若问题紧急，可临时关闭ExactlyOnceDelivery功能恢复正常消费，后续修复顺序ack逻辑后再重新开启。注意关闭后可能出现重复消息，需在消费端做好幂等处理。

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