Go微服务中需用自定义CodeError类型统一错误处理，强制实现error接口、Unwrap()、ErrorCode()方法，并全程禁用裸fmt.Errorf，确保错误在创建、传递、序列化、响应四环节保持结构化和可追溯性。
立即进入“夸克ai手把手教你，操作像呼吸一样简单！☜☜☜☜☜点击进入”；
直接说结论：Go微服务里没有“最佳方案”，只有“不踩坑的最小可行结构”——核心是让错误在创建、传递、序列化、响应四个环节都携带 ErrorCode() 方法，且全程禁用裸 fmt.Errorf。
为什么标准 error 接口在微服务里不够用
微服务不是单体应用，错误要跨网络、跨语言（gRPC/HTTP）、跨团队传递。标准 error 只有 Error() 字符串方法，日志里看到 "failed to get user: context deadline exceeded"，你根本分不清这是上游超时、下游超时，还是业务逻辑自己卡死。
- 字符串无法结构化解析，前端不能按
code做 UI 分支处理 - 监控系统无法聚合统计
404类错误，只能模糊匹配关键词 - 下游服务无法安全判断
errors.Is(err, ErrUserNotFound)，因为中间一包fmt.Errorf("get user failed: %w", err)就断链 - gRPC 里
status.Code(err)只对status.Error生效，对普通error返回Unknown
必须实现的自定义错误类型
不是加个字段就行，得满足四个硬性条件：实现 error 接口、支持 Unwrap()、暴露 ErrorCode() 方法、能被 errors.As() 安全提取。
type CodeError struct {
Code int
Message string
Err error // 底层原始错误，用于链式包装
}
func (e *CodeError) Error() string {
if e.Err != nil {
return fmt.Sprintf("%s: %v", e.Message, e.Err)
}
return e.Message
}
func (e *CodeError) Unwrap() error { return e.Err }
func (e *CodeError) ErrorCode() int { return e.Code } // 名字必须固定，中间件靠它反射提取- 不要把
Code设成字符串——整数才能做 switch 判断、Prometheus 标签、数据库索引 -
Unwrap()必须返回e.Err，否则errors.Is(err, someCodeError)永远失败 - 工厂函数强制替代裸
fmt.Errorf：NewUserNotFoundErr()而不是fmt.Errorf("user not found") - HTTP 中间件里统一用
errors.As(err, &codeErr)提取码，别用类型断言err.(*CodeError)—— 链式包装后可能不是顶层类型
跨服务错误传递的关键细节
错误从 A 服务抛到 B 服务，再透传给 C 服务，中间不能丢码、不能变质。gRPC 和 HTTP 的处理方式不同，但目标一致：保持语义。
- gRPC 场景下，优先用
status.Errorf(codes.NotFound, "%s", msg)，它的Code()方法可被status.Code()直接识别，比自定义CodeError更轻量且框架原生支持 - HTTP 场景下，响应体必须含
code字段，且状态码要和业务码映射（如code=1001→ HTTP 404），不能所有错误都返回 500 - 调用下游时，别直接
return err，要用fmt.Errorf("call inventory service failed: %w", err)包装，确保Unwrap()链不断 - 日志记录时，用
zap.Error(err)而不是zap.String("err", err.Error())—— zap 会自动展开错误链并提取ErrorCode()
panic 和 recover 的真实使用边界
别把 recover 当错误处理兜底。它只该用于捕获真正不该发生的崩溃，比如空指针解引用、数组越界、第三方库 panic，而不是业务错误。
- HTTP 入口中间件里加
defer/recover是对的，但 recover 后必须转成结构化错误返回，不能吞掉或只打日志 - 业务函数里写
if err != nil { panic(err) }是反模式——这会让调用方失去控制权，且无法被errors.Is()判断 - gRPC server 端用
go-grpc-middleware/recovery拦截器可以，但它默认返回codes.Unknown，需手动配置WithRecoveryHandlerContext注入业务码 - 真正该 panic 的场景极少：初始化失败（DB 连不上）、配置校验失败（required env missing）——这些本就不该启动服务
最常被忽略的是错误链的完整性：从最底层的 os.PathError 或 pgconn.PgError 开始，每一层包装都必须用 %w，且顶层错误必须暴露 ErrorCode()。少一次 %w，就断一次根因追溯能力。
