单片机与物联网 / 系统课时
用测试向量锁定协议行为
用测试向量锁定协议行为
当协议已经能正常收发后,最容易发生的是“代码改了,行为也悄悄变了”。测试向量把请求帧、响应帧、异常帧和预期解析结果固定下来,让字段编码、CRC、转义和边界处理可以持续回归。
学习目标
- 能设计覆盖正常帧和关键异常分支的固定测试向量
- 能自动验证编码、CRC、转义和解析结果
- 能把失败定位到输入样本、协议计算或解析逻辑,而不是依赖人工抓包
测试向量应固定什么
一个完整向量至少包含输入帧、期望输出或错误类型,以及用于断言的结构化结果。不要只保存十六进制帧,否则测试失败时很难判断是编码错误、CRC 错误还是解析错误。
| 向量 | 输入 | 验证重点 | 预期 |
|---|---|---|---|
| normal | 合法请求/响应 | 字段编码与解析 | 成功 |
| bad-crc | CRC 被修改 | CRC 校验 | 拒绝 |
| escaped | 含转义字节 | 解转义与长度 | 成功 |
| exception | 异常功能码或状态码 | 异常分支 | 返回协议错误 |

测试向量最重要的属性是稳定。只要协议定义没有改变,同一个向量就不应因为测试运行时间、硬件连接状态或随机数据而改变结果。
用固定样本做自动回归
下面示例假设项目已有 parse_frame() 函数,它接收原始字节并在 CRC 错误时抛出 ValueError。这里用最小 unittest 测试固定帧。
python
import unittest
def parse_frame(frame: bytes) -> dict:
# 示例解析器:校验固定格式并提取地址与数据长度。
if len(frame) < 5:
raise ValueError("frame too short")
if frame[-1] != 0x2A:
raise ValueError("bad crc")
return {"address": frame[0], "function": frame[1], "length": frame[2]}
class ProtocolVectorTest(unittest.TestCase):
def test_normal_vector(self):
frame = bytes.fromhex("01 03 02 00 2A")
self.assertEqual(
parse_frame(frame),
{"address": 1, "function": 3, "length": 2},
)
def test_bad_crc_vector(self):
frame = bytes.fromhex("01 03 02 00 29")
with self.assertRaisesRegex(ValueError, "bad crc"):
parse_frame(frame)
if __name__ == "__main__":
unittest.main()预期输出
text
..
----------------------------------------------------------------------
Ran 2 tests
OK真实项目中的 parse_frame() 应替换为实际协议解析器;上面的 CRC 判断只是为了演示测试向量的组织方式,不能当作具体协议的 CRC 算法实现。
怎样让向量覆盖协议边界
不要只收集“设备抓到的正常包”。优先固定那些最可能因重构而回归的边界:长度字段与实际载荷不一致、CRC 只差一位、需要转义的字节、最小和最大合法长度,以及明确规定的异常码。
对于每个向量,还应保留它验证的具体规则。这样测试失败时可以直接回答“哪条协议约定被破坏”,而不只是得到一条模糊的 test failed。
什么时候应该新增测试向量
遇到新设备、新异常码、新边界规则或曾经修复过的协议 Bug,都应增加至少一个固定向量。把“曾经出错的报文”保留下来,比只新增正常样本更能防止同一问题再次出现。
当向量集合覆盖正常、异常和边界行为后,协议实现就有了一组不会随硬件环境变化的行为基线。后续修改编码、CRC、转义或解析器时,先运行这组基线,再处理新增场景,能够把兼容性风险限制在明确可见的失败结果上。
按自己的节奏,确认真正理解。