Go chi框架中Handler移出main包后chi.URLParam返回空值的问题解决
chi框架跨包Handler读取路由参数为空的问题排查
问题场景
用chi框架搭小型REST API的时候,按常规拆分代码:把路由实例化、中间件注册、服务启动的核心逻辑放在main.go,把用户相关的业务Handler拆到独立的users包。
最初所有Handler都堆在main.go里的时候,用chi.URLParam读路由参数功能完全正常;等把Handler挪到独立包,同样的代码逻辑就出问题——路由参数怎么读都是空的。
复现代码
main.go 侧路由定义(使用v5版本chi):
package main import ( "log" "net/http" "github.com/MyUserName/MyProjectName/internals/users" "github.com/go-chi/chi/v5" ) func main() { router := chi.NewRouter() // 挂载跨包的用户查询Handler router.Get("/users/{user_id}", users.GetUser) log.Printf("服务启动在 :8080 端口") log.Fatal(http.ListenAndServe(":8080", router)) }
跨包的users包内Handler代码(使用旧版chi导入):
package users import ( "encoding/json" "log" "net/http" "strconv" "github.com/MyUserName/MyProjectName/internals/models" "github.com/go-chi/chi" // 导入的是旧版chi路径 ) var DataBase = make([]models.User, 0) func GetUser(w http.ResponseWriter, r *http.Request) { // 这一步始终拿到空字符串 uID := chi.URLParam(r, "user_id") id, err := strconv.Atoi(uID) if err != nil { log.Printf("参数解析报错:%v", err) } user := DataBase[id-1] response, _ := json.Marshal(user) w.Write(response) }
问题根本原因
- Go模块体系下,完整导入路径不同的包是完全独立的模块,不存在内部状态共享
- main.go中使用的是
github.com/go-chi/chi/v5版本的chi,路由匹配完成后,框架会把解析到的路由参数写入v5版本专属的请求上下文键值空间 users包中调用chi.URLParam时,引用的是旧版github.com/go-chi/chi包的方法,该方法只会去旧版专属的上下文键值空间查找路由参数,自然永远返回空值- 和Handler是否写在main文件内没有任何关系,纯粹是跨包导入时chi版本不统一导致的上下文读取错位
解决方案
全局统一项目内所有chi包的导入路径,不要混用v5和旧版的导入路径:
- 把
users包内的chi导入路径从github.com/go-chi/chi修改为和main.go一致的github.com/go-chi/chi/v5 - 不需要调整任何业务逻辑、路由挂载配置,修改导入路径后重新编译,跨包Handler就能正常读取到路由参数
内容的提问来源于stack exchange,提问作者BlackCat
相关产品推荐
相关产品推荐

