Echo框架本身不内置熔断降级能力，必须通过Sentinel等外部组件在中间件中实现：需显式定义资源名（如"GET:/user/:id"），在中间件调用sentinel.Entry()拦截请求并判断，失败则直接降级，成功才执行handler，且必须正确defer entry.Exit()。
Echo 框架本身不内置熔断降级能力，必须靠外部组件（如 Sentinel、Hystrix 兼容层或自研逻辑）在中间件中拦截请求并决策。直接在 e.GET("/user/:id", handler) 上加注解或参数是无效的——Echo 的路由函数只注册 handler，不参与流量治理。
为什么不能直接在 Echo 路由里配熔断
Echo 的 GET、POST 等方法只是把路径和 handler 绑定到路由树，整个生命周期里不感知“失败率”“RT”“QPS”等熔断指标。熔断需要持续采集指标 + 实时判断状态 + 动态拦截后续请求，这些必须由独立的规则引擎完成。
- 所有熔断逻辑必须包裹在中间件中，且需放在路由匹配之后、handler 执行之前
- 若用 Sentinel，要靠
SentinelResource显式定义资源名（如"GET:/user/:id"），而不是依赖路径自动识别 - 路径参数（如
:id）会被视为同一资源，但 Sentinel 默认不会自动聚合；需手动拼接或用EntryWithResource控制粒度
用 Sentinel + 中间件实现路由级熔断
核心是把每个关键路由包装成一个 Sentinel 资源，并在中间件里调用 entry, err := sentinel.Entry("GET:/users/:id")。失败时走降级，成功时才执行原始 handler。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 资源名建议按
HTTP_METHOD:PATH_PATTERN命名，例如"GET:/api/v1/users/*"，避免用带具体值的路径（如/users/123）导致资源爆炸 - 必须在
defer entry.Exit()前检查err != nil，否则Exit()会 panic - 降级逻辑不能写在
blockHandler里（那是注解方式用的），而应直接在中间件中return c.JSON(...) - 注意：Sentinel Go 版本（
github.com/alibaba/sentinel-golang）不支持 Feign 那类声明式降级，必须手写 if-else 分支
func SentinelMiddleware(resource string) echo.MiddlewareFunc {
return func(next echo.Handler) echo.Handler {
return echo.HandlerFunc(func(c echo.Context) error {
entry, err := sentinel.Entry(resource)
if err != nil {
// 熔断或限流触发，直接降级
return c.JSON(http.StatusServiceUnavailable, map[string]string{
"error": "service degraded",
"resource": resource,
})
}
defer entry.Exit()
return next.ServeHTTP(c.Response(), c.Request())
})
}
}
// 使用
e.GET("/users/:id", getUserHandler).Use(SentinelMiddleware("GET:/users/:id"))
容易踩的三个坑
实际接入时最常卡在这三点：
-
SentinelResource名字没对齐：前端发的是GET /users/123，但中间件里写的资源名是"GET:/users"，导致指标不采集、规则不生效 - 忘记调用
entry.Exit()或在错误位置 defer（比如 defer 放在 return 之后），引发资源泄漏和后续请求全部 block - 把降级响应写成
c.String()但没设 status code，浏览器收到 200 却显示错误内容，前端重试逻辑失效
真正难的不是写那几行中间件，而是让每个资源名可运维、可监控、可对齐——比如 /orders/:id 和 /orders/batch 是否该归为同一资源？这得看它们共用下游服务的程度，而不是看路径长得像不像。
