接口清单(联调的地基)

源系统 目标系统 方式 信号/字段定义 触发条件 时序 责任方 验证
消防 门禁 干接点 常开/常闭 报警 ≤ 5s

没有这张表,联调必然变成互相甩锅。

单系统调试都正常、一联调就出问题,怎么定位
图片素材来自免费商用图库(pixabay,摄影师 xresch),非本站项目实拍。

常见接口方式的坑

方式 典型坑
干接点 常开/常闭定义反(动作相反)、接点容量不足、共地
Modbus/BACnet 寄存器地址、数据类型、字节序、点表版本不一致
API 鉴权、字段命名、超时重试、同步/异步理解不同
时序 没写延时要求,并发时互相阻塞

单系统自测要「留证」

上游:确实输出了吗?(信号灯 / 日志 / 报文)
下游:确实接收了吗?(接收日志 / 状态变化)

两边都拿证据,才能快速判断断点在哪。

联调顺序:自下而上

物理层/网络 → 逐对接口 → 跨系统场景 → 回归

不要把所有系统同时接上一次性调试。

问题单与闭环

现象 复现步骤 责任方 修复 验证

未闭环的问题不得进入验收;改动接口后必须重跑回归测试,并归档最终点表与配置。