0

0

如何在 Go 的 net/http 中为 HTTP 处理器添加中间件

心靈之曲

心靈之曲

发布时间:2025-12-30 11:58:02

|

282人浏览过

|

来源于php中文网

原创

如何在 Go 的 net/http 中为 HTTP 处理器添加中间件

本文详解如何将自定义中间件(如 accept 头校验)正确应用于 go 标准库的 `http.handler`,包括中间件链式注册方法、常见错误规避及 app engine 兼容实践。

在 Go 的 net/http 包中,中间件本质是接收 http.Handler 并返回新 http.Handler 的函数。要为 productHandler 添加 Accept 中间件,关键在于理解类型转换与调用顺序:http.HandleFunc 仅接受 func(http.ResponseWriter, *http.Request) 类型,而中间件需操作 http.Handler 接口。因此,必须先将普通处理器函数包装为 http.HandlerFunc,再传入中间件。

✅ 正确用法:链式注册中间件

http.Handle("/products/", Accept(http.HandlerFunc(productHandler)))

此处:

  • http.HandlerFunc(productHandler) 将函数转为满足 http.Handler 接口的值;
  • Accept(...) 接收该 Handler,返回一个增强版 Handler;
  • http.Handle() 注册最终处理链(而非 http.HandleFunc,因后者不支持中间件组合)。

? 完整可运行示例

package main

import (
    "fmt"
    "net/http"
)

// Accept 中间件:强制请求头 Accept: application/json
func Accept(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        if r.Header.Get("Accept") != "application/json" {
            http.Error(w, "Unsupported Accept header. Expected: application/json", http.StatusNotAcceptable)
            return
        }
        next.ServeHTTP(w, r)
    })
}

func productHandler(w http.ResponseWriter, r *http.Request) {
    switch r.Method {
    case "GET":
        fmt.Fprint(w, `{"products": []}`)
    default:
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
    }
}

func main() {
    // ✅ 正确:使用 http.Handle + 中间件包装
    http.Handle("/products/", Accept(http.HandlerFunc(productHandler)))

    // 可扩展:多层中间件(如日志 + 认证 + Accept)
    // http.Handle("/products/", Auth(Log(Accept(http.HandlerFunc(productHandler))))))

    fmt.Println("Server starting on :8080...")
    http.ListenAndServe(":8080", nil)
}

⚠️ 常见错误分析

  • ❌ 错误写法:http.HandleFunc("/products/", Accept(...))
    → Accept 返回 http.Handler,但 HandleFunc 要求 func 类型,编译失败。

  • ❌ 自定义结构体 Pr 实现 ServeHTTP 时拼写错误(如 ServeHttp 少了大写 H)且未实现接口方法签名,导致无法满足 http.Handler 接口。

  • ❌ 中间件内部遗漏 next.ServeHTTP(w, r) 调用,或位置错误(如放在 return 后),导致后续处理器永不执行。

    通吃客零食网整站 for Shopex
    通吃客零食网整站 for Shopex

    第一步】:将安装包中所有的文件夹和文件用ftp工具以二进制方式上传至服务器空间;(如果您不知如何设置ftp工具的二进制方式,可以查看:(http://www.shopex.cn/support/qa/setup.help.717.html)【第二步】:在浏览器中输入 http://您的商店域名/install 进行安装界面进行安装即可。【第二步】:登录后台,工具箱里恢复数据管理后台是url/sho

    下载

? 在 Google App Engine SDK 中的注意事项

App Engine 标准环境(Go 1.11+)完全兼容标准 net/http,上述方案可直接使用。只需确保:

  • 主入口函数(如 init() 或 main())中完成路由注册;
  • 不依赖 http.ListenAndServe(App Engine 会自动注入 http.Handler 到运行时);
  • 若使用 app.yaml,保持 handlers 配置指向正确路径(如 /products/)。

✅ 总结

中间件不是“附加”到处理器上的装饰器,而是通过函数组合构建新处理器的过程。核心原则是:

  1. 所有中间件函数签名应为 func(http.Handler) http.Handler;
  2. 使用 http.HandlerFunc 显式转换普通函数;
  3. 用 http.Handle(而非 HandleFunc)注册中间件链;
  4. 确保中间件内 next.ServeHTTP 被正确调用且无逻辑阻断。

遵循此模式,即可轻松为任意处理器添加认证、日志、CORS、内容协商等通用能力。

相关专题

更多
什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

175

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

212

2025.12.18

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

193

2025.06.09

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

185

2025.07.04

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

988

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

48

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

158

2025.12.29

C++类型转换方式
C++类型转换方式

本专题整合了C++类型转换相关内容,想了解更多相关内容,请阅读专题下面的文章。

288

2025.07.15

excel制作动态图表教程
excel制作动态图表教程

本专题整合了excel制作动态图表相关教程,阅读专题下面的文章了解更多详细教程。

30

2025.12.29

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.1万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号