使用Python SDK接收Azure队列报错ValueError，求解决方案

你遇到的这个错误虽然和旧版本的bug描述类似，但在0.21.1版本仍出现，大概率是触发了SDK未完全修复的边缘情况，或是你的代码/配置存在特殊点导致的。下面是几个针对性的排查和解决方向：

• 检查自定义消息属性的命名冲突
  有时候我们给消息添加的自定义属性键名，可能会和Azure Service Bus SDK内部解析的元数据键名撞车。比如如果你的消息里有一个名为max-age的自定义属性，SDK在处理时可能误将其当成需要解析的HTTP头类字段，进而尝试把带=的字符串转成float。
  建议：发送消息时给自定义属性加个专属前缀（比如my-max-age），避免和内部字段重名；接收时先打印所有消息属性，确认max-age字段的来源：

  # 接收时打印所有属性，排查字段来源
  message = receiver.receive()
  print("Message properties:", message.properties)
  message.complete()
  

• 升级到更稳定的小版本
  0.21.1之后还有几个小版本更新，比如0.21.4，这些版本可能修复了0.21.1中残留的类似解析bug。执行以下命令升级试试：

  pip install --upgrade azure-servicebus==0.21.4
  

• 排查接收代码的手动解析逻辑
  如果你在接收消息时自己手动处理了消息的properties或headers，有没有可能误将max-age=31536000这样的字符串直接转成float？比如代码里写了float(message.properties.get('max-age'))，这时候需要先解析出数值部分再转换：

  max_age_raw = message.properties.get('max-age')
  if max_age_raw:
      # 拆分字符串获取数值部分
      max_age_value = float(max_age_raw.split('=')[1])
  

• 检查Azure队列的TTL配置
  虽然可能性较低，但可以去Azure Portal确认下目标队列的Message Time To Live设置是否为纯数值（比如31536000），而不是带max-age=前缀的字符串。如果配置有误，SDK解析时可能会出现异常。

• 启用调试日志定位根源
  如果以上方法都没解决，建议开启SDK的调试日志，查看完整的报错调用栈，精准定位是SDK内部哪一步触发的转换错误：

  import logging
  # 开启调试级日志
  logging.basicConfig(level=logging.DEBUG)
  

  运行接收代码后，查看日志里的详细报错轨迹，就能知道是SDK处理内部元数据时出问题，还是你的代码逻辑导致的。

如果尝试完这些还是无法解决，可以把你的接收代码片段和完整的报错栈贴出来，这样能更精准地帮你定位问题。

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