配置最大5次重试后，Pub/Sub推送订阅消息未进入死信队列

问题背景 #

已为Pub/Sub推送类型订阅配置死信队列，设置最大投递尝试次数为5次，但日志中仍出现超过5次的重试记录；已为主题分配发布者、订阅者角色，且对比过其他订阅的权限配置。

具体排查点 #

• 补全死信队列的关键权限：除了原主题的发布者/订阅者角色，当前订阅的身份（默认服务账号或自定义身份）需要拥有死信主题的roles/pubsub.publisher权限。如果缺少这个权限，消息无法转入死信队列，会持续触发重试。
• 确认重试次数的统计逻辑：Pub/Sub的重试次数从消息首次投递开始计数，包含所有因推送超时、端点返回非2xx状态码导致的重试。要核对日志中超过5次的记录是否属于同一消息的连续投递，而非不同消息的统计混淆。
• 规范推送端点的响应状态：如果推送端点返回503 Service Unavailable或带Retry-After头的状态码，Pub/Sub会忽略最大投递次数，按指定时间继续重试。建议在消息无法处理且无需重试时，返回400、404这类明确终止重试的状态码。
• 验证订阅配置的生效状态：通过gcloud pubsub subscriptions describe [你的订阅名称]命令，查看deadLetterPolicy字段下的maxDeliveryAttempts值，确认配置是否已正确生效为5。
• 检查死信主题的运行状态：若死信主题对应的订阅存在堆积、权限异常等问题，会影响消息转入流程，导致原订阅持续重试。需确认死信主题的订阅是否正常运行，无消息堆积情况。

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