Go / 系统课时

验证错误与边界条件

验证错误与边界条件

只测试正常输入很容易得到“全绿但不可靠”的结果。本节用一个重试次数解析函数覆盖空字符串、合法边界、越界值和非法文本,并验证返回的错误类型。完成后,你可以把错误路径和边界条件写成可重复执行的测试,而不是靠人工猜测。

学习目标

  • 为返回错误的函数同时验证结果值与错误语义
  • 覆盖空值、最小值、最大值、越界值和非法输入
  • 使用表驱动子测试减少重复代码,同时保持每个失败案例可定位

先定义需要守住的边界

假设配置项 retries 只允许 0 到 10。空字符串不是默认值,而是缺失输入;非数字文本属于格式错误;小于 0 或大于 10 属于范围错误。测试应围绕这些业务边界设计,而不是随意挑几个数字。

为了让调用方和测试能够稳定判断错误原因,下面使用哨兵错误 ErrEmpty、ErrInvalid 和 ErrOutOfRange。测试通过 errors.Is 检查错误语义,不依赖完整错误字符串,因此以后即使补充上下文信息,也不必重写断言。

用表驱动测试覆盖异常路径

下面是完整项目中的文件内容(片段示例)。三个文件共同组成一个可运行示例,需要放在同一目录后统一运行测试。

go.mod:

text
module example.com/retry

go 1.24

retry.go:

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:

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,用于识别常见的 <、<= 写错问题。

运行测试并检查所有分支

执行:

bash
go test -v

预期输出:

text
=== 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 验证语义;只有错误文本本身就是协议的一部分时,才适合精确比较字符串。这样测试既能守住行为契约,又不会因为无关的文案调整频繁失败。

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

目录与阅读设置

记录一个想法

验证错误与边界条件

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

登录哪都通