Go 的 error 接口设计天然支持解耦，通过行为契约而非具体实现实现模块间松耦合；自定义错误应包装底层错误、避免裸指针比较、结构化字段需封装访问；errors.As 应限于边界层且封装为语义化函数；panic/recover 仅用于启动失败等意外场景，业务错误须走 error 链路；各层只处理自身可决策的错误，其余原样透传并保留错误链。
Go 的 error 类型本身就是解耦的接口
Go 不强制要求 panic 或继承异常类，error 是一个只含 Error() string 方法的接口。这意味着任何包都可以定义自己的错误类型，只要实现该方法，就能和标准库、其他模块无缝协作——不依赖具体实现，只依赖行为契约。
这种设计天然支持解耦：业务逻辑层无需 import 数据库或 HTTP 包，也能接收并处理它们返回的 error；调用方只关心“出错了”，不关心“谁抛的错”。
- 自定义错误建议用
fmt.Errorf套%w包装底层错误，保留栈信息（如fmt.Errorf("failed to open file: %w", err)） - 避免直接比较
err == io.EOF这类裸指针判断，改用errors.Is(err, io.EOF)—— 它能穿透多层包装，更健壮 - 若需携带结构化字段（如错误码、请求 ID），定义带字段的 struct 并实现
Error()方法，但别暴露内部字段给调用方，否则又耦合了
使用 errors.As 提取特定错误类型会破坏解耦吗？
会，但必要时可控。比如你依赖某个外部 SDK 返回了 *http.ResponseError，而你需要读取它的 StatusCode 字段做重试决策——这时必须用 errors.As(err, &target) 把错误“还原”成具体类型。
关键在于：这个提取动作应严格限制在最靠近错误源头的边界层（如 adapter 层或 client 封装层），绝不让业务逻辑层直接调用 errors.As 去解析下游错误。
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 把
errors.As封装进一个函数，比如IsRateLimited(err)，对外只暴露语义化判断，隐藏底层类型 - 如果多个地方都需要提取同一类错误，说明你可能漏掉了一层抽象——考虑定义统一的错误分类接口（如
Temporary() bool），由各错误类型自行实现 - 过度使用
errors.As会让测试变脆弱：一旦下游错误类型变更（哪怕只是重命名 struct），你的提取逻辑就失效
defer + recover 不该用于常规错误处理
Go 中 panic/recover 是为真正意外场景（如空指针解引用、无限递归）准备的，不是 try/catch 的替代品。把它用在 HTTP handler 里捕获数据库超时，等于把控制流错误伪装成异常，反而加重耦合。
因为 recover 会强制你在调用栈某一层“拦截并消化” panic，这层必须知道所有可能 panic 的路径，也就被迫依赖了那些本该被隔离的组件。
- HTTP handler 应该用
if err != nil { return err }向上返回，由统一中间件（如func(http.Handler) http.Handler）做错误转 HTTP 状态码 - 数据库操作中遇到
context.DeadlineExceeded，应该原样返回，而不是 recover 后转成自定义错误——上层按需处理即可 - 唯一合理用
recover的地方是程序启动阶段（如初始化全局连接池失败），防止整个服务起不来；运行时业务错误一律走error链路
错误处理代码写在哪，决定了耦合程度
错误不该在数据访问层（DAO）里被“消化”掉。例如 DAO 函数返回 nil, nil 表示“没查到数据”，看似简化了调用方，实则抹杀了“是真没数据，还是 DB 连接失败”的区别，迫使上层无法区分处理。
真正的解耦，是让每一层只处理自己能决策的错误，其余原样透传。
- DAO 层：只做 SQL 执行，错误全量返回（包括
sql.ErrNoRows）；不判断“是不是预期为空”，那是 service 层的事 - Service 层：收到
sql.ErrNoRows可转成业务错误user.NotFoundError，但要保留原始错误（%w），方便日志追踪 - API 层：只负责把
user.NotFoundError映射成 HTTP 404，不碰数据库错误细节
func (s *UserService) GetByID(id int) (*User, error) {
u, err := s.repo.FindByID(id)
if err != nil {
if errors.Is(err, sql.ErrNoRows) {
return nil, &user.NotFoundError{ID: id}
}
return nil, fmt.Errorf("failed to query user: %w", err)
}
return u, nil
}
错误链越长，责任越清晰。怕的是在 repo 里写 if err != nil { log.Fatal(err) }——这等于把日志、监控、恢复策略全焊死在数据层。
