Go / 系统课时

设计模糊测试不变量

设计模糊测试不变量

模糊输入通常没有可预先写死的唯一答案,因此 Fuzz Target 更适合检查“始终必须成立”的性质。本节用不崩溃、编解码往返一致性和业务范围三个不变量,构造一个可直接运行的 Go 模糊测试。

学习目标

  • 能把固定期望值改写为适合未知输入的不变量
  • 会为不变量声明必要的输入前置条件
  • 能用失败信息区分实现缺陷与错误测试假设

不变量描述必须始终成立的性质

普通单元测试常写成“输入 A 必须得到 B”,但模糊测试会不断生成此前未知的输入。此时更稳定的断言是性质本身,例如:合法输入不应触发 panic;编码后再解码应恢复原值;归一化后的等级始终位于允许范围。

不变量必须与输入域一致。如果系统只承诺处理合法 UTF-8,就应先过滤非法 UTF-8,再验证往返一致性。否则测试可能把“不在契约内的输入”误判成实现缺陷。

用一个 Target 同时检查三类性质

下面的 Item 使用 JSON 做编解码,业务规则要求 Level 位于 0 到 10。normalizeLevel 先把任意 int64 收敛到合法区间,随后测试 JSON 往返结果和业务范围。

go
package fuzzdemo

import (
	"encoding/json"
	"testing"
	"unicode/utf8"
)

type Item struct {
	Name  string `json:"name"`
	Level uint8  `json:"level"`
}

func normalizeLevel(v int64) uint8 {
	switch {
	case v < 0:
		return 0
	case v > 10:
		return 10
	default:
		return uint8(v)
	}
}

func FuzzItemInvariants(f *testing.F) {
	f.Add("alice", int64(3))
	f.Add("", int64(0))
	f.Add("测试🚀", int64(10))

	f.Fuzz(func(t *testing.T, name string, rawLevel int64) {
		// 往返一致性只对系统承诺支持的合法 UTF-8 输入成立。
		if !utf8.ValidString(name) {
			return
		}

		want := Item{Name: name, Level: normalizeLevel(rawLevel)}

		data, err := json.Marshal(want)
		if err != nil {
			t.Fatalf("marshal failed: %v", err)
		}

		var got Item
		if err := json.Unmarshal(data, &got); err != nil {
			t.Fatalf("unmarshal failed: %v; data=%q", err, data)
		}

		if got != want {
			t.Fatalf("round trip mismatch: want=%+v got=%+v", want, got)
		}
		if got.Level > 10 {
			t.Fatalf("level out of range: %d", got.Level)
		}
	})
}

这里不需要用 recover 吞掉 panic。Fuzz Target 或被测代码一旦 panic,testing 会直接把它记录为失败并保存触发输入;主动恢复反而可能掩盖真正的缺陷。

运行模糊测试:

bash
go test -run=^$ -fuzz=FuzzItemInvariants -fuzztime=3s

预期输出:

text
PASS
ok   <PATH>   <TIME>

<PATH> 与 <TIME> 是动态值。只要某个输入导致 panic、JSON 往返不一致或 Level 越界,命令就会失败,并给出可复现的输入。

避免写出伪不变量

最常见的问题是把“当前实现恰好如此”误当成业务契约。例如断言 JSON 字段顺序固定,就不是可靠不变量;序列化器只需要产生语义等价的数据,并不承诺文本布局恒定。

另一个问题是把所有异常输入直接 return。前置条件应该只排除明确不属于契约的输入;如果过滤条件过宽,Fuzz Target 虽然一直通过,却没有真正探索危险区域。每个 return 都应能回答“为什么这个输入不属于被测函数的有效域”。

从一次失败判断是哪种问题

出现失败时,先查看保存的触发输入,再检查被破坏的是哪条性质。如果 panic 来自越界访问,通常是实现缺陷;如果往返失败只发生在测试从未承诺支持的输入上,则应修正前置条件;如果业务范围被突破,则要检查归一化逻辑或类型转换。

高质量 Fuzz Target 的核心不是断言越多,而是每条断言都代表真实契约。把“不崩溃、可逆关系、业务边界”写成稳定的不变量,模糊测试才能在未知输入上持续发现有意义的缺陷。

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

目录与阅读设置

记录一个想法

设计模糊测试不变量

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

登录哪都通