Go / 系统课时

用表驱动测试覆盖边界值

用表驱动测试覆盖边界值

当同一规则需要验证很多输入时,复制多段断言会迅速变得难维护。表驱动测试把“输入、期望值、是否报错”放进数据表,再由统一测试逻辑逐条执行,特别适合覆盖正常值、上下边界和错误分支。

学习目标

  • 会设计包含名称、输入、期望结果和错误预期的测试用例表。
  • 能用 t.Run 为每个案例生成独立子测试,并让失败报告直接指出案例名称。
  • 能覆盖 1、65535 等边界值以及越界、格式错误分支。

先定义需要覆盖的边界

先在空目录初始化模块。本例使用 example.com/port,因此后面的 go test 输出能直接对应模块路径。

bash
mkdir port
cd port
go mod init example.com/port

预期输出:

text
go: creating new go.mod: module example.com/port

接着实现 ParsePort:输入十进制字符串,合法端口范围限定为 1 到 65535。测试至少要覆盖一个普通值、两个合法边界、两个越界值和一个非数字输入,否则很容易只验证“常见情况”。

go
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 的平台无关但较长错误文本写死。

go
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 调用和错误检查。

运行测试:

bash
go test -v

预期输出:

text
=== 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,只需修改边界案例,不必重写测试结构。

只运行上界相关案例时,可以利用子测试名称:

bash
go test -run 'TestParsePort/(maximum|above_maximum)' -v

预期输出:

text
=== 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 检查错误类别;但像本例这种只需验证输入合法性的函数,先覆盖边界与错误存在性,已经能有效防止范围判断被意外改坏。

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

目录与阅读设置

阅读设置

17

记录一个想法

用表驱动测试覆盖边界值

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

登录哪都通