2. 测试环境搭建流程：硬件选型、网络配置、工具清单
测试环境是IoT原型验证的物理基础。硬件选型决定被测对象的精度边界，网络配置影响通信链路的可信度，工具清单则直接关联数据采集的完整性与可复现性。本章按照SOP顺序，依次拆解硬件选型、网络配置、工具清单三个环节的输入、动作与输出，并提供可直接复用的检查清单与异常处置预案。
2.1 适用场景
本章流程适用于以下三类IoT原型测试环境的首次搭建与复用改造：
- 实验室原型验证 —— 网关、传感器、执行器在受控环境下的功能与性能摸底。
- 小规模外场试点 —— 3~20台设备在真实网络条件下的通信稳定性与兼容性测试。
- 回归测试环境重建 —— 因硬件版本升级、网络拓扑变更或工具链更新导致的环境重新搭建。
2.2 前置条件
下述条件应在启动环境搭建前逐一确认，并记录在《环境搭建前置检查表》中：
| 序号 | 前置条件 | 验收标准 | 确认人 |
|---|---|---|---|
| 1 | 测试需求文档已评审定稿 | 包含功能、性能、兼容性三个维度的具体指标 | 测试负责人 |
| 2 | 被测原型硬件BOM已冻结 | 所有元器件型号、版本、数量明确 | 硬件工程师 |
| 3 | 网络频谱与信道已清场 | 目标频段无同频强干扰（RSSI < -85 dBm 除外） | 网络工程师 |
| 4 | 工具授权与安装包已就绪 | 许可证有效，安装包版本与OS匹配 | 测试工程师 |
⚠ 关键提醒： 前置条件未满足时强行搭建环境，会导致后续测试数据无效、设备损坏或安全事故。前置条件确认必须形成书面记录，不得口头交接。
2.3 操作步骤
2.3.1 步骤一：硬件选型
根据测试需求文档中的被测对象清单，执行以下子步骤：
- 确定设备层级：将设备分为感知层（传感器/执行器）、网络层（网关/中继）、平台层（边缘服务器/工控机）。
- 匹配关键参数：每个设备至少确认供电电压、通信接口、协议栈版本、防护等级四项参数。
- 电源与接口兼容性检查：使用万用表测量实际供电输出，确认与设备标称值偏差 ≤ ±5%。
- 固件版本标注：对所有可编程设备记录当前固件版本号，并写入《硬件选型清单》。
推荐硬件配置参考（以典型IoT原型为例）：
| 层级 | 推荐型号 | 关键参数 | 数量 |
|---|---|---|---|
| 感知层（温湿度） | SHT30 | I²C / ±0.3°C / 0~100%RH | 3 |
| 感知层（光照） | BH1750 | I²C / 1~65535 lx | 2 |
| 网络层（网关） | ESP32-S3 | WiFi+BLE / 8MB Flash / UART×3 | 1 |
| 执行层（继电器） | SRD-05VDC-SL-C | 5V / 10A / 250VAC | 2 |
💡 最佳实践： 硬件选型时建议多备 1~2 套同型号设备，用于故障时替换或平行对比测试，避免因单点失效拖慢整体进度。
2.3.2 步骤二：网络配置
网络配置的核心目标是构建一个隔离、可控且可复现的通信环境。按以下顺序操作：
- 绘制网络拓扑图 —— 在文档中标注所有节点、链路、IP地址段与协议端口。
- 配置局域网参数 —— 设定子网掩码、网关地址、DHCP池范围。
- 协议与端口绑定 —— 固定MQTT Broker、CoAP Server、HTTP API等服务的监听端口。
- 防火墙规则预设 —— 仅放行测试所需的协议流量，其余默认拒绝。
- 连通性验证 —— 使用 ping 与 iperf3 测试端到端延迟与吞吐量。
标准配置模板示例：
# 网络配置文件 (net_config.yaml)
subnet: 192.168.1.0/24
gateway: 192.168.1.1
dhcp_pool: 192.168.1.100~192.168.1.200
dns: 8.8.8.8
mqtt_port: 1883
coap_port: 5683
http_port: 8080
firewall: drop all except tcp/1883, udp/5683, tcp/8080
⚠ 常见陷阱： 多个测试台共用一个WiFi SSID时容易发生IP冲突和广播风暴。建议为每个测试环境分配独立的VLAN或物理SSID，并在拓扑图中标注隔离边界。
2.3.3 步骤三：工具清单
根据测试类型选择并安装对应的工具链，所有工具版本号必须锁定并记录。
| 工具类别 | 工具名称 | 用途 | 版本要求 |
|---|---|---|---|
| 协议抓包 | Wireshark | MQTT/CoAP/HTTP报文级分析 | ≥ 4.0.x |
| 命令行抓包 | tcpdump | 远程/嵌入式设备离线抓包 | ≥ 4.99 |
| MQTT压测 | mosquitto_pub/sub | 发布/订阅吞吐量测试 | ≥ 2.0 |
| 网络性能 | iperf3 | TCP/UDP带宽与抖动测量 | ≥ 3.12 |
| REST API测试 | curl / httpie | HTTP接口功能与延迟验证 | curl ≥ 7.88 |
| 系统监控 | Prometheus + Node Exporter | CPU/内存/网络负载持续记录 | ≥ 2.45 |
安装完成后执行冒烟命令验证：
wireshark --version
mosquitto_pub -h 192.168.1.1 -t "test/topic" -m "smoke"
iperf3 -c 192.168.1.1 -t 5
curl -s http://192.168.1.1:8080/health | jq .2.4 输入输出物
| 环节 | 输入物 | 输出物 |
|---|---|---|
| 硬件选型 | 测试需求文档、BOM表 | 《硬件选型清单》（含型号/版本/数量/供电参数） |
| 网络配置 | 拓扑草图、频谱扫描报告 | 《网络配置表》（IP分配/端口映射/防火墙规则） |
| 工具清单 | 测试类型清单、OS环境信息 | 《工具链版本锁定表》（名称/版本/安装路径/校验和） |
| 环境集成 | 上述三份清单 | 《测试环境就绪确认书》（签字版） |
2.5 责任边界
- 测试工程师：提出硬件选型需求、制定网络配置要求、选择并安装工具链，负责环境集成验证。
- 硬件工程师：提供BOM表与设备规格书，协助确认供电兼容性，参与异常定位。
- 网络工程师：执行频谱扫描、配置VLAN与防火墙，提供连通性测试报告。
- 质量保证（QA）：监督前置条件确认与验收签字，确保所有记录材料归档。
责任移交节点：每个步骤的输出物经责任人签字后，方可启动下一步骤。
2.6 记录材料
环境搭建阶段产生的所有记录材料应统一归档至项目共享目录，命名格式为：YYMMDD_Chapter2_记录类型.pdf。至少包含以下文件：
- 《环境搭建前置检查表》
- 《硬件选型清单》
- 《网络配置表》
- 《工具链版本锁定表》
- 《连通性测试报告》
- 《环境搭建问题记录单》
2.7 异常处理
| 异常场景 | 原因分析 | 处置措施 |
|---|---|---|
| 硬件供电后无响应 | 电压不匹配 / 接线极性错误 | 立即断电，使用万用表复测供电端输出，核对BOM标称值 |
| 设备无法加入网络 | MAC地址过滤 / IP池耗尽 | 检查路由器白名单，释放或扩展DHCP池范围 |
| MQTT连接被拒绝 | 端口被占用 / 防火墙未放行 | 使用netstat -tlnp定位占用进程，修正防火墙规则 |
| 抓包工具无流量 | 网卡未启用混杂模式 | 执行ip link set eth0 promisc on，或更换USB抓包网卡 |
| iperf3吞吐量远低于预期 | 无线信号干扰 / 网线损坏 | 切换5GHz频段或更换屏蔽Cat6网线，重新测试取三次均值 |
💡 快速定位技巧： 遇到通信类异常时，先使用
ping 确认网络层连通性，再用 tcpdump 过滤目标端口查看报文是否到达，逐层缩小范围。
2.8 验收标准
环境搭建完成需同时满足以下五项标准，由测试负责人与QA共同签字确认：
- 硬件清单一致性 —— 现场设备型号、版本、数量与《硬件选型清单》完全一致，供电偏差 ≤ ±5%。
- 网络连通率 100% —— 所有节点间 ping 丢包率为 0%，TCP 往返时延 ≤ 5 ms（同一子网内）。
- 协议端口可达 —— 使用对应客户端工具（mosquitto_pub、curl、coap-client）向每个服务端口发送测试消息，均收到成功响应。
- 工具链冒烟通过 —— 2.3.3 节中的四条冒烟命令全部返回预期结果。
- 文档完整归档 —— 2.6 节所列六份记录材料齐全、内容可读、签字完备。
验收通过后，由测试负责人在《测试环境就绪确认书》上签字，环境方可正式投入测试使用。