rate.Limiter仅支持限流，不能替代熔断或降级；三者须分层设计：限流在入口快筛，熔断保护下游调用，降级在业务代码中实现有损可用。
rate.Limiter 能做限流，但不能单独实现降级或熔断；三者必须分层设计、各司其职——限流拦请求洪峰，熔断防故障扩散，降级保核心可用。直接把 rate.Limiter 当熔断器用，或用同一个中间件混写三种逻辑，上线后必然误拒、漏判、状态混乱。
用 rate.Limiter 做 IP/用户级限流，别用全局单桶
全局限流器（如 var globalLimiter = rate.NewLimiter(rate.Every(1*time.Second), 100)）只适合压测挡板或内部管理接口，生产 API 绝对不能用。它会让一个恶意 IP 刷爆额度，导致所有用户 429。
- 按
c.RealIP()提取真实客户端 IP，构造唯一 key；用sync.Map缓存每个 IP 对应的*rate.Limiter - burst 值建议设为 QPS 的 2–3 倍（如 QPS=10 → burst=20），否则短连点击（如双击按钮）就触发限流
- 不主动清理过期桶？内存会缓慢增长；可配合定时 goroutine 扫描
sync.Map，或改用带 TTL 的ttlcache库 - 多实例部署时，
sync.Map仅限单机有效，必须切到 Redis + Lua（例如用INCR+EXPIRE原子组合）
用 go-hystrix 或状态机实现熔断，别靠 rate.Limiter 模拟
rate.Limiter 没有失败计数、窗口统计、状态跃迁能力，强行复用会导致“超时当失败”“重试放大错误”“open 状态永不恢复”等典型问题。
- 推荐用已归档但稳定可用的
github.com/afex/hystrix-go/hystrix：它内置滑动窗口、半开探测、fallback 回调，配置项明确（ErrorPercentThreshold、SleepWindow、RequestVolumeThreshold） - 若拒绝第三方依赖，手写熔断器必须维护三个原子状态（
closed/open/half-open），且错误统计要用环形缓冲区或时间分片窗口，不能只记总数 - 熔断应作用于下游调用点（如 HTTP client 请求支付服务），而非 HTTP handler 入口；在 Echo 中，把它封装成 service 层 wrapper，而非中间件
- 注意：熔断器必须和具体依赖绑定（如
payClient.CircuitBreaker），不能共用一个实例跨服务
降级逻辑必须显式编码，不能靠中间件自动 fallback
限流返回 429、熔断跳过调用，都不等于降级——降级是“有损但可用”，比如查不到缓存就读默认值、支付失败转余额支付、推荐接口挂了返回空列表。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 降级分支要写在业务代码里，不是中间件里；例如：
if err != nil && circuit.IsOpen() { return defaultRecommendList(), nil } - 不要在中间件统一 return 静态 JSON；不同接口降级策略不同（订单页不能降级，首页可以）
- 关键路径（如登录、下单）的降级结果必须可审计；建议打日志并上报指标（如
recommend_fallback_total{reason="circuit_open"}） - JWT 鉴权失败不能降级——这是安全边界，必须硬拦截；而用户头像加载失败可以降级为默认头像
三者共存时的执行顺序和隔离要点
限流、熔断、降级不是并列选项，而是嵌套调用链中的不同环节：HTTP 入口 → 限流中间件（快筛）→ handler → 下游调用前走熔断器 → 调用失败后进降级分支。
立即学习“go语言免费学习笔记（深入）”；
- 限流中间件必须在最外层，早于任何业务逻辑和鉴权；否则攻击者可通过非法 token 触发 panic 绕过限流
- 熔断器不能放在中间件里全局 wrap 所有 handler；它只包裹具体外部依赖（如
userSvc.GetProfile()），否则会把 DB 查询、Redis 调用也一并熔断 - 降级没有中间件形态；它是业务方法内部的 if-else 分支，且 fallback 逻辑本身也要加超时和轻量限流（避免降级路径被刷爆）
- 监控必须分开打点：限流数（
http_requests_limited_total）、熔断数（hystrix_calls_total{state="short_circuited"}）、降级数（service_fallback_total{endpoint="recommend"}）
