应抽象依赖为接口并注入返回预设错误的 mock 实现,如 mockReader 返回 io.EOF;用 errors.Is 比较导出错误变量而非 err.Error();HTTP handler 测试用 httptest.NewRecorder 检查状态码和响应体;避免测试 panic,优先重构为显式 error 返回。

如何用 testify/mock 或纯 Go 模拟返回错误的依赖
测试错误处理逻辑,核心是让被测函数实际走到 if err != nil 分支。最直接的方式是控制其依赖(比如数据库调用、HTTP 客户端、文件操作)返回预设错误。
不建议在单元测试里真实触发 os.Open("nonexistent.txt") 这类 I/O 错误——它不可控、慢、且环境依赖强。应将依赖抽象为接口,再注入 mock 实现。
- 定义接口:比如
type Reader interface { Read() ([]byte, error) } - 被测函数接收该接口而非具体类型,如
func Process(r Reader) error - 测试时传入一个始终返回
io.EOF的 mock 实现
type mockReader struct{}
func (m mockReader) Read() ([]byte, error) {
return nil, io.EOF
}
// 然后调用 Process(mockReader{}),断言是否正确处理了 io.EOF
如何用 errors.New 和 fmt.Errorf 构造可比较的错误进行断言
Go 中错误值比较需谨慎:errors.New("failed") == errors.New("failed") 为 false(两个不同指针)。若需精确匹配,应复用同一错误变量或使用 errors.Is/errors.As。
- 导出包级错误变量(推荐):
var ErrNotFound = errors.New("not found") - 用
errors.Is(err, ErrNotFound)判断是否为该错误或其包装 - 避免用
err.Error() == "not found"—— 字符串匹配脆弱,且丢失类型信息 - 若错误带上下文,用
fmt.Errorf("wrap: %w", ErrNotFound)并配合errors.Is
如何测试 HTTP handler 中的错误响应状态码和 body
测试 Web handler 的错误路径,关键在于捕获实际写出的 http.ResponseWriter 内容,而非只检查返回值(handler 函数本身无返回值)。
立即学习“go语言免费学习笔记(深入)”;
- 用
httptest.NewRecorder()替代真实响应器 - 构造
http.Request并调用 handler - 检查
recorder.Code(状态码)、recorder.Body.String()(响应体) - 确保错误分支调用了
w.WriteHeader(500)或类似逻辑
req := httptest.NewRequest("GET", "/api/user/999", nil)
rr := httptest.NewRecorder()
handler := http.HandlerFunc(UserHandler)
handler.ServeHTTP(rr, req)
if rr.Code != http.StatusNotFound {
t.Errorf("expected status %d, got %d", http.StatusNotFound, rr.Code)
}
if !strings.Contains(rr.Body.String(), "user not found") {
t.Error("expected error message in body")
}
为什么 panic 不该出现在正常错误处理测试中
有些代码用 panic 替代错误返回(尤其在早期 Go 项目中),但这会让测试变得脆弱且难以断言。标准库和主流实践都要求显式返回 error。
- 测试 panic 需用
defer recover()+testing.T.Helper()封装,易出错 -
panic绕过 defer 清理逻辑,掩盖资源泄漏问题 - HTTP handler 中 panic 会触发默认 panic handler(返回 500 + stack trace),但你无法验证 panic 原因是否符合预期
- 真正需要测试的是「错误是否被识别、分类、响应」,而不是「程序有没有崩溃」
如果必须兼容旧 panic 逻辑,优先重构为返回 error;若暂时不能改,至少用 assert.Panics(testify)做兜底,但别把它当成错误处理的正向测试路径。










