APP 常见问题

返回常见问题索引 · 跨端问题见全局 FAQ

本文汇总小程序 / APP 端高频问题。网关安装专项问题见网关安装 · 常见问题。

注册与登录

现象	可能原因与处理
添加后列表仍为空	确认添加成功提示；下拉刷新；检查是否登录正确账号
扫码失败	授权相机权限；对准设备二维码；光线不足时改用手工添加
无效二维码	格式须含模块 ID 与验证码；网关安装场景需 `模块SN;验证码`（英文分号）
手工添加失败	核对标签上的模块 ID、验证码，注意空格与大小写
提示设备已被绑定	设备可能已绑其他账号；联系管理员

与网关安装的区别：「添加设备」是把平台上已有设备绑到你的账号；「网关安装」是把新网关接入平台并下发南向。见网关安装。

现象	可能原因与处理
看不到设备面板图标	需租户配置 `app.device-panel` 且 `enable` 为 `true`；联系管理员
面板空白或加载失败	检查网络；确认设备在线；稍后重试
无法控制设备	设备可能离线；账号无控制权限；物模型未定义该服务

设备列表卡片底部可展示 关键实时数据（如出水温度、环境温度等），由租户配置 app.device-list.key-data 控制。

现象	可能原因与处理
列表卡片无温度等指标	租户未开启 `app.device-list.key-data`，或 `display` 为空
指标名称显示为 code	配置中未填写 `alias`，且设备未返回友好名称
指标显示 `--` 或无值	设备离线、未上报该数据项，或 `code` 与物模型不一致
配置已改但未生效	退出设备列表页后重新进入（`onShow` 会重新拉取配置）

配置说明（由管理员在租户配置中维护）：

json

{
  "enable": true,
  "display": [
    { "code": "OutletWaterTemp1", "alias": "出水温度" },
    { "code": "OutdoorTemp1", "alias": "环境温度" }
  ]
}

与 设备面板入口（app.device-panel）相互独立，可同时开启。设备面板图标问题见上一节。

网关绑定、南向选择、安装进度、定位等问题见专表：

跨端网关验收（三个成功信号、Modbus 排障）见网关与南向接入 FAQ。