Go Academy · 课时

中间件模式

Q: 「中间件模式」这节课中我会学到什么？

链接处理器以实现日志记录和身份验证 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

链接处理器以实现日志记录和身份验证

中间件模式 是 CoddyKit 上的免费 Go Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

什么是中间件？

中间件是一个包装 http.Handler 的函数，用于添加横切行为（日志记录、身份验证、恢复），而无需修改处理程序的业务逻辑。

中间件签名

中间件是一个接收 http.Handler 并返回 http.Handler 的函数：

type Middleware func(http.Handler) http.Handler

简单的日志记录中间件

请在处理程序运行前后分别记录每个请求：

func Logger(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        log.Printf("%s %s", r.Method, r.URL.Path)
        next.ServeHTTP(w, r)
        log.Printf("done %s", r.URL.Path)
    })
}

链接中间件

通过嵌套应用多个中间件层：

handler := Logger(Auth(RateLimit(myHandler)))
http.ListenAndServe(":8080", handler)

中间件链辅助函数

请构建一个链函数，按顺序应用中间件，从而避免深层嵌套：

func Chain(h http.Handler, m ...Middleware) http.Handler {
    for i := len(m)-1; i >= 0; i-- {
        h = m[i](h)
    }
    return h
}
// Usage: Chain(myHandler, Logger, Auth, RateLimit)

身份验证中间件

请在调用下一个处理程序之前检查身份验证。如果令牌缺失或无效，请立即返回 401。

func Auth(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        token := r.Header.Get("Authorization")
        if !isValid(token) {
            http.Error(w, "Unauthorized", http.StatusUnauthorized)
            return
        }
        next.ServeHTTP(w, r)
    })
}

恐慌恢复中间件

捕获处理程序产生的恐慌，以防止服务器崩溃：

func Recovery(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        defer func() {
            if err := recover(); err != nil {
                log.Printf("panic: %v", err)
                http.Error(w, "Internal Server Error", 500)
            }
        }()
        next.ServeHTTP(w, r)
    })
}

通过上下文传递数据

中间件可以将数据附加到请求上下文，供后续处理程序使用：

ctx := context.WithValue(r.Context(), userKey, user)
next.ServeHTTP(w, r.WithContext(ctx))

响应包装器

通过包装 ResponseWriter，捕获处理程序写入的状态码：

type statusRecorder struct {
    http.ResponseWriter
    status int
}
func (r *statusRecorder) WriteHeader(code int) {
    r.status = code
    r.ResponseWriter.WriteHeader(code)
}

顺序很重要

中间件按照包装处理程序的顺序执行。Auth 应在限流之前运行；恐慌恢复应位于最外层，以便捕获其他中间件产生的恐慌。

按路由中间件与全局中间件

将全局中间件（日志记录、恢复）应用于整个多路复用器。请使用子路由器或处理程序包装器，将特定路由中间件（身份验证、限流）应用于指定的路由组。

快速检查

Go 中 HTTP 中间件的正确签名是什么？

回顾：中间件模式

关键要点：

中间件：func(http.Handler) http.Handler
通过嵌套链接；使用 Chain 辅助函数提高可读性
Recovery 位于最外层；Auth 位于业务逻辑之前
通过上下文向下游传递数据

常见问题解答

「中间件模式」课时是免费的吗？

是的 — 「中间件模式」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「中间件模式」这节课中我会学到什么？

链接处理器以实现日志记录和身份验证你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「中间件模式」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy