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,避免客户端长期占着连接却迟迟不发完请求头。

go
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())
}

预期输出(启动后,时间前缀会随环境变化):

text
<TIME> listening on http://127.0.0.1:8080

看懂路由匹配结果

同一个 ServeMux 会先按主机、方法和路径模式寻找最佳匹配。路径完全没有匹配时返回 404;路径能匹配、但请求方法不被已注册模式接受时返回 405,并由 ServeMux 生成 Allow 响应头。GET 模式还会匹配 HEAD 请求。

ServeMux 按方法与路径选择处理函数并区分 404 与 405

用下面三次请求验证差异:

bash
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

预期输出中的关键部分:

text
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。只有这四种边界都符合预期,路由层才算真正跑通。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

启动 HTTP 服务并注册路由

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通