Azure IoT Hub设备消息已统计但未转发到内置端点是什么原因？

首先明确：未配置自定义路由规则时，IoT Hub默认会将所有设备遥测消息转发到内置messages/events端点，无需显式重定向。你遇到的问题可按以下根因逐一排查解决：

常见根因 #

• 回退路由被禁用
  即使没有自定义路由，如果你在「消息路由」配置页手动关闭了回退路由，所有到达IoT Hub的消息都不会被投递到内置端点。
  「已使用消息总数」统计的是所有到达IoT Hub的消息，和后续路由结果无关，因此会有计数；「路由交付到messages/events的消息数」只统计成功投递到内置端点的消息，因此显示为0。查询资源管理器读取的是IoT Hub内置的消息留存缓存，因此即使路由投递失败，你仍能查到历史消息。
• 消息格式或类型不匹配
  如果你从Azure Sphere发送的消息没有显式设置contentType=application/json和contentEncoding=utf-8系统属性，会被路由判定为非标准遥测消息，不会投递到内置端点；如果你发送的是孪生属性上报、文件上传通知等非遥测类消息，也默认不会进入内置events端点。
• Azure CLI配置问题
  az iot hub monitor-events命令依赖azure-iot扩展，扩展版本过低、执行命令的账号没有IoT Hub数据读取权限，都会导致无事件输出。

解决步骤 #

• 启用回退路由
  进入IoT Hub控制台→「消息路由」→将「回退路由」开关设置为启用，端点选择events，数据源选择「设备遥测消息」，保存后等待5分钟再测试。
• 补充消息系统属性
  在Azure Sphere的消息发送逻辑中，显式添加两个系统属性，示例代码如下：

  // C语言示例，根据实际开发语言调整
  IoTHubMessage_SetContentTypeSystemProperty(msg_handle, "application/json");
  IoTHubMessage_SetContentEncodingSystemProperty(msg_handle, "utf-8");
  

  确认你发送的是普通遥测消息，不是属性上报、指令响应等其他类型消息。
• 修复CLI配置
  先升级azure-iot扩展到最新版本：

  az extension add --name azure-iot --upgrade
  

  确认当前登录账号拥有IoT Hub的「IoT Hub数据读取者」及以上权限，再重新执行监听命令：

  az iot hub monitor-events --hub-name <你的IoT Hub名称> --output table
  

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