Go中责任链模式用func(http.ResponseWriter, *http.Request) bool实现,返回true中断链,切片存储处理器并顺序执行,闭包封装依赖,避免panic和全局状态。

Go 语言没有继承和接口的强制实现机制,但责任链模式完全可以靠函数类型和结构体组合自然实现,关键不在“像不像传统 OOP 版本”,而在“请求是否能被清晰传递、每个环节是否可插拔、中断逻辑是否可控”。
用 func(http.ResponseWriter, *http.Request) bool 定义处理器签名
HTTP 场景下,责任链最常用的中断信号是布尔返回值:返回 true 表示已处理完毕,后续处理器跳过;返回 false 表示未处理或需继续传递。这个签名比 http.Handler 更灵活,能显式表达“是否终结链”。
- 不要用
http.HandlerFunc直接拼接——它不带中断语义,容易漏掉权限校验后提前退出的逻辑 - 避免在链中混用
panic控制流程,会破坏链的可预测性 - 如果需要传递上下文数据(如用户 ID、请求 ID),建议把
*http.Request改为*http.Request+map[string]interface{}或封装成自定义请求结构体
链式注册与顺序执行:用切片存处理器,for 循环控制流转
Go 没有方法链式调用语法糖,但用切片 + 显式循环是最直白、最易调试的方式。每个处理器决定是否终止链,而不是靠“调用下一个”来推进——这反而更符合 Go 的显式哲学。
type HandlerFunc func(http.ResponseWriter, *http.Request) bool
func Chain(handlers ...HandlerFunc) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
for _, h := range handlers {
if h(w, r) {
return // 中断链
}
}
http.Error(w, "no handler processed the request", http.StatusNotFound)
})
}
- 注册顺序即执行顺序,
Chain(authHandler, rateLimitHandler, apiHandler)中,authHandler最先执行 - 所有处理器共享同一个
http.ResponseWriter,注意不要多次调用w.WriteHeader()或写入响应体 - 若某个处理器需要修改请求(如解析 body、注入 header),应操作
*http.Request的副本(用r.Clone(r.Context()))或确保线程安全
中间件式责任链:用闭包捕获依赖,避免全局状态
真实项目里,处理器常依赖配置、DB 实例或日志器。用闭包封装依赖,比把它们塞进结构体再实现方法更轻量、更符合 Go 风格。
立即学习“go语言免费学习笔记(深入)”;
func AuthHandler(authService *AuthService) HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) bool {
token := r.Header.Get("Authorization")
if !authService.Validate(token) {
http.Error(w, "unauthorized", http.StatusUnauthorized)
return true
}
return false // 继续链
}
}
func LoggingHandler(logger *zap.Logger) HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) bool {
logger.Info("request started", zap.String("path", r.URL.Path))
return false
}
}
- 每个闭包返回独立的
HandlerFunc实例,天然隔离依赖,测试时可传入 mock 依赖 - 避免在闭包里捕获可变变量(如循环变量
i),否则所有处理器可能引用同一个值 - 如果依赖项较多(如同时要 logger、cache、db),考虑定义一个
HandlerConfig结构体统一传入,比堆叠多个参数更清晰
责任链真正的复杂点不在组装,而在于错误归因和链路追踪——当请求卡在第 3 个处理器却没日志、没超时、没返回时,你得靠每个处理器自己打点,而不是指望链框架兜底。










