如何在 Go Web 应用中实现请求预处理（如 IP 黑名单校验）

本文介绍如何利用 go 标准库 `net/http` 的中间件思想，在所有路由处理器执行前统一运行预处理逻辑（如 ip 黑名单检查），无需修改业务 handler，兼容 `http.servemux`、gorilla mux 等任意 `http.handler` 实现。

在 Go 的 HTTP 生态中，net/http 包本身不提供“中间件”或“全局前置钩子”的显式概念，但其基于 http.Handler 接口的组合设计天然支持链式封装——这正是实现“运行函数于所有处理器之前”的核心机制。

最简洁、通用且符合 Go 惯例的方式是：创建一个包装型 handler（wrapper handler），它接收原始 handler（如 *http.ServeMux 或 *gorilla/mux.router），并在调用其 ServeHTTP 方法前插入自定义逻辑。

以下是一个生产就绪的 IP 黑名单校验示例：

type IPChecker struct {     next http.Handler }  func (c IPChecker) ServeHTTP(w http.ResponseWriter, r *http.Request) {     // 提取真实客户端 IP（注意：r.RemoteAddr 可能为代理地址，生产环境建议结合 X-Forwarded-For 处理）     clientIP := getClientIP(r)      if isBlacklisted(clientIP) {         http.Error(w, "Access denied: IP address blocked", http.StatusForbidden)         return     }      // 通过 —— 继续调用下游 handler     c.next.ServeHTTP(w, r) }  // 辅助函数：获取可信客户端 IP（示例，需根据部署环境调整） func getClientIP(r *http.Request) string {     // 优先从 X-Real-IP 或 X-Forwarded-For 获取（需确保反向代理已设置并可信）     if ip := r.Header.Get("X-Real-IP"); ip != "" {         return ip     }     if ip := r.Header.Get("X-Forwarded-For"); ip != "" {         // 取第一个（防伪造，需配合可信代理配置）         if i := strings.Index(ip, ","); i > -1 {             return strings.TrimSpace(ip[:i])         }         return strings.TrimSpace(ip)     }     // 回退到 RemoteAddr（仅适用于直连场景）     host, _, _ := net.SplitHostPort(r.RemoteAddr)     return host }

使用方式极其简单：只需将你原本传给 http.ListenAndServe 的 handler 封装一层即可：

// 假设你使用 Gorilla Mux r := mux.NewRouter() r.HandleFunc("/", homeHandler).Methods("GET") r.HandleFunc("/api/users", userHandler).Methods("POST")  // ✅ 添加前置校验：用 IPChecker 包装路由器 handler := IPChecker{next: r}  log.Println("Server starting on :8080") http.ListenAndServe(":8080", handler)

⚠️ 注意事项：r.RemoteAddr 默认包含端口号（如 192.168.1.100:54321），解析时务必用 net.SplitHostPort 提取 IP；若应用部署在 Nginx、Cloudflare 等反向代理后，RemoteAddr 将是代理地址，必须依赖 X-forwarded-For 或 X-Real-IP 头，并确保代理已正确配置且头字段不可被客户端篡改；IPChecker 是无状态结构体，可安全复用；若需注入依赖（如黑名单存储），建议改为函数式中间件或带字段的闭包；此模式完全正交于路由库选择——无论是标准 http.ServeMux、Gorilla Mux、Chi 还是 Gin（适配器模式下），只要满足 http.Handler 接口，均可无缝集成。

总结来说，Go 的 http.Handler 接口设计鼓励组合而非继承。通过编写轻量 wrapper，你不仅能实现 IP 校验，还可轻松扩展日志记录、身份认证、请求限流、CORS 注入等各类前置逻辑——这是构建健壮、可维护 Go Web 服务的基础范式。