beego.run() 报 undefined 错误是因版本错配：v2 已移除该函数，需改用 import "github.com/beego/beego/v2/server/web" 并调用 web.run()，同时确保 routers 包通过 _ "yourapp/routers" 空白导入以触发路由注册。
beego.Run() 报 undefined 错误
这是最常遇到的启动失败，根本原因是版本错配：代码里还用着 v1 的写法，但实际装的是 v2。v2 已将 beego.Run() 拆到子包，主包不再导出该函数。
检查 main.go 中的 import 路径：
- ❌ 错误路径：
import "github.com/astaxie/beego"（v1） - ✅ 正确路径：
import "github.com/beego/beego/v2/server/web"，然后调用web.Run()
若沿用旧项目迁移，还需同步替换所有子包引用，比如日志要用 github.com/beego/beego/v2/core/logs，而非旧路径。
go mod tidy 失败或 missing go.sum entry
执行 bee run 时提示 missing go.sum entry for module providing package github.com/beego/beego/v2/server/web，说明依赖未真正拉取成功。
常见原因和操作建议：
-
GO111MODULE状态不匹配：确认当前是on（推荐），执行go env -w GO111MODULE=on - GOPROXY 未生效：运行
go env -w GOPROXY=https://goproxy.cn,direct，再试go mod tidy - 本地缓存损坏：执行
go clean -modcache清空后重试 - 项目根目录无
go.mod：先go mod init yourappname，再go mod tidy
routers 包未加载导致 notmatch
服务能启动、HTTP 也通，但所有路由都返回 notmatch，浏览器看到 | GET | / | | notmatch | —— 这不是代码写错了，而是路由根本没注册。
Beego 的路由注册靠 routers 包的 init() 函数自动执行，而 Go 规定：未被导入的包，其 init() 不会运行。
解决方法只有一行，在 main.go 的 imports 区添加：
_<code>"yourapp/routers"</code>
注意是空白导入（下划线开头），且路径必须与你项目结构一致；改完立刻生效，无需重启 bee 工具。
RabbitMQ 初始化阻塞或 panic
在 main() 或 init() 里直接调用 amqp.Dial()，一旦网络不通或 DNS 未就绪，beego.Run()（或 web.Run()）前就 panic，服务完全起不来。
正确做法是解耦初始化时机：
- 不要裸调
amqp.Dial()，包装成带超时、重试、错误日志的函数 - 用
sync.Once+time.AfterFunc延迟初始化，避免阻塞启动流程 - 连接失败时，记录
warn日志并设状态为"unavailable"，让 HTTP 服务照常启动 - Consumer 必须作为独立 goroutine 在
beego.AppInit()阶段启动，绝不可塞进 Controller 方法里
Beego 启动失败的复杂点往往不在框架本身，而在把消息队列、数据库等外部依赖的生命周期，错误地绑定到 Web 启动流程中。越早意识到“Beego 只管 HTTP，其他自己兜底”，踩坑就越少。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
