Go / 系统课时
启动 HTTP 服务并注册路由
启动 HTTP 服务并注册路由
这一课把一个最小 Go HTTP 服务真正跑起来:用 http.Server 承载服务,用 http.ServeMux 注册方法与通配符路由,并验证正常匹配、404 未匹配和 405 方法不允许三种结果。示例适用于 Go 1.22 及以上。
学习目标
- 使用
http.Server与独立http.ServeMux启动服务。 - 用
GET /users/{id}这类 Go 1.22+ 路由模式读取路径参数。 - 区分成功匹配、404 与 405,并知道
HEAD对GET模式的匹配规则。
用独立 ServeMux 组织路由
http.NewServeMux() 比直接依赖包级默认路由更适合真实项目,因为依赖关系明确,也方便测试。Go 1.22 起,模式可以同时包含 HTTP 方法和通配符,例如 GET /users/{id};处理函数通过 r.PathValue("id") 读取路径值。
下面程序注册一个带路径参数的查询接口和一个创建接口,并给 http.Server 设置 5 秒 ReadHeaderTimeout,避免客户端长期占着连接却迟迟不发完请求头。
package main
import (
"fmt"
"log"
"net/http"
"time"
)
func main() {
mux := http.NewServeMux()
mux.HandleFunc("GET /users/{id}", func(w http.ResponseWriter, r *http.Request) {
id := r.PathValue("id")
w.Header().Set("Content-Type", "text/plain; charset=utf-8")
fmt.Fprintf(w, "user=%s\n", id)
})
mux.HandleFunc("POST /users", func(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "text/plain; charset=utf-8")
w.WriteHeader(http.StatusCreated)
fmt.Fprintln(w, "created")
})
server := &http.Server{
Addr: ":8080",
Handler: mux,
ReadHeaderTimeout: 5 * time.Second,
}
log.Println("listening on http://127.0.0.1:8080")
log.Fatal(server.ListenAndServe())
}预期输出(启动后,时间前缀会随环境变化):
<TIME> listening on http://127.0.0.1:8080看懂路由匹配结果
同一个 ServeMux 会先按主机、方法和路径模式寻找最佳匹配。路径完全没有匹配时返回 404;路径能匹配、但请求方法不被已注册模式接受时返回 405,并由 ServeMux 生成 Allow 响应头。GET 模式还会匹配 HEAD 请求。

用下面三次请求验证差异:
curl -i http://127.0.0.1:8080/users/42
curl -i -X DELETE http://127.0.0.1:8080/users/42
curl -i http://127.0.0.1:8080/projects/42预期输出中的关键部分:
HTTP/1.1 200 OK
...
user=42
HTTP/1.1 405 Method Not Allowed
Allow: GET, HEAD
...
HTTP/1.1 404 Not Found
...
404 page not found这里的日期、Content-Length 等响应头可能因 Go 版本和运行时间不同而变化,但状态码与主体含义应一致。
处理路由边界
通配符 {id} 只匹配单个路径段,因此 /users/42 会命中,而 /users/42/profile 不会命中当前模式。若要匹配路径尾部剩余内容,可使用 Go 1.22+ 的 {name...} 多段通配符;它只能出现在模式末尾。
还要注意模式冲突。若同时注册 GET /users/{id} 与 GET /users/me,后者更具体,访问 /users/me 时会选择固定路径模式,而不是把 me 当成 id。如果两个模式在语义上冲突且不存在更具体关系,ServeMux 会在注册时触发 panic,应在启动阶段尽早暴露这类错误。
让服务具备可测试的边界
将 mux 作为 http.Server.Handler 注入,而不是把业务都写进 main,后续就能把同一个 handler 交给 httptest.NewServer 或 httptest.NewRecorder。真实服务还应继续补充 ReadTimeout、WriteTimeout、IdleTimeout 和优雅关闭,但路由注册与匹配行为应先像本例一样做到可独立验证。
完成后,至少检查四件事:GET /users/42 返回 200 且正文含 user=42,POST /users 返回 201,错误方法返回 405,未知路径返回 404。只有这四种边界都符合预期,路由层才算真正跑通。