beego.run()报undefined错误是v2项目最常见启动失败原因：代码仍用v1写法，但实际安装v2；需将import路径改为"github.com/beego/beego/v2/server/web"并调用web.run()。
beego.Run() 报 undefined 错误
这是 Beego v2 项目启动失败最常见原因：代码里还用着 v1 的入口函数，但实际安装的是 v2。v2 已将 beego.Run() 移除，所有核心能力拆到子包中。
检查 main.go 是否含 import "github.com/astaxie/beego" —— 这是 v1 路径，必须替换成：
import "github.com/beego/beego/v2/server/web"
对应启动方式也要改：
- 旧写法（v1）：
beego.Run() - 新写法（v2）：
web.Run()
如果用了控制器路由（如 web.Router("/", &MainController{})），确保 MainController 嵌入的是 web.Controller，不是已废弃的 beego.Controller。
bee run 提示 missing go.sum entry
错误信息类似：main.go:5:2: missing go.sum entry for module github.com/beego/beego/v2/server/web，本质是 Go 模块依赖未拉取或校验失败。
执行以下三步即可解决：
- 确认项目根目录存在
go.mod（若无，先运行go mod init your-project-name） - 运行
go mod tidy—— 它会自动补全依赖并更新go.sum - 若仍失败，大概率是代理没生效：执行
go env -w GOPROXY=https://goproxy.cn,direct
极少数情况是本地模块缓存损坏，可清空：go clean -modcache，再重试 go mod tidy。
routers 包未导入导致路由 notmatch
启动后访问 / 返回 notmatch，控制台日志反复出现 | GET | / | | notmatch |，不是路由写错了，而是 routers 包根本没被加载。
Beego v2 的路由注册靠 routers/router.go 中的 init() 函数自动调用 web.Router() 完成。而 Go 规定：未被引用的包不会初始化。
解决方法只有一行，在 main.go 的 imports 区加空白导入：
_ "yourapp/routers"
注意替换 yourapp 为你的模块名（即 go.mod 第一行 module 后的值）。漏掉这行，整个路由系统就是空转。
sessionon = true 配置被注释干扰
开启 session 时若在 conf/app.conf 里写成这样：
sessionon = true # 启用session
Beego 会直接忽略该行——.conf 文件不支持行尾注释。哪怕只多一个空格加 #，整行配置就失效。
正确写法只有两种：
- 独立注释行：
# session开关,true表启用session功能，下一行写sessionon = true - 或在 main 函数中硬编码启用：
web.BConfig.WebConfig.Session.SessionOn = true
没开 session 却在控制器里调 this.StartSession() 或读 this.Ctx.Input.Session，就会 panic：nil pointer dereference，报错位置常在 config.go:191。
Beego v2 的模块拆分和配置加载机制比 v1 更严格，很多失败不是代码写错了，而是路径、导入、注释、代理这些“边缘动作”没对齐。尤其注意 go.mod 里的模块名、import 路径、空白导入包名三者必须完全一致，差一个字符都会静默失效。
