主题
98. 常见问题
返回目录 | 上一章：审计、消息与知识库 | 下一章：附录
跨端问题可先查阅 常见问题索引。
本章节汇总了 Web 端 系统使用过程中的常见问题和解决方案。
与「常见问题索引」的分工
| 文档 | 定位 | 适合场景 |
|---|---|---|
| 常见问题索引 | 跨 Web / APP 的专题 FAQ，按角色与现象导航 | 租户 ID、网关验收、设备离线、多级组织等跨端问题 |
| 本章（Web 详细 FAQ） | Web 端菜单、权限、固件、视频、Dashboard 等细项 | 登录后菜单缺失、权限代码、Web 特有功能排障 |
建议：先查 常见问题索引 定位专题；若问题明确发生在 Web 某菜单或权限上，再在本章按章节检索。APP 端问题见 APP 常见问题。
98.1 登录相关问题
Q1: 无法登录系统？
可能原因及解决方案：
账号或密码错误
- 检查账号和密码是否正确
- 注意大小写和特殊字符
- 如忘记密码，使用"忘记密码"功能重置
账号被禁用
- 联系管理员检查账号状态
- 如账号被禁用，需要管理员重新启用
网络问题
- 检查网络连接是否正常
- 检查系统地址是否正确
浏览器问题
- 尝试清除浏览器缓存和 Cookie
- 尝试使用其他浏览器
- 检查浏览器是否支持（推荐 Chrome 80+）
Q2: 登录后自动退出？
可能原因及解决方案：
Token 过期
- 系统 Token 可能已过期，重新登录即可
- 如频繁过期，联系管理员检查 Token 配置
账号被禁用
- 账号可能被管理员禁用
- 联系管理员检查账号状态
多设备登录冲突
- 系统可能限制多设备同时登录
- 检查是否在其他设备登录
98.2 权限相关问题
Q3: 看不到某些菜单？
可能原因及解决方案：
权限未开通
- 这是正常的权限控制机制
- 联系管理员开通相应菜单权限
角色未分配
- 检查是否分配了角色
- 联系管理员分配角色
菜单被禁用
- 菜单可能被管理员禁用
- 联系管理员检查菜单状态
Q4: 按钮不可点击或不可见？
可能原因及解决方案：
权限不足
- 按钮级权限控制，需要相应权限代码
- 联系管理员开通相应操作权限
数据状态限制
- 某些操作可能受数据状态限制（如离线设备无法控制）
- 检查数据状态是否符合操作要求
Q5: 访问页面提示无权限？
可能原因及解决方案：
路由权限未开通
- 页面需要相应的路由权限
- 联系管理员开通页面访问权限
权限代码配置错误
- 路由的权限代码可能配置错误
- 联系管理员检查权限配置
98.3 设备相关问题
Q6: 设备显示为离线，但实际在线？
可能原因及解决方案：
设备心跳超时
- 检查设备的网络连接
- 检查设备是否正常运行
- 等待设备重新上报心跳
网关离线
- 检查设备所属的网关是否在线
- 网关离线会导致其下所有设备显示离线
时间同步问题
- 检查系统时间是否准确
- 检查设备时间是否准确
Q7: 无法新增设备？
可能原因及解决方案：
权限不足
- 需要
device:info:create权限 - 联系管理员开通权限
- 需要
必填字段未填写
- 检查必填字段是否已填写
- 设备名称、产品型号、网关为必填项
设备标识符已存在
- 设备标识符必须唯一
- 修改设备标识符或使用其他编码
网关不可用
- 检查选择的网关是否在线
- 检查网关是否可用
Q8: 看不到设备数据？
可能原因及解决方案：
权限不足
- 需要
device:datapoint:realtime权限（设备级） - 联系项目/设备管理员分配设备角色
- 需要
设备离线
- 只有在线设备才能查看实时数据
- 等待设备上线
设备未上报数据
- 检查设备是否正常上报数据
- 检查设备配置是否正确
Q9: 无法执行设备控制命令？
可能原因及解决方案：
权限不足
- 需要
device:control:command权限 - 联系管理员开通权限
- 需要
设备离线
- 只有在线设备才能执行控制命令
- 等待设备上线
设备不支持该命令
- 检查设备的物模型配置
- 确认设备是否支持该控制服务
98.4 数据相关问题
Q10: 数据不准确或延迟？
可能原因及解决方案：
数据缓存
- 尝试刷新页面
- 数据可能有缓存延迟
权限限制
- 你只能看到有权限访问的数据
- 数据范围受权限控制
时间延迟
- 统计数据可能有延迟
- 等待片刻后刷新
Q11: 无法导出数据？
可能原因及解决方案：
权限不足
- 导出功能可能需要相应权限
- 联系管理员开通权限
数据为空
- 检查是否有可导出的数据
- 检查筛选条件是否正确
浏览器限制
- 检查浏览器是否允许下载文件
- 尝试使用其他浏览器
98.5 操作相关问题
Q12: 操作失败，提示错误？
可能原因及解决方案：
网络问题
- 检查网络连接
- 刷新页面重试
数据状态问题
- 检查数据是否符合操作要求
- 如删除操作，检查数据是否被其他数据关联
权限问题
- 检查是否有操作权限
- 联系管理员开通权限
系统错误
- 查看错误提示信息
- 如问题持续，联系技术支持
Q13: 页面加载缓慢？
可能原因及解决方案：
网络问题
- 检查网络连接速度
- 检查网络是否稳定
数据量大
- 使用筛选条件缩小数据范围
- 分页查看数据
浏览器问题
- 清除浏览器缓存
- 尝试使用其他浏览器
98.7 固件与 OTA 相关问题
Q17: 无法发布固件？
A: 检查固件是否处于草稿状态、文件是否上传完整，以及是否有 firmware:device:publish 权限。
Q18: 设备升级时找不到固件包？
A: 确认固件已发布（active）、适用产品包含该设备型号，且 OTA 协议类型匹配。
98.8 视频与可视化相关问题
Q19: 摄像头预览黑屏？
A: 检查摄像头在线状态、平台配置（AppKey/AppSecret）是否正确，以及浏览器是否允许播放视频。
Q20: Dashboard 无法预览或编辑？
A: 检查是否有 dashboard:project:view 或 dashboard:global:view 权限；编辑需项目级 dashboard:view 或全局管理权限；确认 go-view 服务可访问且浏览器未拦截弹窗。
Q21: 设备白标应用后未显示？
A: 确认模板已启用、目标设备产品型号与模板匹配，并刷新设备面板页面查看。
98.9 售后扩展问题
Q22: 维保任务无法生成工单？
A: 检查是否有 aftersales:maintenance:task:manage 权限，任务是否处于可执行状态。
Q23: 回访任务未自动生成？
A: 检查回访规则是否已配置并启用（aftersales:followup:config:manage），以及关联工单是否满足触发条件。
98.10 南向配置与 Modbus 相关问题
Q24: 刚买网关，从哪里开始？
A: 按 快速上手：网关接入 的流程操作：管理员先在 Web 配置并 发布 南向 → 现场用 APP 安装网关 → 在 Web 验证网关在线与设备数据。
Q25: 南向配置列表里没有可选项？
A: 安装网关或下发时仅显示 已发布 的配置。请管理员在南向配置详情中将配置发布。
Q26: Modbus 数据采上来但数值不对？
A: 依次检查：寄存器地址、读功能码（03/04）、字节顺序（ABCD/CDAB）、数据类型、数据转换表达式。表达式语法见 南向配置 4.3，Modbus 示例见 5.3 节。
Q27: 下发南向配置后设备仍离线？
A: 确认网关在线、RS485 接线与终端电阻、从站地址与波特率一致；下发后等待网关完成驱动加载与设备发现。
Q28: 数据转换表达式怎么写？
A: 在属性「运算方式」中配置，保存为 transform 字段。常用写法：
| 场景 | 表达式 |
|---|---|
| 寄存器放大 10 倍存温度 | MUL(0.1) |
| 线性标定 y = ax + b | LINEAR(a, b) |
| 取某一位开关量 | BIT(位号, 位号) |
| 取位后再缩放 | BIT_MUL(起始, 结束, 系数) |
完整语法见 南向配置 4.3；Modbus 现场 4 个配置示例见 5.3 节。
98.11 其他问题
Q14: 如何联系技术支持？
解决方案：
- 查看系统帮助文档
- 联系系统管理员
- 提交工单（如系统支持）
Q15: 如何反馈问题或建议？
解决方案：
- 通过系统反馈功能提交（如有）
- 联系系统管理员
- 提交工单
Q16: 系统更新后功能变化？
解决方案：
- 查看系统更新日志
- 查看用户手册更新内容
- 联系管理员了解变更
98.12 获取帮助
如果以上问题无法解决，可以：
- 查看用户手册：查看相关章节的详细说明
- 查看附录：查看术语表和权限代码说明
- 联系管理员：联系系统管理员获取帮助
- 提交工单：通过工单系统提交问题（如系统支持）
下一步：查看 附录 了解术语表、快捷键和权限代码说明。