责任链模式在Go中的典型误用是滥用interface{}或Java式继承，正确做法是用函数类型链式拼接并透传context.Context；每个https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler接收next并自主决定是否调用，支持短路、类型安全与灵活组合。
很多人一上来就用 interface{} 做处理器抽象，或者强行套用 Java 风格的抽象基类 + 子类继承，结果导致类型丢失、泛型不安全、中间件难以组合。Go 里责任链的核心不是“继承”，而是“函数链式拼接”和“请求上下文透传”。真正的起点是定义一个统一的处理签名：func(ctx context.Context, req interface{}) (interface{}, error)，所有环节都遵守这个契约。
Go 没有内置责任链语法糖，但可以用函数类型 + 闭包天然实现。关键在于把“下一个处理器”作为参数传入当前处理器，形成显式调用链，避免隐式递归或全局注册表。
type https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler func(context.Context, interface{}) (interface{}, error)
func Withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Logging(next https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler {
return func(ctx context.Context, req interface{}) (interface{}, error) {
log.Printf("→ %T received", req)
defer log.Printf("← %T done", req)
return next(ctx, req)
}
}
func Withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Timeout(d time.Duration) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler {
return func(ctx context.Context, req interface{}) (interface{}, error) {
ctx, cancel := context.Withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Timeout(ctx, d)
defer cancel()
return req, nil // 实际中这里会继续调用 next
}
}
- 每个装饰器（如
Withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Logging）接收https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler并返回新https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler，不修改原逻辑 - 链式调用顺序即执行顺序：
Withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Logging(Withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Timeout(100*time.Millisecond)(finalhttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler)) - 注意：
Withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Timeout示例中未调用next是为了突出“短路”能力——某个环节可直接返回，不往下传
有人写类似 https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9 := Newhttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler().Use(A).Use(B).https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andle(req) 的结构体链式调用，这看似简洁，但隐藏严重问题：
-
Use方法必须保存所有中间件到内部切片，丧失编译期类型检查 - 无法对单个环节做条件跳过（比如只对 POST 请求加鉴权）
- 错误处理分散：有的在
Use里 panic，有的在https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andle里返回 error，行为不一致 - 性能上多一次切片遍历，且每次
Use都要分配内存
真正轻量可控的方式，是让每个环节自己决定是否调用 next，而不是由框架统一 for-range 调度。
立即学习“go语言免费学习笔记（深入）”；
Go 标准库 https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler 本身就是责任链雏形，但它的 https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.Servehttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9TTP 签名不带 context.Context 参数，容易导致上下文丢失。正确做法是封装一层：
type https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9TTPhttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler func(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.ResponseWriter, *https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.Request, context.Context) errorfunc Chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9 https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9TTPhttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler, middlewares ...func(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9TTPhttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9TTPhttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler { for i := len(middlewares) - 1; i >= 0; i-- { https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9 = middlewaresi } return https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andlerFunc(func(w https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.ResponseWriter, r *https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.Request) { if err := https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9(w, r, r.Context()); err != nil { https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.Error(w, err.Error(), https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.StatusInternalServerError) } }) }
// 使用 https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler := Chttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ain(https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andleUser, Withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9Authttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9, Withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9RateLimit) https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9ttp.ListenAndServe(":8080", https://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9andler)
注意中间件顺序从右往左应用（即 Withttps://www.php.cn/link/d3d92bc35d062c83f89b7ea87d99dca9RateLimit 最先执行），这是函数组合的自然特性。如果顺序写反，认证可能在限流之后才触发，导致未授权请求仍消耗配额。
最易被忽略的一点：所有中间件必须显式将 ctx 传递给下游，否则 cancel() 或超时信号无法穿透整条链。一旦某个环节忘了传 ctx，整条链就退化成阻塞式调用。
