Azure IoT Central接入TTN设备数据全为未建模数据如何解决

问题根因 #

• 上报Payload违规使用系统保留字段：你当前上报的报文直接使用了IoT Central系统保留字段_unmodeleddata作为业务数据的父节点，该字段仅用于平台侧自动存放不匹配模型的内容，第三方集成主动上报该字段时，字段下所有数据会被直接归类为未建模数据。
• 字段路径完全不匹配：你定义的DTDL模型中，energy/flow/fw等遥测项均为根层级字段，但实际业务数据（仪表解码后的读数）埋在_unmodeleddata.uplink_message.decoded_payload的三级嵌套路径下，平台无法自动递归匹配嵌套路径下的字段。
• DTDL模型存在拼写错误：主接口DTMI命名空间为dtmi:zhlerauslesung:*，组件引用时错写为dtmi:zHlerauslesung:CMI4160_537;1，大小写不匹配会导致组件识别失败，连带影响整体模型匹配。

异常界面参考：

修复步骤 #

• 第一步：调整TTN侧集成的上报格式
  禁用当前直接透传TTN全量LoRaWAN上行报文的配置，在TTN的Azure IoT Central集成规则中添加报文转换，不要使用_unmodeleddata作为数据key，将uplink_message.decoded_payload下的仪表读数字段直接提取到Payload根层级，转换后的标准上报报文示例如下：

  {
    "energy": 0.3,
    "flow": 0,
    "fw": 69.2,
    "id": 72811808,
    "rt": 72.5,
    "volumen": 29461.29
  }
  

  如果需要保留RSSI、SNR、网关位置等LoRa网络元数据，可以单独在DTDL模型中添加对应字段定义，不要直接透传整个TTN原始报文。

  若不想修改TTN侧配置，也可直接在IoT Central设备模板的「入站数据映射」功能中配置转换规则，将嵌套路径下的字段映射到根层级对应遥测项。

• 第二步：修正DTDL模型错误
  1. 统一DTMI命名空间大小写，将组件引用的dtmi:zHlerauslesung:CMI4160_537;1修改为和主接口一致的dtmi:zhlerauslesung:CMI4160_537;1；如果该组件无实际业务用途，直接删除该组件定义避免匹配报错。
  2. 确认所有遥测、属性字段的name值和实际上报的字段名完全一致（注意大小写敏感），数据类型和上报值匹配，你当前定义的数值类型字段均为double，和上报的数值类型兼容无需调整。
• 第三步：重新生效配置
  保存修正后的设备模板并发布，清除对应设备的历史未建模数据缓存，等待设备新的遥测上报后，字段就会自动匹配到模型定义的对应项中，不会再被归类到未建模数据分类下。

注意事项 #

IoT Central的遥测匹配是大小写敏感的，字段名、DTMI路径的大小写必须完全一致才能正常匹配；除_unmodeleddata外，_eventtype、_timestamp也属于平台保留字段，非必要不要主动上报同名业务字段。

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