Beego v2 是当前唯一可用的主线版本,安装需执行 go get -u github.com/beego/beego/v2 和 go get -u github.com/beego/bee/v2,路径、导入(github.com/beego/beego/v2/server/web)、启动函数(web.Run())必须严格匹配 v2 规范。

Beego v2 是当前唯一能放心用的版本,v1 已彻底停更;安装失败或启动报错,八成出在 GOPATH/GOBIN 没对齐、GOPROXY 未生效,或代码里还混着 v1 的导入路径和函数调用。
beego/v2 和 bee/v2 怎么装才不报错
必须按顺序执行两条命令,且都带 -u:
go get -u github.com/beego/beego/v2go get -u github.com/beego/bee/v2
如果提示 no required module provides package,说明当前目录不是 Go 模块根目录——先运行 go mod init myapp 初始化,再重试。
Mac/Linux 用户注意:bee 二进制默认生成在 $GOPATH/bin,这个路径必须加进 $PATH,否则终端找不到命令。Windows 用户则要检查系统环境变量里的 Path 是否包含 %USERPROFILE%\go\bin。
bee new 后 go run 或 bee run 启动失败的常见原因
新项目创建后立刻 go mod tidy,否则大概率遇到 missing go.sum entry 错误——这是 Go Modules 校验失败,不是 Beego 问题。
若仍失败,优先检查 GOPROXY 是否生效:
- 运行
go env GOPROXY,确认输出含https://goproxy.cn或类似国内代理 - 没生效就执行
go env -w GOPROXY=https://goproxy.cn,direct
极少数情况是本地模块缓存损坏,可清空:go clean -modcache,再 go mod tidy。
main.go 里为什么报 undefined: beego.Run
这是 v1 → v2 迁移最典型的坑:v2 已废弃 beego.Run(),入口函数拆到了子包。
检查你的 main.go:
- 旧写法(v1):
import "github.com/astaxie/beego"+beego.Run() - 新写法(v2):
import "github.com/beego/beego/v2/server/web"+web.Run()
控制器继承也要同步改:type MainController struct { web.Controller },不是 beego.Controller。
验证结构体字段是否被 valid 正确识别
Beego 的 validation.Validation 不会自动触发,也不会读取无 form 标签的字段——哪怕字段名完全匹配表单 key。
实操要点:
- 结构体字段必须首字母大写(导出),否则反射不可见
- 每个待校验字段必须带
form标签,例如Name string `form:"name" valid:"Required"` - JSON 请求不能依赖
this.ParseForm()(它只处理表单编码),得手动json.Unmarshal后再调valid.Valid() -
Match规则要用 Go 原生正则语法,^1[3-9]\d{9}$才对,^1[3-9]d{9}$会失效
嵌套结构体不被 valid 递归校验,这点容易被忽略——要么手动展开,要么换 go-playground/validator。


















