Azure IoT Hub使用Azure Function跨设备C2D消息转发失败排查

• 先验证基础配置正确性
  • 确认ServiceClient使用的连接字符串是IoT Hub的服务端连接字符串，具备service connect权限，不要使用设备连接字符串或权限不足的密钥。
  • 确认代码中硬编码的目标设备IDsecondDevice和IoT Hub中已注册的设备ID完全一致，IoT Hub设备ID大小写敏感，注意拼写、大小写、特殊字符是否匹配。
• 查Azure Function运行日志
  你当前的代码已捕获并抛出异常，直接在Azure门户Function的「监视器」页查看运行日志，除了消息处理成功的日志外，是否有权限错误、设备不存在、配额超限、网络超时等报错信息，可直接定位根因。
• 验证设备端订阅配置
  首先通过IoT Hub门户手动发测试C2D消息缩小范围：进入第二个设备的详情页，点击「发送消息」手动输入测试内容发送，如果设备收不到，说明是设备端问题：
  • MQTT订阅C2D消息的标准topic是devices/{deviceId}/messages/devicebound/#，你当前使用的devices/secondDevice/messages/devicebound缺少末尾的通配符/#，无法匹配带系统属性/自定义属性的C2D消息，修改订阅topic即可。
  • 确认设备保持在线状态，如果设备离线，C2D消息会进入队列，可在设备详情页查看「C2D消息队列」是否有未投递的消息。
• 优化代码逻辑避免潜在问题
  你当前代码每次触发函数都会重新创建ServiceClient实例，容易触发连接数限制，建议修改为单例初始化：

  // 仅当serviceClient未初始化时创建实例
  if(serviceClient == null)
  {
      serviceClient = ServiceClient.CreateFromConnectionString(connectionString);
  }
  

• 检查IoT Hub配额与路由配置
  • 进入IoT Hub「用量 + 配额」页，确认当日C2D消息发送量未超过对应层级的配额限制，免费层每日仅支持8000条消息，超出后会被限流拦截。
  • 确认IoT Hub没有配置额外的消息路由规则拦截C2D消息投递。

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