Go接口超时降级必须手动判断errors.Is(err, context.DeadlineExceeded)或errors.Is(err, context.Canceled)，显式调用fallback；禁用字符串匹配和零值结构体，须用构造函数返回语义明确的默认值。
Go 里接口超时降级不是自动发生的，必须手动检查 context.DeadlineExceeded 和 context.Canceled 并显式跳转 fallback；返回默认值时，零值结构体极易被前端误判为“真实空数据”，得用构造函数控制语义。
如何正确判断超时并触发降级
很多人以为加了 context.WithTimeout 就能自动走降级逻辑，其实它只让下游返回错误，你仍需在调用后立刻判断。漏掉 context.Canceled 是高频坑点——上游主动中断（比如 Nginx 超时、gRPC 客户端 cancel）时，err 是 context.Canceled，不是 DeadlineExceeded，不检查就会直接返回 500。
- 必须同时用
errors.Is(err, context.DeadlineExceeded)或errors.Is(err, context.Canceled)判断，别写err == context.DeadlineExceeded（类型不匹配） - 禁用
strings.Contains(err.Error(), "timeout")—— HTTP transport、gRPC、DB 驱动返回的错误文本完全不一致，不可靠 - 对 gRPC 调用，
status.FromError(err).Code()可能是codes.DeadlineExceeded，但底层仍是 context 错误包装，仍要走errors.Is路径 - HTTP 客户端若用了自定义
http.Transport，记得配IdleConnTimeout和MaxIdleConnsPerHost，否则连接池耗尽会伪装成超时
fallback 函数怎么写才安全
降级函数不是兜底 panic 的保险丝，而是「主动选择次优路径」。它一旦执行，就必须轻量、无副作用、零延迟。
- 签名必须严格匹配主函数：如果主逻辑是
func GetUser(id string) (*User, error)，fallback 也得返回(*User, error)，哪怕error是nil - 禁止在 fallback 里发起任何网络请求（HTTP/DB/gRPC）、起 goroutine、改状态、打告警日志——这些该在主流程失败后统一处理
- 别用全局变量存默认实例，比如
var defaultUser = &User{Name: "guest"}，并发修改风险高；每次新建开销极小，直接return DefaultUser(), nil - 避免返回零值结构体：
&User{}序列化后是{"name":"","age":0}，前端可能当成真实空用户；改用私有构造函数，例如func DefaultUser() *User { return &User{Name: "guest", Age: 18} }
哪些错误该降级，哪些必须透出
降级只应对 transient 错误（瞬时故障），permanent 错误（业务正常态）必须原样返回，否则掩盖问题。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 可降级：网络层错误如
"dial tcp: i/o timeout"、connection refused；HTTP 状态码503 Service Unavailable；gRPCcodes.Unavailable、codes.DeadlineExceeded - 不可降级：业务语义明确的错误，如
sql.ErrNoRows（查无此人是预期结果）、404 Not Found、400 Bad Request、gRPC codes.NotFound或codes.InvalidArgument - 强一致性操作（如资金扣减、库存变更）不该降级——返回假数据比报错更危险，应走熔断或重试
- 数据库查询中，
sql.ErrNoRows不是错误，是正常分支；而"dial tcp: connect: connection refused"才该触发降级
动态开关和 fallback 的可观测性
硬编码的降级等于没开关。上线后发现 fallback 返回的数据格式错了，或者下游已恢复，你的服务还在吐默认值——这就从容错变成了故障放大器。
- 降级开关必须可动态配置，推荐接入配置中心（如 Nacos、Apollo），支持运行时热更新
- 开关需与熔断器联动：比如
gobreaker进入 open 状态时，自动启用 fallback；半开状态时可选择性关闭 - 每次 fallback 执行都应打结构化日志，至少包含：接口名、触发原因（
DeadlineExceeded还是Canceled）、是否命中开关、耗时；别只记 “降级成功” - 监控指标至少要有：降级总次数、降级率（降级数 / 总调用数）、各错误类型分布（区分超时、取消、连接拒绝）
最常被忽略的是 fallback 的 JSON 序列化语义——Age int 字段降级时填 0 还是 nil，取决于业务是否允许“年龄未知”；这时候用 *int 类型比 int 更诚实，也比加 omitempty 标签更可控。
