故障排查
先记录发生时间、逻辑设备UUID、productId/physicalId、客户端版本、固件版本和阶段；不要收集或粘贴密码、Token和签名URL。先读状态后操作，不通过删库/改epoch/重刷碰运气。
配网停在连接设备
确认板子进入物理配网窗口、手机BLE权限开启、未被另一台手机占用。PROFILE_MISMATCH缺claim时核对服务与完整特征列表，正式固件info/claim与旧探针echo不同；iOS可能保留旧GATT缓存，关闭旧会话、重新开蓝牙/重启外设后复测。不能跳过claim特征继续。
setBLEMTU失败后若getBLEMTU返回真实可用值，可以继续；只看MTU警告不能判定失败。真机调试记录operation与errCode；开发者工具Build目录应是dist/build/mp-weixin，不把手机旧缓存当最新源码。
WiFi已连，确认账号绑定超时
按顺序查：手机是否拿到claim票据 → 设备是否取得IP → TLS证书/主机名/内存 → MQTT CONNACK和订阅 → binding claim/prepare/ready/commit/active。蓝灯常亮只表示STA关联。
设备串口出现mbedtls内存错误时检查BLE票据接受后是否释放manager/security、动态TLS缓冲配置及应用版本；不能关TLS。后端只出现票据无runtime/transition通常说明设备消息还没到。出现ready没有active则检查清理NVS和commit确认，不把绑定直接标completed。
设备已绑定其他账号时须原拥有者解绑。重刷后用新小程序携带selfProvisioning摘要字段才能恢复未绑定身份，旧手机代码会提示不可认领。不要绕过仍绑定/停用身份保护。在线解绑后清理尚未送达前不要立刻断电验证清理结果。
在线但状态不更新
查后端MQTT订阅成功日志和Broker SUBACK，而非只有Connected。检查是否复用真实ClientId导致相互踢线，本地普通API开发关闭MQTT。Redis120秒TTL与10秒扫描决定离线显示约130秒；传感器心跳不等于新测量。
客户端退出后台/断网后应重连Socket.IO并重新拉HTTP快照；当前事件不持久补发。控制成功要看原设备明确code200与实际回报，不能只看外层HTTP成功。
参数一直待同步/冲突
读取configuration的revision、acceptedRevision、appliedRevision、syncStatus和items，核对当前owner/epoch/bootId及能力modelRevision。pending多为未收到，pending_restart需重启，failed查看具体项并仅重试当前即时失败项。不要连续点保存增加版本。
迟到查询不能污染更新后状态；若仍出现conflict，记录触发请求msgId与查询观察状态，先区分真实设备回滚/快照不一致。不要手工把appliedRevision改成新值或清空执行日志。开发环境重建归属时明确接受配置清理后，走正常解绑/配网，不保留旧任务偷偷重放。
定时/延时未触发
- 确认设备支持该可写属性，规则云端与设备revision一致且applied。
- 日历定时需成功校时；检查固定timezoneMinutes、周位图、整分钟和未来日期。停电错过不补执行。
- 已执行一次规则只启停不会复活；修改执行含义必须新ID，小程序自动生成。
- 重启取消倒计时；手动操作成功也取消同属性倒计时。同属性新延时替换旧延时。
- 看执行前reserved持久记录与硬件返回错误；掉电后不自动重放可能已执行动作。定时不是云端在线轮询任务。
“上一项操作”持续不消失时查原call_reply是否解析/落库失败并释放占用；服务deadline30秒、租约35秒、记录120秒，禁止仅调大超时。
历史为空或更新慢
先确认属性为只读数值；继电器无历史是产品行为。Influx查询最长31天且聚合5分钟/1小时/6小时，所以曲线点数不等于每次采样。核对org/bucket/token、measurement=device_properties、device_id/property标签以及后端写入/查询警告。缺失可选光照不显示数值，不能填零制造“正常”。
OTA、烧录与部署
OTA网络错误查签名期限、OSS可达/CA链和内存；“新版本未通过启动校验，已回滚”表示旧槽恢复，检查新版本启动日志而非反复点升级。正常数据采集不能阻塞启动验证等待MQTT。网页烧录停在下载阶段先查OSS，写入阶段才查串口、占用和波特率。工厂镜像全片覆盖会清WiFi/身份，应用更新不能替代首次双分区初始化。
部署慢/异常分开看API、静态资源和OSS；对照Actions本次SHA、current、PM2及健康接口。只回滚应用不回滚数据库。证书/明文监听排查见EMQX。