查常见问题

按安装、接入、数据、画面、权限、运维六组列出现场会遇到的现象、原因和处理。每条都链到写清步骤的那一篇。

  • 入门
  • 动手约 15 分钟
  • 阅读 4 分钟
  • 更新于 2026-11-09

你将完成

读完本篇你将完成:

  • 按现象找到原因,而不是从零翻完全部文档;
  • 知道下一步该打开哪一篇把事情做完。

开始之前

安装#

浏览器打不开 8080#

原因:端口被别的程序占用,或安装时改过 Web 端口。处理:换一组端口重装,或改用安装时填写的端口。见安装与部署。

工控机本机能开,车间电脑不能开#

原因:Web 只绑了本机,或防火墙没放行。处理:确认 --bind 不是 127.0.0.1,并只放行 Web 端口。不要放行 8999 和采集引擎端口。见端口与防火墙。

打开是空白页#

原因:页面服务在,静态文件没起来,或浏览器打到了别的端口。处理:在工控机上分别访问 Web 的 /healthz 和灵犀·Studio 服务的 /health,都应返回 200。见安装与部署。

登录后菜单很少#

原因:这个账号的角色没有页面权限。admin 能看到全部菜单。处理:管理员在 系统管理 → 角色管理 里勾选页面。见角色与权限。

接入#

测试连接超时,通信列失败#

原因:IP、端口、模拟器没启动,或中间网络不通。处理:先 Ping,再做端口检测,然后核对添加设备时的端口。见网络配置与诊断和接入 Modbus TCP 设备。

能 Ping 通西门子 PLC,测试连接仍失败#

原因:S7-1200 / 1500 未允许 PUT/GET,或要读的 DB 仍是优化块。处理:在博图里打开远程 PUT/GET,并取消该 DB 的优化访问。见接入西门子 S7。

值总是偏一个地址#

原因:地址从 0 开始 和设备约定不一致。处理:40001 对应地址 0 的设备保持「是」;从 1 编址的改为「否」,改完下发。见地址与数据类型速查。

16 位正常,浮点或 32 位整数完全不对#

原因:字节序不一致。默认是 CDAB。处理:用 format=ABCD;、CDAB、BADC、DCBA 试读,把对的那一项写回 高低字节排列顺序。见地址与数据类型速查。

报 Data read out of bounds#

原因:地址超出设备开放的范围。处理:对照手册里的最大地址;传统 40001 不要原样填进地址框。见协议调试与排错。

三菱的位和字读串了#

原因:M、X、Y 配了字类型,或 D 配了 Bool。处理:位软元件用 Bool,字软元件用 Int16 / UInt16 或更宽的类型。见接入三菱 MC。

保存了设备,监控里没有值#

原因:没有下发。保存只改页面上的配置。处理:看到 配置发生变更,下发后生效 后点 下发 → 立即下发。见添加设备。

提示同一设备内已有同名点位#

原因:这台设备里名称重复。处理:改名后再创建。不要靠大小写或空格假装成两个点。见配置采集点位。

数据#

选了分组,右侧却没有实时值#

原因:分组里没有点,或点还未下发,或筛选把行滤掉了。处理:清空搜索和状态筛选,确认采集配置里这个测点组有点并已下发。见查看实时数据。

历史查询说该时间段没有数据#

原因:这段时间没有写入,或保留策略已经清掉。处理:缩短到刚刚有实时值的几分钟再查;仍没有则看存储策略。见历史数据与趋势和数据存储与保留策略。

规则已下发但不报警#

原因:条件没成立、点位没在刷新,或布尔规则的位和字典项不一致。处理:先在实时数据里确认这个点的当前值,再对照规则类型。见配置告警规则。

测试发送成功,真告警没收到#

原因:规则没有绑这个通道,或通道被停用。处理:在规则详情里添加通道,并看发送日志里是不是测试记录。见告警通知渠道。

计算点位显示不确定或异常#

原因:表达式引用的点没有值,或类型对不上。处理:先让源点位在实时数据里正常刷新,再看虚拟点位的最近错误。见虚拟点位与表达式。

画面#

组态绑定后数值一直是 --#

原因:点位路径绑错,或该点没有实时值。处理:从数据里重新把测点拖到属性上,并确认监控里这个点有数。见图元与变量绑定。

发布后现场还是旧画面#

原因:运行的是已发布版本,设计器里的修改要再次发布。显示终端也要重新进开机画面。处理:再发布一次。见发布与现场运行和现场显示终端。

大屏指标卡一直是 --#

原因:数据源没有绑到有值的点位,或点位名为空。处理:在实时点位源里重新选择,并确认预览时该点有数。见数据大屏。

按钮点了没反应#

原因:动作没配完,或当前账号不能写值。处理:先做一次干运行,再核对写值权限。见按钮动作与写值。

权限#

改了角色,用户说界面没变#

原因:权限在登录时下发。处理:让该用户退出再登录。见角色与权限。

新建用户登录后什么菜单都没有#

原因:没有绑定带角色的岗位。处理:在用户详情的 岗位与角色 里绑定。见用户与组织。

忘记了某个用户的密码#

原因:要由有重置密码权限的管理员代设新密码。处理:打开该用户详情的 账号安全,填写新密码并点 重置密码。看不到这个页签,是当前账号没有该权限。见用户与组织。

多次输错密码后登不上#

原因:安全设置 里开启了失败锁定,次数用尽。处理:等锁定时间结束,或请管理员处理。见首次登录与初始化。

运维#

在线检查更新失败#

原因:这台机器访问不了发布源。当前版本不会被改掉。处理:恢复出站网络后点 重新检查;不能出站时用模块包。见升级与回滚。

更新过程中页面打不开#

原因:灵犀·Studio 服务正在重启,通常 2~5 分钟。处理:不要关机。超时仍打不开时,在设备上执行 iiot-installer update list 看是否已回滚。见升级与回滚。

恢复备份后点表没回到旧的#

原因:恢复时没勾选采集配置,或业务数据还在等重启。处理:采集配置勾上会立即写回;数据库和采集历史要到 系统维护 执行 重启系统。见备份与恢复。

一体机开机停在「正在进入系统…」#

原因:服务尚未就绪。开机页每 3 秒重试。处理:等待;若变成「显示终端无法启动」,按页面上的原因处理,不要先重装。见现场显示终端。

下一步#

这篇文档对你有帮助吗?