常见问题与故障排查 (FAQ)

本章整理了新用户在使用 DTS（数字孪生服务）接入和配置过程中，最常遇到的问题及详细排查步骤。

1. 属性上报成功，但实体详情中显示为“无数据”？

可能原因： - 产品 Profile 未发布：在创建/编辑产品 Profile（属性/事件/服务）后，必须点击右上角的 “发布” 按钮。未发布的 Profile 不会被平台的数据流网关识别。 - 标识符大小写不匹配：设备上报的字段 Key（如 temperature）与产品 Profile 定义的属性标识符（如 Temperature）大小写不一致。DTS 的字段绑定是区分大小写的。 - 设备未关联网关：检查网关详情中，是否已将该产品加入到“关联产品”列表中。

2. 网关自定义消息解析脚本执行时抛出 Sandbox Exception？

可能原因： - 使用了禁用的语言特性：DTS 消息解析脚本是在安全的沙箱隔离环境中执行的。脚本中禁止使用 Node.js 的原生 require、fs 模块、eval、以及多线程/进程控制语句。 - 全局变量冲突：请确保所有局部变量皆使用 var、let 或 const 声明，禁止污染沙箱全局命名空间。

3. 配置的任务（规则引擎）没有触发？

排查步骤： - 生效条件限制：检查任务是否设置了生效时间段（如“生效条件 - 安全锁”），确保当前测试时间在生效窗口内。 - 属性更新触发模式：DTS 任务属于“变动触发”。如果上报的属性值未发生改变（例如连续两次上报温度均为 25 且条件是 > 25），则不会重复触发执行动作。 - 查看执行日志：在任务管理界面，点击当前任务的 “执行日志”，查看具体的规则匹配判定过程。