Go / 系统课时
验证错误与边界条件
验证错误与边界条件
只测试正常输入很容易得到“全绿但不可靠”的结果。本节用一个重试次数解析函数覆盖空字符串、合法边界、越界值和非法文本,并验证返回的错误类型。完成后,你可以把错误路径和边界条件写成可重复执行的测试,而不是靠人工猜测。
学习目标
- 为返回错误的函数同时验证结果值与错误语义
- 覆盖空值、最小值、最大值、越界值和非法输入
- 使用表驱动子测试减少重复代码,同时保持每个失败案例可定位
先定义需要守住的边界
假设配置项 retries 只允许 0 到 10。空字符串不是默认值,而是缺失输入;非数字文本属于格式错误;小于 0 或大于 10 属于范围错误。测试应围绕这些业务边界设计,而不是随意挑几个数字。
为了让调用方和测试能够稳定判断错误原因,下面使用哨兵错误 ErrEmpty、ErrInvalid 和 ErrOutOfRange。测试通过 errors.Is 检查错误语义,不依赖完整错误字符串,因此以后即使补充上下文信息,也不必重写断言。
用表驱动测试覆盖异常路径
下面是完整项目中的文件内容(片段示例)。三个文件共同组成一个可运行示例,需要放在同一目录后统一运行测试。
go.mod:
module example.com/retry
go 1.24retry.go:
package retry
import (
"errors"
"fmt"
"strconv"
)
var (
ErrEmpty = errors.New("retries is empty")
ErrInvalid = errors.New("retries is invalid")
ErrOutOfRange = errors.New("retries is out of range")
)
func ParseRetries(raw string) (int, error) {
if raw == "" {
return 0, ErrEmpty
}
n, err := strconv.Atoi(raw)
if err != nil {
return 0, fmt.Errorf("%w: %q", ErrInvalid, raw)
}
if n < 0 || n > 10 {
return 0, fmt.Errorf("%w: %d", ErrOutOfRange, n)
}
return n, nil
}retry_test.go:
package retry
import (
"errors"
"testing"
)
func TestParseRetries(t *testing.T) {
tests := []struct {
name string
input string
want int
wantErr error
}{
{name: "empty", input: "", wantErr: ErrEmpty},
{name: "minimum", input: "0", want: 0},
{name: "maximum", input: "10", want: 10},
{name: "below minimum", input: "-1", wantErr: ErrOutOfRange},
{name: "above maximum", input: "11", wantErr: ErrOutOfRange},
{name: "invalid text", input: "abc", wantErr: ErrInvalid},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
got, err := ParseRetries(tt.input)
// 有错误预期时先验证错误语义,避免只比较易变化的错误文本。
if tt.wantErr != nil {
if !errors.Is(err, tt.wantErr) {
t.Fatalf("ParseRetries(%q) error = %v; want %v", tt.input, err, tt.wantErr)
}
return
}
if err != nil {
t.Fatalf("ParseRetries(%q) unexpected error: %v", tt.input, err)
}
if got != tt.want {
t.Fatalf("ParseRetries(%q) = %d; want %d", tt.input, got, tt.want)
}
})
}
}表驱动结构把输入、期望值和期望错误集中在一处;t.Run 会给每个案例独立名称,某个边界失败时可以直接定位到具体输入。这里还刻意同时放入边界内的 0、10 与边界外的 -1、11,用于识别常见的 <、<= 写错问题。
运行测试并检查所有分支
执行:
go test -v预期输出:
=== RUN TestParseRetries
=== RUN TestParseRetries/empty
=== RUN TestParseRetries/minimum
=== RUN TestParseRetries/maximum
=== RUN TestParseRetries/below_minimum
=== RUN TestParseRetries/above_maximum
=== RUN TestParseRetries/invalid_text
--- PASS: TestParseRetries (<TIME>)
--- PASS: TestParseRetries/empty (<TIME>)
--- PASS: TestParseRetries/minimum (<TIME>)
--- PASS: TestParseRetries/maximum (<TIME>)
--- PASS: TestParseRetries/below_minimum (<TIME>)
--- PASS: TestParseRetries/above_maximum (<TIME>)
--- PASS: TestParseRetries/invalid_text (<TIME>)
PASS
ok example.com/retry <TIME>实际耗时会不同,因此用 <TIME> 表示动态值。需要关注的是六个子测试都被执行且通过。如果只看到正常路径通过,并不能证明错误处理可靠。
判断还缺哪些边界案例
新增测试时,可以从“边界本身”和“边界两侧”检查:最小合法值、最大合法值、刚刚越界的值,以及无法进入正常解析流程的输入。对于返回指针、切片或映射的函数,还应额外区分 nil 与空值是否具有不同语义。
错误测试也不应只写 err != nil。如果函数公开了承诺的错误类别,优先使用 errors.Is 或 errors.As 验证语义;只有错误文本本身就是协议的一部分时,才适合精确比较字符串。这样测试既能守住行为契约,又不会因为无关的文案调整频繁失败。