Azure Function App Service Bus订阅触发器部署后无法触发消费消息

• 检查连接字符串配置

  • 确认Azure门户中Function App的「应用程序设置」里，Service Bus连接字符串与本地调试时一致，无拼写错误（比如Endpoint、SharedAccessKey）。
  • 确保代码中引用的配置项名称（如%ServiceBusConnection%）与Azure端的配置项名称完全匹配，本地local.settings.json的配置不会自动同步到Azure，需手动添加或通过部署工具同步。

• 验证订阅的权限与有效性

  • 确认Service Bus主题下的目标订阅存在，未被误删除。
  • 检查连接字符串对应的SAS Policy是否具备Listen权限，生产环境建议使用仅含必要权限的专用Policy，避免使用Root权限但确保权限足够。
  • 排查订阅的过滤器规则：如果订阅设置了SQL/Correlation过滤器，推送的消息必须符合过滤条件（比如消息属性、CorrelationId匹配）才会被触发。

• 查看Function App运行状态与日志

  • 确认Azure端的函数处于已启用状态，未被手动禁用。
  • 查看函数日志：在门户进入函数页面，点击「监测」->「日志」，或通过Kudu工具（高级工具->Go）查看D:\home\LogFiles\Application\Functions\Function\<你的函数名>路径下的日志，排查是否有连接失败、权限不足、消息处理异常等报错。
  • 通过Azure Monitor查看函数的调用指标（如「函数调用次数」「失败调用次数」），确认是否有调用记录。

• 检查Service Bus消息状态

  • 进入Service Bus订阅页面，查看「活动消息计数」「死信消息计数」：若消息进入死信队列，说明函数尝试处理但失败，需查看死信原因（如消息格式错误、处理超时、未捕获异常）。
  • 确认订阅的「锁定持续时间」「最大传递次数」设置：若函数处理消息时反复抛出异常，超过最大传递次数后消息会被移至死信，需调整参数或修复处理逻辑。

• 确认部署与版本一致性

  • 验证部署到Azure的代码与本地调试版本一致，触发器属性（主题名、订阅名）无拼写错误。
  • 确保Function App的运行时版本（v3/v4）与本地调试环境一致，版本不兼容可能导致触发器异常。
  • 检查Service Bus扩展包版本：本地项目中Microsoft.Azure.WebJobs.Extensions.ServiceBus的版本需与Azure端Function App的扩展版本匹配，可在门户「配置」->「功能扩展」查看并更新。

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