根本原因是routers包未被空白导入导致init()未执行，路由表为空；需在main.go中添加import _ "yourapp/routers"，并确保路径与模块名一致。
beego run 报错 “notmatch” 或 404
这是最常见现象：服务启动成功、端口监听正常，但访问 localhost:8080 显示 notmatch 或空白页。根本原因不是代码写错，而是路由没注册上。
Beego 的路由注册依赖 routers 包的 init() 函数执行，而 Go 编译器只加载被显式导入的包。如果你的 main.go 没有导入 routers，整个路由表就是空的。
- 检查
main.go是否有这行：_ "yourapp/routers"（注意下划线，是空白导入） - 路径必须与实际目录结构一致，比如项目在
myproject/routers/router.go，那导入就是_ "myproject/routers" - 临时验证：在
routers/router.go的init()函数里加一行fmt.Println("[routers loaded]")，启动时没打印就说明没触发
bee run 启动失败或提示 “command not found”
bee 是独立可执行文件，不是 Go 命令插件。安装后若终端无法识别，说明系统找不到它的二进制位置。
Go 工具链默认把 go get 下载的命令放 $GOPATH/bin，这个目录必须加入系统 PATH 才能全局调用。
- 先确认安装路径：
go env GOPATH，然后看$GOPATH/bin/bee（Windows 是bee.exe）是否存在 - Windows：把
C:\Users\XXX\go\bin加到系统环境变量PATH；macOS/Linux：在~/.zshrc或~/.bash_profile中加export PATH=$PATH:$GOPATH/bin - 改完 PATH 后**必须新开终端**，再运行
bee version验证
go get 安装 beego/bee 一直卡住或报错
Go 1.16+ 默认启用模块（GO111MODULE=on），但旧版 Beego v1（github.com/astaxie/beego）和部分 bee 版本不兼容模块模式，会直接失败。
当前（2026 年）推荐统一使用 Beego v2 + bee v2，但安装过程仍可能因代理、权限或缓存出问题。
- 优先设置国内代理：
go env -w GOPROXY=https://goproxy.cn,direct - 如果还失败，临时关闭模块：
go env -w GO111MODULE=off，再运行go get github.com/beego/beego/v2和go get github.com/beego/bee/v2 - 安装完建议切回模块模式：
go env -w GO111MODULE=on，避免后续项目依赖混乱 - 遇到
missing go.sum entry：进项目根目录执行go mod tidy
浏览器打开 localhost:8080 显示空白或连接拒绝
服务进程看似在跑，但实际没真正监听或监听了错误地址。
Beego 默认绑定 127.0.0.1:8080，某些网络策略或防火墙会拦截本地回环地址的响应；另外，v2 默认启用 HTTPS 重定向或自动跳转逻辑也可能干扰。
- 启动时看控制台输出第一行是否含
http server Running on http://127.0.0.1:8080—— 如果是0.0.0.0:8080或其他 IP，需确认该地址能否从本机访问 - 尝试用
curl -v http://127.0.0.1:8080绕过浏览器，排除前端缓存或 CORS 干扰 - 检查
conf/app.conf中的httpport和runmode，开发模式下不要设autorender = false或enablehttps = true而不配证书
最容易被忽略的一点：Beego v2 的包路径和 v1 完全不兼容，混用会导致编译通过但运行时 panic。确认所有 import 都是 github.com/beego/beego/v2/... 开头，且没有残留的 github.com/astaxie/beego。
