Go / 系统课时
设计种子语料
设计种子语料
模糊测试不会凭空找到所有有价值的输入。高质量种子应覆盖正常形态、边界值和特殊编码,让 Go 的变异器从几个有代表性的起点扩展输入空间,同时避免把大量重复样本塞进初始语料。
学习目标
- 能按输入维度选择正常、边界和特殊编码种子
- 会使用
f.Add为 Fuzz Target 建立最小有效语料 - 能判断哪些样本应保留为长期回归种子
种子覆盖的是输入维度
种子数量不是越多越好,关键是让每个样本代表一种不同形态。以 key=value 文本为例,可以从结构完整性、长度边界和编码三个维度选点:正常键值、空值、缺少键、空字符串、中文、Emoji,以及包含 NUL 字节的内容。
| 类型 | 示例 | 主要覆盖点 |
|---|---|---|
| 正常 | env=prod |
常规解析路径 |
| 边界 | feature=、=missing-key、空字符串 |
空值、缺失键、最短输入 |
| 特殊编码 | 名称=测试、emoji=🚀、NUL 字节 |
UTF-8、多字节字符、控制字节 |
如果两个种子只是在普通字母上换了内容,它们通常处于同一结构区域,保留一个即可。优先增加“形态不同”的样本,而不是堆积“文本不同”的样本。
用 f.Add 建立最小语料
下面的测试文件可以直接保存为 label_test.go。解析器只接受合法 UTF-8,要求等号前存在非空键;Fuzz Target 先加入七个种子,再让 Go 自动变异。
go
package fuzzdemo
import (
"strings"
"testing"
"unicode/utf8"
)
func parseLabel(s string) (key, value string, ok bool) {
if !utf8.ValidString(s) {
return "", "", false
}
i := strings.IndexByte(s, '=')
if i <= 0 {
return "", "", false
}
key = strings.TrimSpace(s[:i])
value = strings.TrimSpace(s[i+1:])
if key == "" {
return "", "", false
}
return key, value, true
}
func FuzzParseLabel(f *testing.F) {
seeds := []string{
"env=prod",
"feature=",
"=missing-key",
"",
"名称=测试",
"emoji=🚀",
"key=\x00value",
}
for _, seed := range seeds {
f.Add(seed)
}
f.Fuzz(func(t *testing.T, s string) {
key, _, ok := parseLabel(s)
if ok && key == "" {
t.Fatalf("accepted an empty key for %q", s)
}
})
}先执行种子路径,确认基线语料本身不会失败:
bash
go test -run=FuzzParseLabel预期输出:
text
PASS
ok <PATH> <TIME><PATH> 与 <TIME> 会随模块路径和机器运行时间变化。随后再启动真正的模糊搜索:
bash
go test -run=^$ -fuzz=FuzzParseLabel -fuzztime=3s预期结果:
text
PASS
ok <PATH> <TIME>运行过程中还会出现基线覆盖和执行次数统计,具体数值不固定;关键是最终没有触发失败。
把失败样本升级为回归资产
手工种子负责提供起点,模糊测试发现的最小失败输入则负责记录真实缺陷。Go 在发现失败后会把触发输入写入 testdata/fuzz/<FuzzName> 下的语料文件,修复代码后应再次执行测试,确保该输入不再触发问题。
不要把每次运行产生的大量随机输入都手工加入 f.Add。长期保留的种子应满足至少一个条件:覆盖新的结构边界、代表重要业务格式,或曾经触发过真实缺陷。这样语料规模小而有信息密度,既能快速完成基线执行,也能给变异器提供有效搜索起点。
按自己的节奏,确认真正理解。