常见问题
这里汇总了使用 ZhiLian.Yun 时最常见的排查问题。找不到答案时，请浏览 技术支持。
设备相关
设备显示离线，如何排查？
- 在「消息日志」中查看设备最近的消息，确认最后一条报文时间。
- 检查设备网络是否正常，心跳是否按周期发送。
- 检查设备类型的在线超时时间设置：若心跳周期大于在线超时时间，设备会反复"上线-离线"。
- 设备连接还在但长时间不上报数据时，设备仍显示在线；判断设备是否真正工作请以最后活跃时间为准。
子设备离线怎么办？
子设备的上下线由网关代报。子设备离线时先确认网关是否在线；网关离线时其下所有子设备会同时离线。
设备连接 MQTT 报 not authorized？
- 确认使用的是设备证书中的用户名与密码，不要与项目级 MQTT 凭据混用。
- 确认连接的接入点域名与设备所在区域一致。
- 设备被禁用（设备详情中的启用状态为"禁用"）时也会被拒绝连接。
数据相关
属性历史数据查不到？
- 确认设备类型的功能定义中该属性开启了历史存储，未开启的属性不保留历史值。
- 确认查询的时间段内设备确实上报过数据。
下发显示"成功"，设备却没有反应？
接口或控制台返回 200 只代表平台已受理，设备是否执行成功要以「属性设置回复」「功能调用回复」消息中的设备返回码为准（200 为成功）。请在「消息日志」或命令记录中确认设备返回码与回复内容。
任务执行失败？
见 任务日志 的排查清单，常见原因是执行时刻设备离线或设备未应答。
应用与面板相关
App 里面板没有更新？
面板配置按设备类型发布，修改后让用户退出设备页重新进入即可加载新面板。
用户收不到告警通知？
依次检查：告警规则是否关联了通知方式 → 通知组是否启用 → 项目短信/电话配额是否有余额 → 用户是否在免打扰时段或已达到每日通知上限。详见 通知配额与免打扰。
其他
导出提示"没有查询到可导出的数据"？
确认筛选条件下确实存在数据；部分历史数据依赖功能定义的「历史存储」开关，未存储的数据无法导出。
忘记密码？
在控制台登录页点击「忘记密码」，通过注册邮箱自助重置；没有绑定邮箱的账号请联系项目管理员处理。