单片机与物联网 / 系统课时

用测试向量锁定协议行为

用测试向量锁定协议行为

当协议已经能正常收发后,最容易发生的是“代码改了,行为也悄悄变了”。测试向量把请求帧、响应帧、异常帧和预期解析结果固定下来,让字段编码、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、转义或解析器时,先运行这组基线,再处理新增场景,能够把兼容性风险限制在明确可见的失败结果上。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用测试向量锁定协议行为

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通