📚 课程目录第3章联调环境总体架构设计

3. 联调环境总体架构设计

联调环境不是把几台设备接上网线就能工作的临时试验台，它本质上是一套“可编排、可观测、可复现”的分布式测试系统。要让它稳定支撑接口仿真与联调，第一步必须把五类角色在拓扑中的位置、职责边界和交互路径定义清楚：仿真节点负责替代真实对端产生或接收报文，被测设备是验证目标，代理网关承担协议转换与流量中转，监控工具负责旁路采集与实时观测，测试管理平台则统一编排用例、下发配置并汇总结果。它们之间不是简单的串联关系，而是“控制面 + 数据面 + 观测面”三面并存的拓扑结构。

一、五类角色的职责与接口边界

仿真节点通常以软件形式部署在服务器或容器中，按接口协议模拟上位机、PLC、传感器、云端服务等对端。它的关键接口是“业务数据接口”和“控制接口”：前者收发真实业务报文，后者接受测试管理平台下发的启动、停止、参数注入等指令。被测设备是真实硬件或待测软件模块，其对外暴露的物理端口、IP 地址、端口号、协议类型必须与仿真节点和代理网关的配置严格对应。

代理网关是拓扑中最容易被忽视却最关键的一环。它位于仿真节点与被测设备之间，可以工作在透明桥接、反向代理或协议转换三种模式。透明桥接模式下，网关只做二层转发，监控工具通过镜像口获取流量；反向代理模式下，网关终结一侧连接再向另一侧发起新连接，便于做协议适配和故障注入；协议转换模式下，网关把 Modbus TCP 转成 OPC UA、把 MQTT 转成 HTTP，使异构系统能够联调。监控工具一般以旁路方式接入，通过交换机镜像端口或网关的抓包接口获取报文，不参与业务转发，避免影响实时性。测试管理平台则通过管理网络与仿真节点、代理网关、监控工具通信，形成独立的控制通道。

二、三面分离的拓扑原则

把控制面、数据面、观测面分开，是联调环境设计的第一原则。控制面走管理网络，通常使用独立的 VLAN 或物理网段，例如 10.0.0.0/24，测试管理平台通过 REST API 或消息队列向仿真节点和代理网关下发指令。数据面走业务网络，例如 192.168.10.0/24，承载真实协议报文，要求低延迟、低抖动。观测面走镜像网络，监控工具的抓包口连接交换机镜像端口，只收不发，确保不干扰业务流量。

如果三面混在同一网段，会出现两个典型问题：一是管理指令的突发流量挤占业务带宽，导致仿真节点发送周期抖动；二是监控工具误发报文进入业务链路，造成被测设备收到非预期帧。因此，在交换机上至少划分三个 VLAN，并通过 ACL 限制跨面访问，只允许测试管理平台访问仿真节点和代理网关的管理端口。

三、典型联调链路的建立过程

以“仿真节点模拟 Modbus TCP 主站，被测设备作为从站，代理网关做协议转换与故障注入”为例，链路建立过程如下。首先在测试管理平台创建联调任务，填写仿真节点 IP 192.168.10.21、代理网关 IP 192.168.10.1、被测设备 IP 192.168.10.100，并选择协议模板 Modbus TCP。平台通过控制面向仿真节点下发启动指令，仿真节点开始按 100 ms 周期向代理网关的 502 端口发起读保持寄存器请求。

代理网关收到请求后，按配置决定是否转换协议。若被测设备支持 Modbus TCP，网关进入透明桥接模式，直接转发到 192.168.10.100:502；若被测设备只支持 OPC UA，网关将 Modbus 请求映射为 OPC UA Read 服务调用，再把响应转换回 Modbus 格式返回给仿真节点。与此同时，网关把双向报文复制一份到镜像口，监控工具实时解析功能码、寄存器地址、响应时间，并在界面上绘制时序图。

# 代理网关透明桥接模式配置示例（示例参数）
mode: transparent_bridge
listen: 0.0.0.0:502
upstream: 192.168.10.100:502
mirror_interface: eth2
fault_injection:
  enabled: true
  rule: delay
  target_function: 0x03
  delay_ms: 200
  probability: 0.1

上述配置表示：对 10% 的功能码 0x03 读保持寄存器请求注入 200 ms 延迟，用于验证被测设备在响应超时场景下的重试与告警行为。监控工具应能观察到部分请求的响应时间从正常的 5 ms 跳变到 205 ms 左右，测试管理平台据此判定“超时重试用例”是否通过。

四、拓扑设计中的关键参数与判断依据

联调环境拓扑是否合理，可以用几个可观测指标来判断。第一，控制面指令下发到仿真节点开始发送报文的时延，通常要求小于 500 ms；第二，数据面端到端时延，透明桥接模式下网关引入的额外时延应小于 1 ms，反向代理模式下允许 2～5 ms；第三，监控工具的抓包丢包率，在 100 Mbps 业务流量下应低于 0.1%；第四，三面之间的网络隔离是否生效，可以用仿真节点 ping 监控工具的管理地址，预期结果为不可达。

建议在拓扑落地前先画一张 IP 规划表，明确每个角色的管理 IP、业务 IP、端口号和所属 VLAN。仿真节点和代理网关的管理口与业务口尽量使用不同网卡，避免单点网卡故障同时影响控制与数据。

不要把监控工具串接在仿真节点与被测设备之间。串接会引入额外转发时延和故障点，一旦监控工具崩溃，整条联调链路中断。正确做法是使用交换机镜像口或网关的镜像接口旁路采集。

当联调规模扩大时，仿真节点可能从 1 个增加到 10 个以上，代理网关也可能按协议类型分成多个实例。此时测试管理平台需要维护一张“逻辑链路表”，记录每条链路涉及的仿真节点、网关实例、被测设备端口和监控通道。平台按链路表批量下发配置，并在监控工具中按链路 ID 过滤流量，避免不同用例的报文互相干扰。这样，整个联调环境就从“手工接线”升级为“可编排、可观测、可复现”的工程化测试平台。