限流 resource 名必须为“方法:静态路由模板”,不可含 query 或动态路径值;c.Route() 为空时需 fallback 至预设常量;调用 sentinel.Entry() 要区分 ErrBlock(429)与其他错误(500+日志);务必 defer entry.Exit() 并严格对齐规则注册名。

sentinel-go)或手写轻量逻辑。直接用 c.Route() 提取路径 + 方法组合成 resource 是最稳妥的做法,但要注意 v2.48 及更早版本里它可能返回 nil。
为什么不能用完整 URL 做限流 key
带 query 的 URL(如 /api/users?id=123&trace_id=abc)会让 resource 名动态不可控,导致限流失效或误杀。必须剥离 query,只保留静态路由模板:
- ✅ 正确:
GET:/api/users/{id}(从c.Route().Path和c.Method()拼接) - ❌ 错误:
GET:/api/users?id=123或GET:/api/users/123?trace_id=xyz - ⚠️ 注意:
GET:/api/orders和POST:/api/orders必须视为两个独立 resource
如何安全调用 sentinel.Entry() 防止 panic
sentinel.Entry() 失败不等于“被限流”,也可能是配置未加载、规则未注册等运行时异常。只判 err != nil 就返回 500 会掩盖真实问题,且无法区分“拒绝”和“系统错误”:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 先检查
err类型:若为base.ErrBlock,才是真被限流,应返回429 - 其他
err(如base.ErrNoRule)需记录日志并返回500,否则线上限流规则失效都发现不了 - 务必加
defer entry.Exit(),否则连接池/统计会泄漏
fallback 到静态 resource 名的必要场景
在 Fiber v2.48 及更早版本中,c.Route() 在某些中间件链或非标准路由匹配下会返回 nil,此时必须 fallback:
- 优先尝试
c.Route().Path,失败则用预设常量,例如fmt.Sprintf("%s:%s", c.Method(), "/api/v1/users/{id}") - 不要 fallback 到
c.Path()—— 它含 query 且含通配符展开值(如/api/v1/users/123),完全破坏限流语义 - 所有 fallback 路径必须和路由定义严格一致(包括 trailing slash、大小写、参数占位符格式)
sentinel.Entry() 的 resourceName,和规则列表逐条比对。


















