Go net/http 标准库基础

一、知识点

net/http 包的设计理念

Go 的 net/http 包是标准库中最具代表性的设计之一，它遵循接口驱动的设计哲学。整个包围绕两个主要接口展开：

• Handler 接口处理 HTTP 请求的主要抽象
• ResponseWriter + *Request请求-响应的载体

这种设计的精妙之处在于解耦。你可以用任何自定义类型实现 Handler 接口。接下来注册到服务端，不需要继承任何类或框架提供的基类。这是 Go “接口即契约” 思想的典型体现。

Handler 接口

type Handler interface {
ServeHTTP
}

任何实现了 ServeHTTP 方法的类型都可以作为 HTTP 处理器。标准库提供了 HandlerFunc 类型作为函数适配器。让普通函数也能当作 Handler 使用：

type HandlerFunc func
func ServeHTTP {
f
}

痛点：新人常误以为只能使用结构体实现 Handler，忽略了函数适配器导致代码冗余。

ServeMux —— 路由多路复用器

ServeMux 是标准库内置的路由分发器，负责将 URL 匹配到对应的 Handler：

• 注册路由这方面，mux.Handle 或 mux.HandleFunc
• 说到匹配规则，最长前缀匹配
• 方法规范的观点是，自动处理冗余斜杠（// → /)
• 说到区分大小写。URL 方法匹配是大小写敏感

Server 结构体与 ListenAndServe

type Server struct {
Addr string // 监听地址，例如 ":8080"
Handler Handler // 若 nil 则使用 DefaultServeMux
ReadTimeout time.Duration // 读取请求超时
WriteTimeout time.Duration // 写入响应超时
IdleTimeout time.Duration // Keep‑Alive 空闲超时
MaxHeaderBytes int // 请求头最大字节数
}

alert 是快捷函数，内部创建一个默认的 Server。生产环境建议显式配置 Server，以便控制超时行为——没有超时的服务是生产事故的温床。

ResponseWriter 与 Request

ResponseWriter 用法要点：

• w.WriteHeader ——只能调用一次且必须在写入正文前调用。
• w.Write ——写入响应体；若未调用 Hello WriteHeader，会自动写入 StatusOK。
• w.Header——获取可修改的响应头对象；话说回来，必须在调用 WriteHeader 之前完成设置。

• r.Method ——HTTP 方法。
• r.URL ——解析后的 URL 对象。
• r.Header ——请求头集合。
• r.Body ——io.ReadCloser，需要在读取完毕后手动关闭。
• r.FormValue ——自动解析 query string 与 POST 表单。
\ /ul>

痛点：忘记在业务结束后关闭 >r.Body导致连接泄漏；其实，或者在写入正文后再设置 Header，导致 Header 被忽略。

关键注意事项

1. >WriteHeader只能调用一次 : 重复调用会导致 panic 或无效。
2. >Header 必须在 WriteHeader 前设置 : 否则不生效。
3. >Body 必须关闭 :防止连接池泄漏。
4. 没有路由参数" ：标准库 ServeMux 不支持 "/users/:id" 这类参数化路由，需要手动解析或引入第三方框架。
5. 默认无超时" ：ListenAndServe 没有任何超时配置。生产环境必须显式设置，否则容易被慢请求拖垮。
/ ol>

二、练习代码

示例 ：最基础的 HTTP 服务

示例 ：自定义 Handler 结构体

示例 ：带超时的生产级 Server 配置

示例 ：ResponseWriter 使用要点演示

使用者痛点汇总与方法：

• Panic 因为多次 WriteHeader： #方法# 在业务代码里统一使用一次性封装函数或中间件确保只调用一次。
• CORS 或自定义 Header 设置失效： #方法# 确保所有 Header 在第一次 Write 调用前完成设置，可使用 middleware 提前统一注入。
• #Body 未关闭导致连接耗尽#： #方法# 在所有读取 Body 的入口统一加上 .
• #缺少请求超时导致慢攻击#： #方法# 使用显式配置 Server.ReadTimeout / WriteTimeout，并结合 context 超时控制业务层逻辑。
• #无法直接获取方法参数#： #方法# 手动切割 ,或者引入轻量级 router进行参数化路由。