读取系统配置(server data sysconfig)

验证状态:存在关键缺口,不可作为完整契约发布。Web 发送与应答消费已源码核验;采集服务器侧 data/v1 服务源码不在本工作区,字段全集与服务端校验缺证。 适用基线:源码归纳 @ 2026-09-14

用途与场景

读取采集服务器的系统配置(磁盘告警/停写阈值、上传并发与设备数上限、访问端口、流加密开关、中心域名等),用于系统配置设置页回显与配置信息展示页。本页是 server/{deviceNo}/data/v1/sysconfig 读取命令的唯一操作正本;写入见更新系统配置

使用位置

页面/功能 说明
系统配置设置页回显 订阅应答式请求(replyMethod get);应答逐键回填表单;首读失败 3 秒重试
配置信息展示页 直接发布;同一命令、reply 命名空间 .../information/config

对应 inventory operationId:mqtt-get-server-var-data-v1-sysconfig-ff578c0dmqtt-module-server-var-data-v1-sysconfig-3c07b24e

端点

MQTT 请求 server/{deviceNo}/data/v1/sysconfig(Web → Broker → 采集服务器直连,应答按 reply topic 回流;中心网关不消费)— 读取采集服务器系统配置(阈值、端口、流加密、中心域名等)。

通道口径:该 topic 不在中心消费/发布点清单内(网关默认订阅清单无 server/+/data/#,见MQTT 主题清单 · 服务端订阅面);应答回流、凭据与 QoS 等 wire 约定见MQTT 连接与消息边界

请求形态 JSON 对象 {id, reply, params:{}}(无 sub 成员),Web 固定发送空 params。

动线与完成判据

层级 判据
发布完成 publishAsync Promise 成功
请求关联 应答到达专用 reply topic 即消费;不校验 id 回显;无超时
业务完成 data 非空即视为读取成功并停止 3 秒重试;更新系统配置成功后页面清空缓存并立即重读

错误与边界

  • Web 消费代码无失败分支;服务器错误应答形态缺证。首读失败以 3 秒间隔无限重试。
  • 上表数值范围均为 Web 表单校验(前端约束),不能当作服务器端硬约束。
  • MQTT 族公共边界见MQTT 连接与消息边界

调用关系与资源清理

  • 更新系统配置构成读写对:更新成功后立即重读回显。
  • 应答订阅依赖会话级通配订阅;页面卸载仅摘除处理器并清空发送队列。

已知缺口

  1. 采集服务器侧服务源码不在本工作区:字段全集(提交时原样回传未消费键,故未知键会被带循环)、单位与服务器端校验、错误应答形态缺证。
  2. Broker ACL、服务器订阅证据与部署环境一致性待部署核验。