Go语言自带的net/http包提供了完整的基础Web服务能力，开发者无需依赖任何第三方框架，就能完成从监听端口到处理请求的全流程。其核心思路是先把业务函数包装成满足特定签名的处理器，再注册到多路复用器，最后由服务器在收到TCP连接时按规则分发。理解这套机制，有助于我们在复杂项目中做更合理的分层，也方便在框架之上排查底层问题。
net/http的核心组件与请求处理流程
在net/http中，最基础的几个概念是Handler、HandlerFunc、ServeMux以及Server。其中Handler是一个接口，只要求实现ServeHTTP(ResponseWriter, *Request)方法。任何结构体只要拥有这个方法，就可以作为请求处理器。Go为了方便函数式用法，提供了HandlerFunc类型，它是一个函数别名，并且自身也实现了ServeHTTP，从而让普通函数可以直接当处理器使用。
ServeMux是自带的多路复用器，负责把请求的URL路径匹配到对应的Handler。调用http.Handle或http.HandleFunc时，实际上是把规则注册到DefaultServeMux。当调用http.ListenAndServe时，内部会构造一个Server结构，把多路复用器作为Handler字段传入，然后进入无限循环接受连接。每个连接由协程承载，这也是Go高并发能力的来源之一。
下面是一段最小可运行示例，展示如何用一个函数处理根路径并返回纯文本：
package main
import (
"fmt"
"net/http"
)
func hello(w http.ResponseWriter, r *http.Request) {
// 设置响应头与状态码
w.Header().Set("Content-Type", "text/plain; charset=utf-8")
w.WriteHeader(http.StatusOK)
fmt.Fprintln(w, "你好，这是一个基础Web服务")
}
func main() {
// 使用默认多路复用器注册路由
http.HandleFunc("/", hello)
// 在8080端口启动服务，传入nil表示使用DefaultServeMux
err := http.ListenAndServe(":8080", nil)
if err != nil {
panic(err)
}
}
上述代码在运行后，访问本机8080端口即可看到返回内容。需要注意的是，DefaultServeMux是全局变量，在大型项目中若多处注册路由，容易产生路径冲突或被第三方库意外修改，因此生产环境更推荐显式创建自己的ServeMux实例。
自定义多路复用器与中间件设计
使用http.NewServeMux()可以拿到独立的复用器，避免全局状态污染。自定义复用器同样支持Handle与HandleFunc，而且可以嵌套：把一个ServeMux作为另一个Handler挂载到某个前缀下，实现子路由分组。这种方式在单体服务按模块拆分时非常直观。
中间件在net/http里其实就是对Handler的包装函数，它接收原Handler返回新Handler，在新实现里先做日志、鉴权或恢复panic，再调用原处理器。由于接口统一，我们可以把多个中间件用函数组合起来，形成处理链。下面示例演示了日志中间件和自定义复用器的结合：
package main
import (
"log"
"net/http"
"time"
)
// 日志中间件，包裹原handler
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
log.Printf("收到请求: %s %s", r.Method, r.URL.Path)
next.ServeHTTP(w, r)
log.Printf("处理完成: %v", time.Since(start))
})
}
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/api", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("来自API的响应"))
})
// 将中间件套在mux外形成最终handler
finalHandler := loggingMiddleware(mux)
err := http.ListenAndServe(":8080", finalHandler)
if err != nil {
panic(err)
}
}
这种写法的好处是中间件与具体路由解耦，无论后续路由怎么增删，日志与监控逻辑都稳定生效。如果项目逐渐庞大，还可以把不同前缀交给不同团队维护的ServeMux，再由顶层组合，清晰且易于测试。
静态文件服务与常见误区排查
除了动态接口，net/http也内置了静态文件能力。通过http.FileServer配合http.Dir，可以把某个目录映射为HTTP可访问资源。常见用法是用StripPrefix去掉URL前缀，再交给文件服务器，避免路径拼接错误。比如把/static/开头的请求指向本地./assets目录。
一个容易踩坑的地方是：http.FileServer对路径遍历攻击有内置防护，但若手动拼接r.URL.Path到文件路径，就可能引入漏洞。正确做法是始终让FileServer自己处理路径解析。另一个误区是开发者在HandleFunc里用r.URL.Path做精确匹配，却忘了ServeMux本身已支持模式匹配，重复判断反而降低可读性。
package main
import (
"net/http"
)
func main() {
mux := http.NewServeMux()
// 把/static/下的请求映射到./assets目录
fileServer := http.FileServer(http.Dir("./assets"))
mux.Handle("/static/", http.StripPrefix("/static/", fileServer))
mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("首页"))
})
err := http.ListenAndServe(":8080", mux)
if err != nil {
panic(err)
}
}
在真实部署时，建议把静态资源交由Nginx或CDN处理，Go服务只保留API职责，这样既能利用专业组件的缓存与压缩，也能减少Go进程的文件描述符占用。但若只是内部工具或原型验证，直接用FileServer已完全够用，不必过早引入运维复杂度。
优雅关闭与基础性能调优
基础示例里的ListenAndServe会一直阻塞，直到出错才返回，这在需要平滑重启的场景下不够友好。net/http从早期版本就提供了Server结构体与Shutdown方法，配合上下文可以通知正在处理的请求尽快结束，同时拒绝新连接。利用操作系统信号监听，我们能在收到中断信号时调用Shutdown，实现零宕机发布。
性能方面，Server结构暴露了ReadTimeout、WriteTimeout、IdleTimeout等字段，合理设置可避免慢连接耗尽资源。默认情况下这些超时为零，代表不限制，若直接暴露公网，可能遭遇恶意长连接拖垮服务。以下示例展示如何显式构造Server并启用优雅关闭：
package main
import (
"context"
"net/http"
"os"
"os/signal"
"syscall"
"time"
)
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("带超时的服务"))
})
srv := &http.Server{
Addr: ":8080",
Handler: mux,
ReadTimeout: 5 * time.Second,
WriteTimeout: 10 * time.Second,
IdleTimeout: 120 * time.Second,
}
go func() {
if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
panic(err)
}
}()
quit := make(chan os.Signal, 1)
signal.Notify(quit, syscall.SIGINT, syscall.SIGTERM)
<-quit
ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)
defer cancel()
srv.Shutdown(ctx)
}
通过这种结构，我们既保留了net/http的轻量优势，又具备了生产环境所需的容错能力。当业务增长、路由与中间件变得复杂时，再考虑用更完整的框架如Gin或Echo做替换也不迟，因为底层原理一致，迁移成本主要在路由注册与上下文封装上，核心的Handler思想完全可以复用。