Beego路由不生效主因是路由未显式注册或路径不匹配，须在routers/router.go的init()中用beego.Router("/", &controllers.MainController{})注册，并确保main.go调用beego.Run()。
Beego 路由注册不生效，访问 404 怎么办
根本原因几乎总是路由没被正确加载或路径不匹配。Beego 不会自动扫描控制器，所有路由必须显式写在 routers/router.go 的 init() 函数里。
常见错误现象：
- 执行
bee run启动后，访问/返回 404 -
MainController.Get()完全没被调用 - 浏览器控制台或终端无任何日志输出
实操建议：
- 确认项目结构在
$GOPATH/src/your_project_name/下，否则import "your_project_name/controllers"会失败 -
routers/router.go中的注册语句必须是beego.Router("/", &controllers.MainController{})—— 注意是取地址符&，不是controllers.MainController{} - 如果只是返回字符串，优先用
beego.Get("/", func(ctx *context.Context) { ctx.WriteString("OK") })，绕过控制器初始化问题 - 检查
main.go是否调用了beego.Run()；漏掉这句，整个 MVC 流程不会启动
Controller 里怎么安全读取 GET/POST 参数
Beego 自动解析请求参数，但类型转换和空值处理容易出错，尤其在未校验就直接调用 GetInt() 或 GetBool() 时会 panic。
立即学习“go语言免费学习笔记（深入）”；
使用场景：
- 表单提交、URL 查询参数、JSON 请求体（需先调
ctx.Input.RequestBody） - 前端传空字符串、"false"、"0" 等非标准布尔值时，
GetBool()可能返回意外结果
实操建议：
- 始终用带 error 的方法，例如
id, err := c.GetInt("id")，别直接用c.GetString("id")后强转 - 对必填参数，用
if id == 0 && err != nil判断是否缺失或格式错误，而非只看err - 读取 JSON body 前必须先调
c.Input.RequestBody，否则后续c.GetString()可能为空或重复读取失败 - 避免在
Prepare()里读 body，除非你确定所有子方法都需要；更推荐在具体Post()或Put()方法开头统一读
全局过滤器里 abort 后为什么 controller 还执行了
因为没调 ctx.Abort()，或者调了但没 return，导致流程继续向下走。Beego 的 filter 是链式执行，Abort() 只终止当前 filter 链，不自动阻止后续逻辑。
关键点：
-
ctx.Abort(401, "Unauthorized")必须紧跟return，否则ctx.Next()或 controller 方法仍会被调用 -
"/*"匹配所有路径，但默认**不匹配静态文件**（如/static/js/app.js），除非你在配置里启用了StaticDir显式覆盖 - 若只需保护部分路径（如
/admin/*），别用全局 filter，改用beego.Router("/admin/", &AdminController{}, "get:Get;post:Post")+ 在AdminController.Prepare()里做鉴权 - 需要读 request body 的 filter，务必在
ctx.Abort()前调ctx.Input.RequestBody，否则 controller 侧再读就是空字节
模板渲染不出来，TplName 设了却显示空白页
Beego 模板渲染有三个硬性条件同时满足才生效：路径存在、字段名匹配、beego.Run() 已启动。缺一不可，且大小写敏感。
容易踩的坑：
-
c.TplName = "index.tpl"要求文件真实路径是views/index.tpl，不能是Views/index.tpl或views/Index.tpl - 传数据用
c.Data["Title"] = "Home"，模板里必须写{{.Title}}，不是{{.Data.Title}}或{{.data.title}} - 如果用了子目录，比如
views/admin/dashboard.tpl，TplName必须写成"admin/dashboard.tpl"，不能省略前缀 - 没调
beego.Run()时，即使TplName正确，也会静默忽略，页面返回空响应
调试技巧：先用 c.Ctx.WriteString("test") 替换模板逻辑，确认 controller 确实运行了；再逐步加回 TplName 和 Data 字段。
