故障排查

端点打不开

TCP 服务端报地址占用时换一个空闲端口，并同步修改客户端。客户端连接拒绝时确认服务端先打开、地址可达。串口打不开时检查路径、设备占用和系统权限。

先用本机 TCP 教程排除远程网络和硬件因素，再逐步接入真实环境。

发送了却收不到

确认发送的是正确端点与远端，服务端没有自动回显。UDP 本地打开不代表目标在线。TX 只说明本地发送动作，接收和业务响应还要另外核对。

有字节但不成帧时，检查分隔符、固定长度或空闲超时，先切回原始接收定位。TCP 拆包或合包不等于应用丢失数据。

字节或数值不对

HEX 和 Text 不同：48 65 在 HEX 中是两个字节，在 Text 中是五个字符。检查 CRLF、发送分帧和 JSON 重新序列化。

Modbus 数值异常先核对协议/参考地址、偏移、类型、字节序、字序与缩放；DL/T 645 则核对表地址、DI、BCD、小数位和长度。

历史或趋势为空

放宽查询时间、方向和关键词；确认使用的是产生记录的运行环境。Modbus 点必须启用保存历史，并实际执行读取。刚启动但从未采集的点不会有过去的数据。

检查采集待写入、失败批次和磁盘状态。配置导入不会带来旧消息和日志。

准备反馈

提供版本、运行环境、最小配置、操作步骤、预期/实际结果及一对请求响应。用模拟端或脱敏数据复现可以减少无关信息，见反馈页面。