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。长期保留的种子应满足至少一个条件:覆盖新的结构边界、代表重要业务格式,或曾经触发过真实缺陷。这样语料规模小而有信息密度,既能快速完成基线执行,也能给变异器提供有效搜索起点。

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

目录与阅读设置

记录一个想法

设计种子语料

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

登录哪都通