Go 单元测试中验证错误应优先检查是否为 nil，避免依赖错误字符串；推荐使用自定义错误类型配合 errors.Is 进行语义化断言，提升测试健壮性与可维护性。

go 单元测试中验证错误应优先检查是否为 nil，避免依赖错误字符串；推荐使用自定义错误类型配合 `errors.is` 进行语义化断言，提升测试健壮性与可维护性。

在 Go 的单元测试中，对返回 error 类型的函数进行断言，核心原则是：关注错误的语义，而非其字符串表现。直接比较 err.Error() 与预期字符串（如 assert.Equal(t, "invalid ID", err.Error())）看似直观，但极易因日志格式调整、翻译、拼写修正等非逻辑变更导致测试意外失败，违背了单元测试“验证行为而非实现细节”的初衷。

✅ 推荐做法分三层递进：

1. 基础层：检查是否出错
   大多数场景下，只需确认函数在非法输入时返回非 nil 错误即可：

   func TestParseID_InvalidInput(t *testing.T) {
       _, err := ParseID("abc")
       if err == nil {
           t.Fatal("expected error, got nil")
       }
   }

2. 语义层：使用 errors.Is 判断错误类型
   当需区分不同错误原因（如“参数无效” vs “资源未找到”），应定义可识别的自定义错误变量，并用 errors.Is 断言：

   var (
       ErrInvalidID = errors.New("invalid ID format")
       ErrNotFound  = errors.New("resource not found")
   )
   
   func ParseID(s string) (int, error) {
       if !regexp.MustCompile(`^\d+$`).MatchString(s) {
           return 0, ErrInvalidID
       }
       // ...
   }
   
   func TestParseID_InvalidFormat(t *testing.T) {
       _, err := ParseID("xyz")
       if !errors.Is(err, ErrInvalidID) {
           t.Fatalf("expected %v, got %v", ErrInvalidID, err)
       }
   }

3. 结构层：自定义错误类型携带上下文
   若需验证错误中的具体值（如错误码、原始输入），可实现带字段的错误类型，并在测试中类型断言：

   type ValidationError struct {
       Field string
       Value string
   }
   func (e *ValidationError) Error() string {
       return fmt.Sprintf("validation failed on %s: %s", e.Field, e.Value)
   }
   
   func TestValidateEmail_InvalidDomain(t *testing.T) {
       err := ValidateEmail("user@invalid")
       var ve *ValidationError
       if errors.As(err, &ve) && ve.Field == "email" && ve.Value == "user@invalid" {
           // ✅ 通过
       } else {
           t.Fatal("expected *ValidationError with email field")
       }
   }

⚠️ 注意事项：

• 避免在测试中使用 strings.Contains(err.Error(), "...") 或正则匹配错误消息——这耦合了用户界面与测试逻辑；
• errors.Is 和 errors.As 是 Go 1.13+ 标准库提供的安全、可组合的错误判断工具，取代了过时的类型断言或字符串匹配；
• 所有自定义错误都应满足 error 接口，且 Error() 方法返回的字符串仅用于调试和日志，绝不作为程序逻辑分支依据。

总结：Go 错误测试的本质是验证函数在边界条件下的契约行为——它是否按约定返回了特定语义的错误。通过 nil 检查、errors.Is 和 errors.As 构建分层断言策略，既能保障测试稳定性，又能清晰表达业务意图。