Go 错误处理规范errors.Is / As 与自定义错误类型实战错误处理是 Go 项目的一致性语言。掌握 errors.Is / As、Sentinel、自定义 ErrorType能让项目质量上一个台阶。一、Go 错误是值iferr:doSomething();err!nil{returnerr}错误是类型为error的接口变量内部包含字符串与包装链。二、errors.Is / errors.Asimporterrorserr:fmt.Errorf(db unavailable: %w,sql.ErrConnDone)iferrors.Is(err,sql.ErrConnDone){...}// 通过 wrap 也能识别errors.Is 自底向上比对 Sentinel 错误。errors.As 用于断言错误为某类型。三、自定义错误类型typeValidationErrorstruct{FieldstringIssuestring}func(e*ValidationError)Error()string{returnfmt.Sprintf(invalid %s: %s,e.Field,e.Issue)}// 业务层returnValidationError{Field:age,Issue:0}调用方varverr*ValidationErroriferrors.As(err,verr){fmt.Println(verr.Field,verr.Issue)}四、Sentinel 错误var(ErrNotFounderrors.New(not found)ErrUnauthorizederrors.New(unauthorized))Sentinel 在调用方做 identity 比较iferrors.Is(err,ErrNotFound){returnhttp.StatusNotFound}五、with stack traceimportgithub.com/pkg/errorserr:errors.Wrap(sql.ErrConnDone,fetch user)errors.Wrap自动携带堆栈fmt.Printf(%v\n, err)能打印。缺点与 Go 1.13 标准 fmt.Errorf %w 融合时容易出现包栈重复。六、实战handler 错误封装funcWriteErr(c*gin.Context,errerror){varverr*ValidationErroriferrors.As(err,verr){c.JSON(http.StatusBadRequest,gin.H{code:verr.Field,msg:verr.Issue,})return}iferrors.Is(err,ErrUnauthorized){c.JSON(http.StatusUnauthorized,gin.H{code:UNAUTH})return}slog.Error(internal,err,err)c.JSON(http.StatusInternalServerError,gin.H{code:INTERNAL})}业务代码只关心 Wrap 上层业务无关错误在 handler 转 HTTP code。七、错误分类策略程序错误panic开发者改业务错误error用户/输入问题基础设施错误网络/数据库 → 重试或熔断每种分清楚重试逻辑更准。八、不要做的事panic 给业务error 中放敏感数据密码、token自定义错误不实现 Error()或者提供接口但内部 nil check 忘了九、踩坑清单errChain 嵌套太深——%w 多层包装对性能略有影响sentinel 不可变——不能动态赋值fmt.Print(“%v”) 隐藏 wrap 链十、总结与展望errors.Is/As 是 1.13 后推荐的现代错误处理方式。Sentinel Wrap Type 三种模式组合让代码既可读又可测试。未来Go 1.24 可能加入errors.Join跨多个 error 收集。十一、参考文献Go 官方博客Working with Errors in Go 1.13pkg/errors READMEUber Go 风格指南