Go / 系统课时
用表驱动测试覆盖边界值
用表驱动测试覆盖边界值
当同一规则需要验证很多输入时,复制多段断言会迅速变得难维护。表驱动测试把“输入、期望值、是否报错”放进数据表,再由统一测试逻辑逐条执行,特别适合覆盖正常值、上下边界和错误分支。
学习目标
- 会设计包含名称、输入、期望结果和错误预期的测试用例表。
- 能用
t.Run为每个案例生成独立子测试,并让失败报告直接指出案例名称。 - 能覆盖
1、65535等边界值以及越界、格式错误分支。
先定义需要覆盖的边界
先在空目录初始化模块。本例使用 example.com/port,因此后面的 go test 输出能直接对应模块路径。
mkdir port
cd port
go mod init example.com/port预期输出:
go: creating new go.mod: module example.com/port接着实现 ParsePort:输入十进制字符串,合法端口范围限定为 1 到 65535。测试至少要覆盖一个普通值、两个合法边界、两个越界值和一个非数字输入,否则很容易只验证“常见情况”。
package port
import (
"fmt"
"strconv"
)
func ParsePort(s string) (int, error) {
n, err := strconv.Atoi(s)
if err != nil {
return 0, fmt.Errorf("invalid port %q: %w", s, err)
}
if n < 1 || n > 65535 {
return 0, fmt.Errorf("port out of range: %d", n)
}
return n, nil
}预期结果:合法输入 "1"、"8080"、"65535" 返回对应整数且错误为 nil;"0"、"65536" 和 "abc" 返回非 nil 错误。
把案例写成数据而不是复制测试
测试表使用匿名结构体即可。name 字段专门服务于失败定位;wantErr 只比较“是否应报错”,避免把 strconv.Atoi 的平台无关但较长错误文本写死。
package port
import "testing"
func TestParsePort(t *testing.T) {
tests := []struct {
name string
input string
want int
wantErr bool
}{
{name: "minimum", input: "1", want: 1},
{name: "normal", input: "8080", want: 8080},
{name: "maximum", input: "65535", want: 65535},
{name: "below minimum", input: "0", wantErr: true},
{name: "above maximum", input: "65536", wantErr: true},
{name: "not a number", input: "abc", wantErr: true},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
got, err := ParsePort(tt.input)
if tt.wantErr {
if err == nil {
t.Fatalf("ParsePort(%q) error = nil, want error", tt.input)
}
return
}
if err != nil {
t.Fatalf("ParsePort(%q) unexpected error: %v", tt.input, err)
}
if got != tt.want {
t.Fatalf("ParsePort(%q) = %d, want %d", tt.input, got, tt.want)
}
})
}
}预期结果:保存为 port_test.go 后,六个案例使用同一段执行与断言逻辑;新增案例时只需增加一行测试数据,不需要复制 ParsePort 调用和错误检查。
运行测试:
go test -v预期输出:
=== RUN TestParsePort
=== RUN TestParsePort/minimum
=== RUN TestParsePort/normal
=== RUN TestParsePort/maximum
=== RUN TestParsePort/below_minimum
=== RUN TestParsePort/above_maximum
=== RUN TestParsePort/not_a_number
--- PASS: TestParsePort (<TIME>)
--- PASS: TestParsePort/minimum (<TIME>)
--- PASS: TestParsePort/normal (<TIME>)
--- PASS: TestParsePort/maximum (<TIME>)
--- PASS: TestParsePort/below_minimum (<TIME>)
--- PASS: TestParsePort/above_maximum (<TIME>)
--- PASS: TestParsePort/not_a_number (<TIME>)
PASS
ok example.com/port <TIME><TIME> 是动态耗时,实际值可能不同。若模块名不是 example.com/port,最后一行会显示你自己的模块路径。
用边界分组检查覆盖是否完整
端口范围的关键边界可以直接按“边界前、边界点、边界后”检查:下界对应 0 / 1 / 2,上界对应 65534 / 65535 / 65536。当前表已覆盖 0、1、65535、65536;如果规则改成允许端口 0,只需修改边界案例,不必重写测试结构。
只运行上界相关案例时,可以利用子测试名称:
go test -run 'TestParsePort/(maximum|above_maximum)' -v预期输出:
=== RUN TestParsePort
=== RUN TestParsePort/maximum
=== RUN TestParsePort/above_maximum
--- PASS: TestParsePort (<TIME>)
--- PASS: TestParsePort/maximum (<TIME>)
--- PASS: TestParsePort/above_maximum (<TIME>)
PASS
ok example.com/port <TIME>这种选择性运行在定位边界回归时很实用,也能让 CI 针对某一类规则快速复现失败。
让测试表保持可读
测试表不应塞入与主题无关的复杂准备逻辑。每个案例最好能在一行或几行内看懂:输入是什么、期待什么、是否报错。如果某个案例需要数据库、文件系统或大量对象组装,优先把准备逻辑提取成测试辅助函数,并在辅助函数中调用 t.Helper()。
错误分支也不要只写 wantErr: true 就结束。对于业务上有稳定错误类型的代码,可以进一步用 errors.Is 或 errors.As 检查错误类别;但像本例这种只需验证输入合法性的函数,先覆盖边界与错误存在性,已经能有效防止范围判断被意外改坏。