go语言通过net/http标准库或gorilla/mux、chi等第三方库支持restful路由;gorilla/mux用{param:Regex}声明路径参数并以mux.Vars提取,chi用chi.URLParam更简洁,纯net/http需手动分割r.URL.Path;均需校验转换参数并防范注入。

Go语言本身没有内置的RESTful路由,但通过标准库net/http配合简单模式匹配,或使用轻量级第三方路由器(如gorilla/mux、chi),就能高效支持带Path参数的动态接口。关键在于正确提取URL路径段并绑定到处理函数。
用gorilla/mux解析Path参数
这是最常用也最直观的方式。它支持类似/users/{id}的声明式路由,并自动将路径段映射为键值对。
- 安装:
go get -u github.com/gorilla/mux - 定义路由:
r.HandleFunc("/users/{id:[0-9]+}", getUserHandler).Methods("GET"),其中{id:[0-9]+}表示只匹配数字ID,提升安全性 - 在handler中获取参数:
id := mux.Vars(r)["id"],返回字符串,需手动转为int等类型
用chi实现嵌套路由与参数解构
chi更轻量、性能更好,且原生支持中间件和子路由,适合中大型API服务。
- 注册路由:
r.Get("/posts/{id}", getPostHandler) - 从
http.Request中提取:id := chi.URLParam(r, "id"),无需额外导入或类型断言 - 支持通配符子路由,比如
r.Route("/api", func(r chi.router) { r.Get("/users/{id}", ...) }),便于分组管理
纯net/http手动解析Path(适合极简场景)
不依赖第三方时,可直接操作r.URL.Path,用strings.Split或正则提取。
立即学习“go语言免费学习笔记(深入)”;
- 示例:访问
/user/123,用parts := strings.Split(r.URL.Path, "/")得到["", "user", "123"] - 注意校验长度和格式,避免越界或注入风险,例如
len(parts) != 3 || parts[1] != "user"应返回404 - 适合固定结构的简单接口,不推荐用于多层级或复杂参数组合
参数校验与错误处理建议
Path参数天然不可选,一旦缺失或格式错误就导致404,因此应在handler内尽早验证。
- ID类参数建议用
strconv.Atoi或strconv.ParseInt转换,并检查err - 对业务上必须存在的参数(如
{category}),可在中间件统一拦截非法值,提前返回400 - 避免在数据库查询前直接拼接Path参数,始终当作不可信输入处理
基本上就这些。选gorilla/mux上手快,选chi更灵活,纯net/http适合教学或嵌入式小服务。核心逻辑一致:声明路径模式 → 提取变量 → 校验转换 → 业务处理。