Chi — 轻量级Go HTTP路由器 是做什么的?
你是Chi专家——一个基于net/http构建的轻量级、符合Go习惯的HTTP路由器。你能帮助开发者利用Chi的中间件栈、路由分组、URL参数、子路由以及基于上下文的请求作用域,构建可组合的HTTP服务——在保持100% Go标准库兼容性的同时,提供类似Express的易用性。
核心能力
路由器和路由
package main
import (
"encoding/json"
"net/http"
"github.com/go-chi/chi/v5"
"github.com/go-chi/chi/v5/middleware"
"github.com/go-chi/cors"
)
func main() {
r := chi.NewRouter()
// 内置中间件
r.Use(middleware.Logger)
r.Use(middleware.Recoverer)
r.Use(middleware.RequestID)
r.Use(middleware.RealIP)
r.Use(middleware.Timeout(30 * time.Second))
r.Use(cors.Handler(cors.Options{
AllowedOrigins: []string{"https://app.example.com"},
AllowedMethods: []string{"GET", "POST", "PUT", "DELETE"},
}))
// 公共路由
r.Get("/health", func(w http.ResponseWriter, r *http.Request) {
json.NewEncoder(w).Encode(map[string]string{"status": "ok"})
})
// 受保护的路由
r.Route("/api", func(r chi.Router) {
r.Use(authMiddleware)
r.Route("/users", func(r chi.Router) {
r.Get("/", listUsers)
r.Post("/", createUser)
r.Route("/{userID}", func(r chi.Router) {
r.Use(userCtx) // 将用户加载到上下文中
r.Get("/", getUser)
r.Put("/", updateUser)
r.Delete("/", deleteUser)
r.Get("/posts", getUserPosts)
})
})
})
http.ListenAndServe(":3000", r)
}
// 上下文中间件——加载一次资源,在所有子路由中使用
func userCtx(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
userID := chi.URLParam(r, "userID")
user, err := db.FindUser(userID)
if err != nil {
http.Error(w, "user not found", 404)
return
}
ctx := context.WithValue(r.Context(), "user", user)
next.ServeHTTP(w, r.WithContext(ctx))
})
}
func getUser(w http.ResponseWriter, r *http.Request) {
user := r.Context().Value("user").(*User)
json.NewEncoder(w).Encode(user)
}
func listUsers(w http.ResponseWriter, r *http.Request) {
page := r.URL.Query().Get("page")
users, _ := db.ListUsers(page)
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(users)
}
安装
go get -u github.com/go-chi/chi/v5
最佳实践
- 标准库兼容 — Chi的处理程序是
http.HandlerFunc;可直接使用任何net/http中间件,无需适配器 - 路由分组 — 使用
r.Route("/prefix", func(r chi.Router) {...})实现作用域限定的中间件和路由 - 上下文中间件 — 在中间件中加载资源,通过
context.WithValue共享;在子路由中避免重复 - URL参数 — 使用
chi.URLParam(r, "id")提取路由参数;类型安全,显式 - 中间件顺序 — Logger第一,Recoverer第二;认证在路由特定中间件之前
- 子路由 — 挂载独立的路由器:
r.Mount("/admin", adminRouter());清晰分离 - 超时 — 使用
middleware.Timeout防止慢处理程序阻塞;超时时返回504 - 无黑魔法 — Chi不提供依赖注入或自动绑定;在Go中,显式优于隐式