Golang自定义HTTP Server配置说明_技术教程

http.ListenAndServe无法设置超时参数，因内部http.Server匿名且不可配置；需显式构造http.Server并设置ReadTimeout、WriteTimeout、IdleTimeout等字段。

ListenAndServe 为什么不能设置超时参数

http.ListenAndServe 是最简启动方式，但它内部创建的 http.Server 实例是匿名且不可配置的，所有超时字段（ReadTimeout、WriteTimeout、IdleTimeout）都保持零值——这意味着连接不会因空闲或读写延迟被主动关闭，容易积累僵死连接。

真正可控的方式是显式构造 http.Server，再调用其 ListenAndServe 方法：

server := &http.Server{
    Addr:         ":8080",
    Handler:      myHandler,
    ReadTimeout:  5 * time.Second,
    WriteTimeout: 10 * time.Second,
    IdleTimeout:  30 * time.Second,
}
log.Fatal(server.ListenAndServe())

注意：ReadTimeout 从连接建立开始计时，覆盖 TLS 握手和请求头读取；IdleTimeout 才是控制 Keep-Alive 连接空闲时长的关键。

HTTP/2 支持需要 TLS 且不能用 http.Server 的默认配置

Go 1.8+ 默认启用 HTTP/2，但仅当服务器使用 TLS 启动且满足以下条件时才生效：

立即学习“go语言免费学习笔记（深入）”；

http.Server.TLSConfig 必须非 nil，且包含有效的证书与私钥
不能在 http.ListenAndServeTLS 之外手动启用 HTTP/2（比如通过 http2.ConfigureServer）——这会破坏标准行为
若使用自签名证书，客户端需跳过验证（如 curl --insecure），否则协商失败退回到 HTTP/1.1

正确做法是直接用 ListenAndServeTLS：

server := &http.Server{Addr: ":443", Handler: myHandler}
log.Fatal(server.ListenAndServeTLS("cert.pem", "key.pem"))

此时 Go 自动注册 HTTP/2 支持，无需额外导入 golang.org/x/net/http2。

Graceful shutdown 要同时处理监听套接字和活跃连接

直接调用 server.Close() 会立即关闭监听，但已接受的连接可能仍在处理中，导致请求中断。优雅关闭必须：

先关闭监听（server.Shutdown），阻止新连接进入
等待活跃连接自然结束或超时（由 Context 控制）
确保 handler 内部不忽略 context.Context 传递（例如数据库查询、下游 HTTP 调用）

典型模式：

ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
defer cancel()
if err := server.Shutdown(ctx); err != nil {
    log.Printf("server shutdown error: %v", err)
}

注意：Shutdown 不会强制终止正在运行的 handler，它只等待 handler 主动退出或 context 超时。如果 handler 里有死循环或阻塞 I/O，必须自行检查 ctx.Done()。

MaxHeaderBytes 和 ReadBufferSize 影响大请求体与恶意头攻击防御

http.Server.MaxHeaderBytes 默认是 1MB，对含大量 Cookie 或自定义 Header 的 API 可能不够；但设得过大又易被用于内存耗尽攻击。建议根据实际接口头大小设定，例如：

server := &http.Server{
    MaxHeaderBytes: 8192, // 8KB，覆盖常见 JWT + 多个自定义头
    ReadBufferSize: 4096, // 读缓冲区，影响小请求吞吐；大文件上传建议调大至 64KB+
    Handler:        myHandler,
}

ReadBufferSize 和 WriteBufferSize 是底层 bufio.Reader/Writer 的初始大小，不是硬限制——缓冲区会自动扩容。但初始值过小会导致频繁内存分配，过大则浪费连接内存。一般保持默认（4KB）即可，仅在压测发现瓶颈时调整。

真正关键的是：这些字段必须在 server.ListenAndServe 调用前设置，一旦启动就无法修改。