Go语言通过net/http包可实现RESTful路由控制,利用http.ServeMux和自定义逻辑处理路径匹配与参数解析。1. 使用ServeMux注册GET、POST等方法路由,如/users和/users/123;2. 通过strings.TrimPrefix和strconv.Atoi提取路径参数ID;3. 封装registerUserRoutes函数按资源分组管理路由;4. 利用中间件包装函数实现日志、CORS等通用逻辑。该方式不依赖第三方库,结构清晰,适合小型项目或学习使用,复杂场景推荐Gin或Echo框架。

Go语言的
net/http包虽然没有内置的路由分组或参数解析功能,但通过标准库完全可以实现清晰的RESTful路由控制。关键在于合理组织
http.HandleFunc或
http.Handle,结合
http.ServeMux和自定义逻辑,模拟出类似框架的路由行为。
使用ServeMux基础路由
Go内置的
http.ServeMux可以匹配路径前缀和精确路径,适合简单REST接口。 例如,为用户资源定义基本路由:
GET /users
获取用户列表POST /users
创建新用户GET /users/123
获取ID为123的用户PUT /users/123
更新用户DELETE /users/123
删除用户
代码实现:
package main
import (
"encoding/json"
"net/http"
)
type User struct {
ID int `json:"id"`
Name string `json:"name"`
}
var users = []User{{ID: 1, Name: "Alice"}}
func usersHandler(w http.ResponseWriter, r *http.Request) {
switch r.Method {
case "GET":
json.NewEncoder(w).Encode(users)
case "POST":
var user User
json.NewDecoder(r.Body).Decode(&user)
users = append(users, user)
w.WriteHeader(http.StatusCreated)
default:
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
}
}
func userHandler(w http.ResponseWriter, r *http.Request) {
// 简化:假设路径为 /users/1
if r.Method == "GET" {
json.NewEncoder(w).Encode(users[0])
} else {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
}
}
func main() {
mux := http.NewServeMux()
mux.HandleFunc("GET /users", usersHandler)
mux.HandleFunc("POST /users", usersHandler)
mux.HandleFunc("GET /users/", userHandler) // 注意结尾斜杠匹配子路径
http.ListenAndServe(":8080", mux)
}
处理路径参数
net/http不支持像
/users/{id}这样的动态路由,但可以通过字符串截取或正则提取ID。
立即学习“go语言免费学习笔记(深入)”;
在userHandler中提取ID:
func userHandler(w http.ResponseWriter, r *http.Request) {
path := r.URL.Path
idStr := strings.TrimPrefix(path, "/users/")
id, err := strconv.Atoi(idStr)
if err != nil {
http.Error(w, "Invalid user ID", http.StatusBadRequest)
return
}
// 查找用户等操作
// ...
}
这种方式需要手动处理路径解析,适合轻量场景。
结构化路由组织
当接口变多时,建议按资源分组处理。可以封装一个简单的路由注册函数。
例如,定义一个路由注册器:func registerUserRoutes(mux *http.ServeMux) {
mux.HandleFunc("GET /users", getUsers)
mux.HandleFunc("POST /users", createUser)
mux.HandleFunc("GET /users/", getUser)
mux.HandleFunc("PUT /users/", updateUser)
mux.HandleFunc("DELETE /users/", deleteUser)
}
在
main中调用
registerUserRoutes(mux),便于维护。
中间件与统一处理
通过包装函数添加日志、CORS、认证等逻辑。
func loggingMiddleware(next http.HandlerFunc) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
log.Printf("%s %s", r.Method, r.URL.Path)
next(w, r)
}
}
注册时使用:
mux.HandleFunc("GET /users", loggingMiddleware(getUsers))
基本上就这些。用
net/http实现RESTful路由不依赖第三方库,结构清晰,适合学习或小型项目。复杂场景建议使用Gin或Echo等框架提升开发效率。











