跳到主要内容

故障排查

按症状快速查找并解决问题。

容器模式框

如果 systemctl is-active plantpulse-edge.service 处于 active 状态则为容器模式 — 部分症状可通过 容器模式运维 的“故障处理”章节中的 场景矩阵（A~E）进行更快速的诊断。批量收集诊断信息：

sudo bash /opt/kopens/install/bin/doctor.sh
# → /tmp/pe-doctor-`<host>`-`<ts>`.tar.zst (support 전달)

快速索引​

症状前往位置
网关页面打不开页面打不开
无法登录无法登录
连接不上（PLC）连接不上
连接正常但无数据无数据
数据异常数据异常
数据突然中断数据突然中断
页面卡顿页面卡顿
内存/磁盘告警资源不足
云平台/SCADA 数据传输失败传输失败
标签[写入]失败无法写入值

页面打不开​

在浏览器中输入网关 IP 但页面无法显示。

第1步 — 确认 PC 能否看到网关​

在命令提示符中执行：

ping <gateway-ip>

如果没有响应，则是网络/线缆/VPN 问题。请告知系统管理员“网关不可见”。

第2步 — 尝试其他浏览器/用户​

如果其他 PC 上出现相同症状，则可能是网关本身宕机或挂起。需要系统管理员重启网关 PC。

第3步 — 检查 URL​

  • http://게이트웨이IP/ 是一般格式。
  • 有时会附带端口号（例如：http://게이트웨이IP:8080/）。
  • 如果不清楚公司内部标准 URL，请向同事确认。

无法登录​

忘记密码​

请尝试使用默认密码。

  • ID：admin
  • 密码：admin123!

如果环境已更改，请向系统管理员请求重置密码。

登录后立即被登出​

可能是会话/ Cookie 问题。请清除浏览器 Cookie 后重试。

连接不上​

[连接]页面中，卡片上的连接图标显示为**红色（Wi-Fi 斜线，工具提示为「断开」）**的情况。

第1步 — 同一台 PC 能否看到 PLC​

请要求系统管理员确认从网关 PC 是否能 ping 通 PLC 的 IP。

第2步 — 端口是否正确​

各 PLC 类型的默认端口：

PLC端口
OPC-UA (Kepware)49320
Modbus TCP502
三菱 (Q/L)5000 或 1029（根据 PLC 设置值）
三菱 (iQ-R)1500
西门子 S7102
LS2004
AB EtherNet/IP44818

PLC 侧的通信模块必须处于激活状态。

第3步 — PLC 侧安全设置​

PLC需要额外设置
西门子 S7在 TIA Portal 中启用“允许 PUT/GET 通信”并关闭 DB 的 Optimized 模式
三菱在 GX Works 中启用“MC 协议/ TCP/端口”
OPC-UA允许用户/密码或匿名访问
LS确保 ICMP（ping）未被阻止

第4步 — 用户名/密码​

对于像 OPC-UA 这样需要认证的 PLC，必须确保 ID/密码正确。请在 PLC 的[修改]表单中重新输入并尝试。

无数据​

卡片上的连接图标为绿色（已连接），采集标签也显示正常，但标签的[当前值]栏为空。

第1步 — 检查 PLC 地址格式​

这是最常见的原因。不同 PLC 类型的格式不同。

  • 三菱：D100、M50（前面没有 %）
  • 西门子：%DB1.DBW0（前面有 %，DB 编号 + DBW/DBD）
  • LS：D00309（5位数字）
  • OPC-UA：以 ns=2;s=경로 格式

请重新查看您所用 PLC 页面中的[PLC 地址格式]部分。

第2步 — 检查数据类型/格式辅助​

如果是 32 位及以上的值，而[格式辅助]为空，则可能被错误地按 16 位读取，导致值无法显示。

  • 32 位整数：格式辅助 = DW
  • 32 位浮点数：格式辅助 = REAL
  • 64 位浮点数：格式辅助 = LREAL

第3步 — 用其他工具验证同一地址​

请使用 PLC 编程工具（GX Works / TIA Portal / XG5000 / UA Expert）的监视/ Watch 画面确认同一地址是否实际工作。

数据异常​

数据能收到，但数值过大或过小，或正负号相反。

32 位被当作 16 位读取​

数值看起来随机或某一侧被截断。请在[格式辅助]中指定 DW（整数）或 REAL（浮点数）。

无符号值被当作有符号值读取​

例如：65535 被显示为 -1。请在[格式辅助]中指定 UI（16位无符号）或 UDW（32位无符号）。

byte/ word 顺序（endian）相反​

某些从站（常见于 Modbus 从站）以 little-endian 发送值时，32 位浮点数会显示混乱。

  • 如果是 Modbus，尝试使用像 :UDINT_LSWORD_FIRST 这样的数据类型表示变体
  • 其它 PLC 可能难以通过应用计算公式进行后处理，请咨询系统管理员。

单位不同​

PLC 发送整数原始值（例如：1638），而实际含义是 163.8 这样的值。请通过应用计算公式输入 ${VALUE}*0.1 进行单位转换。

数据突然中断​

一直正常接收的数据突然不再接收。

第1步 — 检查连接状态​

在[连接]菜单中，该 PLC 的连接状态如何？

卡片上显示的内容含义/下一步操作
连接图标为红色（工具提示「断开」）PLC 侧有问题。重启 PLC 或检查线缆/网络
采集标签为灰色「停止」有人点击了 ◼ 或自动停止。点击 ▶ 按钮恢复
采集标签为黄色「异常」采集正在进行但读取失败。查看卡片详情的[最后错误消息]
图标绿色+标签正常但无数据该 PLC 的该地址可能已停用
连接状态是图标而非文字

请勿在卡片中寻找「连接失败」这样的文字 — 没有。连接状态是右侧的 Wi-Fi 图标，而「连接/断开/未知」是鼠标悬停时才会出现的工具提示。 「正常连接/连接失败」这类文字是主屏幕网络面板中的另一项内容。

第2步 — 检查 PLC 本身​

  • PLC 是否处于 RUN 模式（如果变为 STOP，数据会停止）
  • 该地址区域的内存保护设置是否被更改
  • 如果刚更新固件/重启 PLC，稍等片刻即可自动重连

第3步 — 重启网关​

通过[设置]→[应用重启]来重启网关本身。约 1 分钟内恢复。

页面卡顿​

当 PLC 数量过多或标签过多时，首次加载可能会延迟 1~2 秒。

  • 通常这不是大问题。
  • 如果主屏幕的 CPU 仪表显示红色，则可能是网关 PC 资源不足。请咨询系统管理员。

资源不足​

主屏幕的 CPU/内存/磁盘仪表显示为红色的情况。

仪表处理方法
CPU检查是否有 PLC 使用了过短的采集周期。请将其调整为 1 秒以上
内存可以通过[设置]→[应用重启]暂时解决。如果反复出现，请向系统管理员申请增加内存
磁盘[设置]→[临时文件清理]。也可能是因为时序保留周期过长

传输失败​

数据采集正常，但无法传输到云平台/SCADA/MQTT。

MQTT/Sparkplug 未发布​

  • 请系统管理员确认“MQTT 激活状态”
  • 确认同一网关 PC 上 MQTT 代理（如 HiveMQ 等）是否正在运行

平台 API 无响应​

  • 无法连接到 PlantPulse 平台本身 → 联系总部/运维团队
  • 网关本身会将数据堆积在队列中，因此短时间断连会自动恢复。

有关系统管理员的详细日志关键字/日志位置，请参阅高级 — 开发者笔记。

最后手段​

  • 通过[设置]→**[下载日志]**批量下载诊断日志
  • 通过[设置]→**[应用重启]**重启网关（1 分钟）
  • 通过[设置]→**[系统重启]**重启 PC 本身（3~5 分钟）

如果问题仍未解决，请将下载的日志作为附件发送给 KOPENS 或 PlantPulse 运维团队。

无法写入值​

点击标签行末尾的[写入]图标时，出现“写入失败”/“driver returned false”等消息的情况。

按协议区分写入支持情况​

写入功能因 PLC 类型而异。

您使用的 PLC写入支持备注
三菱 (MELSEC)✅ 支持Q/L/iQ-R 均支持
西门子 (S7)✅ 支持DB/M/I/Q 区域
OPC-UA (Kepware 等)✅ 支持需要目标节点的写入权限
Modbus TCP✅ 支持Holding Register / Coil
HTTP 推送✅ 支持（缓存）—
LS ELECTRIC (XGI/XBC/XBM)✅ 支持Bit/Byte/Word/DWord/Float/Double
AB EtherNet/IP✅ 支持根据 PLC 固件/补丁可能拒绝某些类型

常见消息​

消息含义/处理方法
쓰기 실패 (opc_type=...)驱动返回 false。检查地址格式、数据类型（format）、PLC 的写入权限
tag not found: ...标签 ID 错误。刷新后重试
scheduler not running for opc_id=...该 PLC 处于[停止]状态。点击[启动]按钮后重试
OPC ... 가 PLC 와 연결되어 있지 않습니다在 DISCONNECTED 状态下尝试写入 — 检查 IP/端口/防火墙后重启

仍然不行​

  • 请告知系统管理员 [PLC 类型 + 标签 ID + 完整消息]。
  • 可以在网关日志中查看更详细的原因。