常见问题及解决方法

本章按具体问题分节（现象 → 原因 → 处置）。遇到报错请先查本章，再查附录《错误码》。
标「已修复」的条目来自真机验证，注明修复版本。

新建服务 / 测点时报错，但配置看着都对

现象：保存服务或导入测点时失败，提示与字段无关（如「服务数超限」「点数超限」）。

原因：授权（License）余量不足。DASS 的授权分数据库授权与服务数授权两条通道，分别导入、缺一不可。

处置：打开「监控 → 设备状态」，查看 license_point（点数上限）与 used_point（已用）余量；不足时导入相应授权文件后再试。

接口里的 deviceCode 到底是什么？

现象：调用接口（或在「连接管理」页面）看到 deviceCode，与设备标签上的序列号对不上。

原因：deviceCode 是控制台 sys_conn 表里连接记录的自增主键 ID，创建连接时先用自增 ID 覆盖了网关返回的真实设备码。不是设备盒子码、不是机器码、不是网关序列号。

处置：从 GET /api/mlinkClient/system/conn/list 的 data.all.list[].deviceCode 取；绝大多数接口把它放在 URL 路径里（如 /config/das/tree/{DeviceCode}）。

导入测点报 ID 相关的错误

现象：点表里 ID 列留空或填了小数字，导入失败。

原因与处置：

测点类型	ID 口径
采集测点 / 计算测点	ID 非必填。留空 = 未指定，由设备端实时库自动分配；有值时必须 ≥ 1024 且为整数
上传测点	ID 必填，且是"已存在的采集点 / 计算点 ID"的引用（无自增语义）

早期版本对采集/计算测点也强制 ≥1024，已于 V5.4.0 修正为"空值不校验"。

保存服务 / 通道 / 测点时报长度或取值不合法

现象：提示「服务名超长」「点名超长」「比例系数不能为 0」「量程上限必须大于下限」等。

原因：字段有硬约束，见 2.2 默认参数。

处置（最常踩的四条）：

提示	约束
服务名超长	服务名 ≤ 11 字节（中文按 3 字节算）
点名超长	点名 ≤ 60 字节（最多 20 个汉字）；且不可含 .
比例系数（FK）	不能为 0（默认 1）
量程上限（TV）	必须大于量程下限（BV），默认 100 / 0

测点状态一直显示 timeout

现象：测点值不更新，状态列显示 timeout。

原因：**分辨率（FQ）**口径 —— 实时点的更新间隔 > 1.5 × FQ 秒即判为超时（FQ 默认 1，即 60 s）。

处置：确认采集地址（AD）正确、设备在线、驱动已装；若设备本身上报周期较长，把 FQ 调大以匹配实际周期。

【Ping】显示端口关闭，但设备上该端口其实是开的（已修复）

现象：诊断 → Ping 页对某端口探测，结果误报"关闭"。

原因：后端在该场景返回的是 Go 原生错误文本（如 connection refused 与 i/o timeout 未区分），前端据此误判。

处置：升级到 V5.4.0 及以上（已修复）；同时新版把诊断记录按设备隔离并改为等宽日志，便于比对。

服务启停按钮状态闪回 / 延迟十几秒（已修复）

现象：点【停止】后按钮先变"运行中"再变"已停止"；或状态延迟 6～30 秒才刷新。

原因：① 前端在过渡期只等固定时长就放开按钮；② 后端 pid 缓存失效导致状态误判并回写。

处置：升级到 V5.4.0 及以上（已引入"启动中/停止中"过渡态 + pid 身份校验 + 主动停止不回写状态），并去掉服务启停/重启的二次确认弹窗。

上传测点页勾选后丢失、翻页出现空白（已修复）

现象：勾选若干测点后翻页，选中项消失；或最后一页出现空白行。

处置：升级到 V5.4.0 及以上（该版本修复了上传测点页选中丢失、分页越界空白等 9 项问题）。

界面改版后仍看到旧页面 / 旧数据

现象：我们更新了控制台，但浏览器里还是老界面。

原因：浏览器缓存。

处置：强制刷新（macOS ⌘⇧R、Windows Ctrl+F5）；仍不生效时清空站点缓存后重登。

双机热备开启后，很多操作按钮点了没反应

现象：开启双机热备后，服务启停/重启、通道启停/挂起等操作不可用。

原因：设计如此 —— 热备期间由主备切换与实时库双向镜像保证一致性，人工启停会破坏同步。

处置：需先关闭双机热备再操作。热备期间允许：服务 / 通道 / 测点的增删改（自动同步）、只读查询、状态监控；禁止：服务启停重启、通道启停挂起、直接改实时库数据。

双机热备的备机上无法操作

现象：处于休眠（备机）状态的节点上，界面操作被拒绝。

原因：设计如此 —— 休眠端禁止操作（V5.4.0 起强化），避免主备数据分叉。

处置：在主用节点操作；确需在备机操作时先做切换。

采集地址（AD）该填什么？

现象：新建测点时不确定「地址信息（AD）」怎么填。

原因：AD 的含义与格式由驱动决定，不统一。

协议	AD 填什么	示例
Modbus	设备号.功能码.地址	1.3.0
其他 PLC	寄存器地址	D100、DB1.DBX0.0
MQTT	订阅主题	/device/sensor/temp
OPC-UA	节点 ID	ns=2;s=Temperature

处置：填之前先看对应驱动的说明书；Modbus 的完整寻址表见附录《Modbus 地址说明》。

现场问题反馈渠道

若本章与附录《错误码》都未能解决，请记录现象、时间点、涉及设备与操作路径，按前言中的联系方式提交，或使用「应用市场 → 问题反馈申请」表单。