JavaScript Azure Function输出消息进入死信队列排查咨询

我来帮你梳理几个关键的排查方向，这类“函数执行成功但消息直接死信”的问题，往往出在Service Bus本身的规则或者消息细节上：

• 优先查看死信消息的官方原因
  函数日志没报错不代表Service Bus没有记录原因。你可以通过Azure门户或者Azure CLI获取死信消息的具体属性：

  • 门户操作：进入目标队列 → 点击“死信队列” → 选中目标消息 → 查看DeadLetterReason和DeadLetterErrorDescription字段
  • CLI命令：

    az servicebus queue dead-letter-message show --resource-group <你的资源组名> --namespace-name <Service Bus命名空间> --queue-name <队列名> --message-id <消息ID>
    

  这两个字段会直接告诉你消息被死信的核心原因，比如消息超限、会话未设置、属性非法等，是最直接的排查入口。

• 验证消息大小是否超限
  Service Bus不同层级有消息大小限制：标准层单条最大256KB，高级层最大1MB。你用flat库扁平化请求体后，可能原本嵌套的JSON被展开成了更大的结构，不小心触发了大小限制。可以在函数里加一行日志输出消息体积：

  context.log('Message size in bytes:', Buffer.from(JSON.stringify(message)).length);
  

  对比一下队列的大小限制，就能快速排除这个问题。

• 检查消息格式与属性合法性
  flat库生成的键名可能包含.、_这类字符，虽然Service Bus允许，但某些特殊场景下（比如后续消费端的解析逻辑）可能间接导致死信？另外要确认消息没有不可序列化的内容（比如循环引用，不过flat通常会处理这类情况）。你可以先测试发送一个极简消息：

  context.bindings.outputSbMsg = { test: 'hello world' };
  

  如果这个消息能正常入队，就说明问题出在你扁平化后的消息结构上，需要进一步排查字段内容。

• 核对Service Bus绑定配置
  打开function.json检查输出绑定的配置：

  • 有没有写错队列名？
  • 是否开启了会话（"requiresSession": true）？如果队列启用了会话，但你的消息没有设置SessionId，会直接被死信。这种情况需要给消息添加会话ID：

    message.SessionId = 'unique-session-id';
    context.bindings.outputSbMsg = message;
    

• 检查Service Bus的配额与状态
  去Azure门户查看Service Bus命名空间的指标：

  • 有没有触发吞吐量单元限流？
  • 队列的最大实体数是否达到上限？
    这类配额问题有时候不会在函数日志里体现，但会导致消息被死信。可以查看“Deadlettered Messages”指标的关联告警，或者“资源使用情况”面板的配额状态。

• 排查依赖库与运行时兼容性
  你使用的flat库版本是否存在bug？或者Azure Function的Node.js运行时版本和库不兼容？可以尝试更新flat到最新版本，或者在本地用Service Bus SDK直接发送扁平化后的消息，看是否能成功入队，以此排除函数绑定的问题。

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