Go / 系统课时
设计模糊测试不变量
设计模糊测试不变量
模糊输入通常没有可预先写死的唯一答案,因此 Fuzz Target 更适合检查“始终必须成立”的性质。本节用不崩溃、编解码往返一致性和业务范围三个不变量,构造一个可直接运行的 Go 模糊测试。
学习目标
- 能把固定期望值改写为适合未知输入的不变量
- 会为不变量声明必要的输入前置条件
- 能用失败信息区分实现缺陷与错误测试假设
不变量描述必须始终成立的性质
普通单元测试常写成“输入 A 必须得到 B”,但模糊测试会不断生成此前未知的输入。此时更稳定的断言是性质本身,例如:合法输入不应触发 panic;编码后再解码应恢复原值;归一化后的等级始终位于允许范围。
不变量必须与输入域一致。如果系统只承诺处理合法 UTF-8,就应先过滤非法 UTF-8,再验证往返一致性。否则测试可能把“不在契约内的输入”误判成实现缺陷。
用一个 Target 同时检查三类性质
下面的 Item 使用 JSON 做编解码,业务规则要求 Level 位于 0 到 10。normalizeLevel 先把任意 int64 收敛到合法区间,随后测试 JSON 往返结果和业务范围。
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 会直接把它记录为失败并保存触发输入;主动恢复反而可能掩盖真正的缺陷。
运行模糊测试:
go test -run=^$ -fuzz=FuzzItemInvariants -fuzztime=3s预期输出:
PASS
ok <PATH> <TIME><PATH> 与 <TIME> 是动态值。只要某个输入导致 panic、JSON 往返不一致或 Level 越界,命令就会失败,并给出可复现的输入。
避免写出伪不变量
最常见的问题是把“当前实现恰好如此”误当成业务契约。例如断言 JSON 字段顺序固定,就不是可靠不变量;序列化器只需要产生语义等价的数据,并不承诺文本布局恒定。
另一个问题是把所有异常输入直接 return。前置条件应该只排除明确不属于契约的输入;如果过滤条件过宽,Fuzz Target 虽然一直通过,却没有真正探索危险区域。每个 return 都应能回答“为什么这个输入不属于被测函数的有效域”。
从一次失败判断是哪种问题
出现失败时,先查看保存的触发输入,再检查被破坏的是哪条性质。如果 panic 来自越界访问,通常是实现缺陷;如果往返失败只发生在测试从未承诺支持的输入上,则应修正前置条件;如果业务范围被突破,则要检查归一化逻辑或类型转换。
高质量 Fuzz Target 的核心不是断言越多,而是每条断言都代表真实契约。把“不崩溃、可逆关系、业务边界”写成稳定的不变量,模糊测试才能在未知输入上持续发现有意义的缺陷。