读取服务列表（server data service）#

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

用途与场景#

读取采集服务器上受管服务的列表（名称、状态、健康与创建时间），用于服务设置页回显与服务信息展示页。本页是 server/{deviceNo}/data/v1/service 读取命令的唯一操作正本；重启服务见重启服务。

使用位置#

页面/功能	说明
服务设置页回显	订阅应答式请求（replyMethod get）；首读失败 3 秒重试；重启后倒计时结束再读
服务信息展示页	直接发布；同一命令、reply 命名空间 .../information/services

对应 inventory operationId：mqtt-get-server-var-data-v1-service-4e83bce9、mqtt-module-server-var-data-v1-service-c10c4c33。

端点#

MQTT 请求 server/{deviceNo}/data/v1/service（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 秒重试；重启倒计时（10 秒）期间暂停读取

错误与边界#

• Web 消费代码无失败分支；服务器错误应答形态缺证。首读失败以 3 秒间隔无限重试。
• state 的取值集由服务器侧决定（Web 仅做展示格式化），权威枚举缺证。
• MQTT 族公共边界见MQTT 连接与消息边界。

调用关系与资源清理#

• 与重启服务构成读写对：重启成功后页面清空数据、10 秒倒计时结束自动重读。
• 应答订阅依赖会话级通配订阅；页面卸载仅摘除处理器并清空发送队列。

已知缺口#

1. 采集服务器侧服务源码不在本工作区：字段全集、status 字段类型、state 权威枚举、错误应答形态缺证。
2. Broker ACL、服务器订阅证据与部署环境一致性待部署核验。