Go原生fuzz测试必须从首个Fuzz函数起并行启动,函数名以Fuzz开头、文件名为_test.go、参数为*testing.F、必须调用f.Add()提供种子,否则静默跳过;f.Add()是变异方向开关,需覆盖空、截断、超长、控制字符、极值五类种子;f.Fuzz()中禁I/O、禁日志、禁全局状态、禁非确定性操作,确保可复现。

Go 原生 fuzz 测试不是“补充手段”,而是从第一个 func FuzzXxx 就该写进代码的习惯——它能自动撞到你根本想不到的 nil、截断 UTF-8、超长嵌套、整数溢出这些边界点,比手写测试快一个数量级。
怎么写一个能被 go test -fuzz 扫到的函数
漏掉任一条件,fuzzer 就静默跳过,连报错都没有:
- 函数名必须以
Fuzz开头(首字母大写),例如FuzzParseJSON - 文件名必须是
*_test.go,且放在被测包根目录下(不能在internal/或cmd/里) - 参数类型严格为
*testing.F,不能是*testing.T或其他类型 - 函数体里必须调用
f.Add()提供种子,或f.Fuzz()注册回调;只写f.Add("a")但没写f.Fuzz(),等于没启动 fuzz
为什么 f.Add() 不是可选,而是关键开关
不调用 f.Add(),fuzz 引擎就只能从空输入开始随机变异,效率极低。加了合适的种子,变异器才能聚焦在你关心的结构上:
- 对解析函数,加
f.Add("")、f.Add("{}")、f.Add("\u0000")、f.Add(strings.Repeat("{", 500)) - 避免加纯随机大文件(如 10MB 二进制),会导致语料库膨胀、变异变慢
- 种子必须是基础类型:
string、[]byte、int、bool或它们组成的 flat struct;不能含map、interface{}、指针或 channel - 如果函数需要多参数,定义简单 struct:
type args struct{ s string; n int },再f.Add(args{"x", 42})
f.Fuzz() 回调里哪些事绝对不能做
所有操作必须可复现、无副作用、不阻塞:
- 禁止调用
time.Now()、rand.Int()、os.Getenv()—— 非确定性操作会让 fuzz 直接丢弃该输入 - 禁止 I/O:
os.Open、http.Get、fmt.Println;要用bytes.NewReader或httptest.Server替代 - 禁止修改全局状态(如
sync.Map、包级变量),每次回调都应在干净 goroutine 中运行 - 单次执行建议加超时检查:
if time.Since(start) > 100*time.Millisecond { return },防止卡死拖慢整体进度
怎么让 fuzz 快速暴露 panic 而不是瞎跑一小时
覆盖率引导(coverage-guided)意味着:种子越贴近危险区,越容易触发深层分支。
- 10 个好 seed 比跑 1 小时更有效——重点覆盖空、截断、超长、控制字符、极值五类
- 别一上来就全量解析 JSON 或正则匹配;先快速校验长度、括号平衡、基础格式,再进主逻辑
- 用
-fuzztime=10s快速定位 crash,再用-fuzzminimizetime=30s自动精简失败输入 - 发现 crash 后,Go 会生成最小化用例(路径类似
test/fuzz/FuzzParse/crashers/),直接复现即可调试
真正容易被忽略的是:fuzz 不会帮你发现业务逻辑漏洞(比如 SQL 注入、权限绕过),它只认“输入一变,程序就崩”;而崩溃是否可复现,完全取决于你有没有在 f.Fuzz() 里避开所有非确定性操作——哪怕一行 log.Print 都可能导致 crash 丢失。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











