Go Web应用中自定义HTTP处理器与中间件的优雅集成

package main

import (
    "fmt"
    "log"
    "net/http"
    "runtime/debug" // 用于捕获panic时的堆栈信息
)

// appError 结构体用于封装自定义错误信息，包含HTTP状态码和原始错误。
type appError struct {
    Code  int   // HTTP状态码，如 http.StatusInternalServerError
    Error error // 原始错误，提供更详细的错误信息
}

// appHandler 是一个自定义的HTTP处理器函数签名，它在执行业务逻辑后返回一个 *appError。
type appHandler func(http.ResponseWriter, *http.Request) *appError

// ServeHTTP 方法使 appHandler 满足 http.Handler 接口。
// 在此方法中，我们执行 appHandler 逻辑，并统一处理其返回的 *appError。
func (fn appHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    // defer 语句用于捕获 appHandler 内部可能发生的 panic，并将其转换为一个内部服务器错误。
    defer func() {
        if rvr := recover(); rvr != nil {
            log.Printf("Panic: %v\n%s", rvr, debug.Stack())
            serverError(w, r, fmt.Errorf("%v", rvr), http.StatusInternalServerError)
        }
    }()

    // 调用实际的 appHandler 业务逻辑函数
    if e := fn(w, r); e != nil { // 如果 appHandler 返回错误
        switch e.Code {
        case http.StatusNotFound:
            notFound(w, r) // 处理 404 Not Found 错误
        case http.StatusInternalServerError:
            serverError(w, r, e.Error, e.Code) // 处理 500 Internal Server Error
        default:
            // 对于其他自定义错误码，也统一通过 serverError 进行处理
            serverError(w, r, e.Error, e.Code)
        }
    }
}

// notFound 辅助函数，用于返回标准的 404 错误响应。
func notFound(w http.ResponseWriter, r *http.Request) {
    http.NotFound(w, r)
    log.Printf("404 Not Found: %s %s", r.Method, r.URL.Path)
}

// serverError 辅助函数，用于返回标准的错误响应，并记录详细日志。
func serverError(w http.ResponseWriter, r *http.Request, err error, code int) {
    log.Printf("HTTP %d Error for %s %s: %v", code, r.Method, r.URL.Path, err)
    http.Error(w, "Internal Server Error", code) // 实际返回给客户端的错误信息
}

// use 函数用于将多个中间件应用于一个基础处理器。
// 它接收一个 appHandler 作为基础处理器，以及一系列 http.Handler 类型的中间件函数。
// 最终返回一个 http.Handler，因为 appHandler 已经实现了 http.Handler 接口。
func use(h appHandler, middleware ...func(http.Handler) http.Handler) http.Handler {
    var res http.Handler = h // appHandler 实现了 http.Handler 接口，可以直接赋值给 http.Handler 类型变量
    for _, m := range middleware {
        res = m(res) // 依次应用中间件，每个中间件都接收一个 http.Handler 并返回一个新的 http.Handler
    }
    return res
}

// someMiddleware 是一个示例中间件，用于设置缓存控制头。
// 它接收一个 http.Handler 并返回一个新的 http.Handler。
func someMiddleware(h http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("Cache-Control", "max-age=0, private, must-revalidate")
        w.Header().Set("X-Accel-Expires", "0")
        h.ServeHTTP(w, r) // 调用链中的下一个处理器或中间件
    })
}

// anotherMiddleware 是另一个示例中间件，可以执行其他横切逻辑，例如请求日志记录。
func anotherMiddleware(h http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        log.Printf("Executing anotherMiddleware for %s %s", r.Method, r.URL.Path)
        h.ServeHTTP(w, r)
    })
}

// doSomething 是一个模拟业务逻辑的