以IoT Hub为触发器的Azure Functions未被触发调用的排查求助

连接配置类问题排查 #

• 核对连接字符串的匹配性
  • 检查IoT Hub触发器绑定的配置名称，和函数应用「应用配置」列表里存的连接项名必须完全一致，包括大小写、拼写细节，名称不匹配时触发器会静默加载失败，不会抛出显性报错。
  • IoT Hub触发器实际依赖内置的事件Hub兼容终结点工作，不能使用设备侧的连接字符串，必须使用带「服务连接」权限的共享访问策略生成的连接串（默认的service内置策略即可满足权限要求）。
  • 手动从IoT Hub的「内置终结点」面板复制事件中心兼容路径，和连接串里的事件中心路径段做比对，确认没有错选到其他自定义事件Hub的连接串。
• 存储账户配置校验
  • .NET 3.1版本的IoT Hub触发器需要依赖存储账户维护消费检查点，检查函数应用的AzureWebJobsStorage配置项对应的存储账户，是否和函数应用、IoT Hub处于同一区域，且没有开启VNet/防火墙规则拦截函数后台的访问请求。
  • 临时将存储账户的网络访问权限调整为允许公共访问测试10分钟，如果此时函数恢复触发，即可定位是网络策略拦截的问题。

消费与路由类问题排查 #

• 消费组租约冲突排查
  • IoT Hub内置终结点的默认$Default消费组，如果被其他工具（比如设备资源管理器、本地调试脚本、其他常驻运行的进程）占用了分区租约，会导致函数触发器抢不到消费权限，出现IoT Hub消息计数正常但函数不执行的现象。
  • 在IoT Hub「内置终结点」的消费组列表里，新建一个专属的消费组（比如命名为func-trigger-consumer），把触发器配置里的consumerGroup值修改为新建的消费组，避免和其他进程抢占租约。
• 消息路由规则校验
  • 检查IoT Hub的「消息路由」配置，确认没有规则把默认的设备遥测消息转发到其他自定义终结点（比如存储Blob、自定义事件中心、服务总线队列），所有无路由匹配的消息默认会进入内置事件终结点供函数消费。
  • 注意区分消息通道：门户上的「发送消息到设备」云到设备测试通道的消息，根本不会进入事件终结点，永远不会触发IoT Hub触发器，必须使用「设备到云遥测」路径的测试工具发送消息才能被消费。

运行时兼容类问题排查 #

• 扩展版本匹配校验
  • .NET 3.1是已停止支持的长期运行时版本，对应的IoT Hub Functions扩展需要保持在3.x稳定版本，如果自动升级到了适配.NET 6+的4.x以上版本，会出现触发器加载失败的问题。
  • 在函数应用的「扩展」面板中确认Microsoft.Azure.WebJobs.Extensions.IoTHub的版本，调整完成后手动重启函数应用，等待3-5分钟让触发器完全加载后再做消息测试。
• 平台运行状态校验
  • 免费/共享层级的App Service Plan默认会在无持续请求时休眠，终止后台消息拉取进程，导致即使IoT Hub消息计数持续增长，函数也无法被触发。
  • 进入函数应用的「平台设置」-「所有应用设置」，开启「始终运行」选项，保障后台拉取进程持续在线。

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