主题
APP 常见问题
本文汇总小程序 / APP 端高频问题。网关安装专项问题见 网关安装 · 常见问题。
注册与登录
| 现象 | 可能原因与处理 |
|---|---|
| 不知道租户 ID | 向企业管理员或平台服务商索取；注册与登录均必填 |
| 注册失败 | 检查租户 ID、手机号、验证码、密码（建议 ≥6 位，含字母数字） |
| 登录提示账号或密码错误 | 账号格式须为 手机号@租户ID，如 13800000000@test |
| 收不到验证码 | 检查手机号与短信拦截；稍后重试 |
| 微信绑定失败 | 按授权提示操作；可选「暂不绑定」，后续在个人中心重试 |
添加设备
| 现象 | 可能原因与处理 |
|---|---|
| 添加后列表仍为空 | 确认添加成功提示；下拉刷新；检查是否登录正确账号 |
| 扫码失败 | 授权相机权限；对准设备二维码；光线不足时改用手工添加 |
| 无效二维码 | 格式须含模块 ID 与验证码；网关安装场景需 模块SN;验证码（英文分号） |
| 手工添加失败 | 核对标签上的模块 ID、验证码，注意空格与大小写 |
| 提示设备已被绑定 | 设备可能已绑其他账号；联系管理员 |
与网关安装的区别：「添加设备」是把平台上已有设备绑到你的账号；「网关安装」是把新网关接入平台并下发南向。见 网关安装。
详细操作：添加设备与可视化控制 · 快速上手：APP 终端用户
设备面板
| 现象 | 可能原因与处理 |
|---|---|
| 看不到设备面板图标 | 需租户配置 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": "环境温度" }
]
}| 字段 | 说明 |
|---|---|
enable | true 开启关键数据区域 |
display[].code | 数据项 code，须与物模型/设备数据项一致 |
display[].alias | 卡片上的标签文案（可选） |
与 设备面板入口（app.device-panel）相互独立，可同时开启。设备面板图标问题见 上一节。
网关安装
网关绑定、南向选择、安装进度、定位等问题见专表：
跨端网关验收（三个成功信号、Modbus 排障）见 网关与南向接入 FAQ。
需要帮助时
- 模块 SN、验证码、二维码格式以设备厂商说明为准
- 南向配置、档案字段、权限由管理员在 Web 后台配置；选项缺失请联系管理员
- 更多 Web 端问题见 Web 详细 FAQ