go错误处理应使用自定义类型而非int错误码，通过bizerror结构体实现error接口和code()方法，配合errors.as提取并映射http状态码，利用%w和unwrap()维持错误链完整性。
Go 里没有“错误码体系”这回事，只有你愿不愿意用类型把错误语义显式表达出来。硬塞 int、拼字符串、靠 err.Error() 匹配，都是在绕开 Go 的错误哲学，迟早掉坑里。
为什么不能直接用 int 定义错误码
看似省事：const ErrUserNotFound = 404，但实际立刻引发三类问题：
-
ErrUserNotFound和http.StatusNotFound类型相同、语义冲突，调用方根本分不清这是业务逻辑错还是传输层错 - 不同模块都定义
ErrNotFound = 1001，但一个指“用户不存在”，另一个指“订单不存在”，查日志时完全无法定位 - 编译器不拦你，IDE 跳不到定义，
if err == ErrUserNotFound直接报错（error和int不可比），最后退化成脆弱的字符串匹配
怎么定义带 Code() 和 Error() 的自定义错误类型
核心是结构体 + 接口实现，不是继承，也不靠反射。所有业务错误统一走 *BizError 类型，它必须满足两个条件：
- 实现
error接口（只暴露Error()方法，返回用户友好的提示，不含码） - 提供
Code()方法（返回ErrorCode类型，供中间件或 handler 判断）
示例结构：
type ErrorCode int
const (
ErrUserNotFound ErrorCode = iota + 1000
ErrInvalidParam
ErrTimeout
)
type BizError struct {
code ErrorCode
message string
cause error
}
func (e *BizError) Error() string { return e.message }
func (e *BizError) Code() ErrorCode { return e.code }
func (e *BizError) Unwrap() error { return e.cause }
注意：ErrorCode 是具名类型，和 int 不兼容，避免误传；从 1000 开始编号，预留系统错误空间；Error() 里不拼接敏感信息或业务上下文（如用户名、token）。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
如何用 errors.As 安全提取并映射 HTTP 状态码
调用方必须用 errors.As(err, &BizError{}) 提取，而不是 errors.Is(err, someErr)——后者只适合底层系统错误（如 os.IsNotExist）。
- 映射关系不能写死在 handler 里，也不能靠
switch每个Code去判——新增一个错误码就得改一堆地方 - 定义全局映射表，比如
var httpStatusMap = map[ErrorCode]int{ErrUserNotFound: http.StatusNotFound, ErrInvalidParam: http.StatusBadRequest} - handler 中统一用
errors.As尝试断言为*BizError，再查表取状态码 - 没匹配上的默认用
http.StatusInternalServerError，但要打日志告警——说明漏配了新错误码
不要在 BizError 里直接存 HTTP 状态码，它属于传输层语义，和业务域无关。
怎么让错误链不断、且能穿透多层判断
关键在 %w 和 Unwrap()：
- DB 层返回
sql.ErrNoRows，业务层必须用fmt.Errorf("user not found: %w", sql.ErrNoRows)包装，不能用%v或字符串拼接 - 自定义错误类型如果想参与错误链，必须自己实现
Unwrap() error方法，返回下一级错误 -
errors.Is(err, io.EOF)能命中fmt.Errorf("read failed: %w", io.EOF)包裹后的结果，前提是每一层都用了%w或实现了Unwrap - 如果自定义错误没实现
Unwrap，那它就是链的终点，errors.Is和errors.As不会继续往下钻
最常被忽略的是：错误链不是自动形成的，而是靠每个环节主动选择是否包裹、如何包裹。一旦某层用了 %v 或裸 errors.New，整条链就断了，上游再也看不到原始根因。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
