Azure Queue消息过期设置异常及消息入Poison Queue问题求助

嘿，我来帮你搞定这两个问题：

1. 修正消息过期时间设置 #

首先你踩了一个常见的参数单位坑：Azure Queue Python SDK里的time_to_live参数单位是秒，不是你以为的分钟！你设置的3600刚好是1小时，所以expires_on显示为插入时间后1小时完全符合预期。

如果要设置1天的过期时间，计算一下：24小时 × 60分钟 × 60秒 = 86400秒。修正后的代码如下（顺便补了你漏写的import os）：

from azure.storage.queue import QueueServiceClient, QueueClient, QueueMessage
import os

connectionstring = os.environ.get("connection_string")
queue_client = QueueClient.from_connection_string(connectionstring, queue_name)
msg_content = {"MessageID":"AQ2","MessageContext":"This is a test Message"}
# 可见性超时10秒，过期时间1天（86400秒）
queue_client.send_message(msg_content, visibility_timeout=10, time_to_live=86400)

额外说明：time_to_live的最大值是7天（604800秒），如果设置为0或负数，消息会永不过期（这个规则在最新SDK版本中依然有效）。

2. 排查消息立即进入死信队列的异常 #

消息刚发送就进死信队列，肯定不是过期导致的（之前设置的1小时过期还没到），可以从这几个方向排查：

• 检查活跃消费者：如果有其他代码/服务在监听这个队列，可能它获取消息后错误地直接调用了死信相关方法（比如dead_letter_message）。建议先暂停所有消费者进程，重新发送测试消息，看是否还会立即进入死信队列。
• 核对队列配置：
  • 登录Azure门户，找到你的存储账户和目标队列，查看最大重试次数（Max dequeue count），默认是5次，如果被改成了1，那消费者获取一次消息就会触发死信（但如果没有消费者，这个不会生效）。
  • 确认队列名称是否正确：死信队列的命名规则是{原队列名}-poison，如果你的queue_name不小心写成了死信队列的名字，那消息会直接发到死信里。
• 查看存储日志定位原因：在Azure门户的存储账户中开启队列日志，日志会详细记录消息被移至死信的具体触发条件（比如超过重试次数、手动操作、配置错误等），这是最直接的排查方式。
• 检查消息序列化问题：虽然你的响应里content显示正常，但可以手动把字典转成JSON字符串再发送试试（比如用json.dumps(msg_content)），排除SDK自动序列化的潜在问题。

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