beego.ErrorController()必须在beego.Run()前调用且位置唯一：main.go中所有路由注册后、beego.Run()前；ErrController方法名须为Error+状态码或字符串（如Error404）；TplName对应模板文件需存在且合法。
beego.ErrorController() 必须在 beego.Run() 之前调用
很多人把 beego.ErrorController(&controllers.ErrController{}) 放在 beego.Run() 后面，或者放在某个 controller 的方法里——这完全无效。Beego 只在启动初始化阶段读取一次错误控制器注册，之后再调用就等于没注册。
正确位置是 main.go 中 beego.Run() 的正上方，且必须在所有路由注册（beego.Router、beego.Get 等）完成之后、beego.Run() 之前：
beego.Router("/user", &controllers.UserController{})
beego.Router("/admin", &controllers.AdminController{})
beego.ErrorController(&controllers.ErrController{}) // ✅ 这里
beego.Run()
漏掉这一步，后续所有自定义错误逻辑都不会触发，请求 404 时只会返回默认白屏或框架内置提示页。
ErrController 的方法名必须严格匹配 Error + 状态码或自定义字符串
Beego 会根据 this.Abort("404") 或 HTTP 实际状态码，自动查找控制器中对应命名的方法。不按规则命名，方法根本不会执行。
-
Error404()→ 处理 404 请求（包括c.Abort("404")和真实路径未匹配） -
Error500()→ 处理 panic 或内部错误导致的 500 -
ErrorDb()→ 处理手动调用c.Abort("Db")或c.Abort("dbError")的情况（注意大小写敏感）
常见错误：Error404 写成 error404（首字母小写）、Error_404（含下划线）、Handle404（名字不以 Error 开头）——全部无法命中。
模板路径和 TplName 必须存在且可访问
c.TplName = "err_404.html" 不是随便写的字符串。Beego 会按以下顺序查找模板文件：
- 先查
views/err_404.html（默认 views 目录） - 若配置了
BConfig.WebConfig.ViewsPath，则查该路径下的err_404.html - 文件必须是合法 HTML，且不能有语法错误（否则渲染失败，可能静默回退到默认页）
调试技巧：在 Error404() 方法开头加一行 beego.Debug("entering Error404")，然后访问一个不存在路径，看日志是否输出。如果没输出，说明注册或路由匹配失败；如果输出了但页面仍是白屏或默认页，大概率是 TplName 指向的文件路径不对或内容非法。
Abort("404") 和真实 404 是两回事，别混用
c.Abort("404") 是主动抛出错误，走自定义错误流程；而用户访问一个根本没注册的路径（比如 /nonexistent），才是真正的路由层 404 —— 这个也走 Error404()，但前提是你的 ErrorController 已注册且方法名正确。
容易忽略的一点：如果你在某个 controller 的 Get() 方法里写了 c.Abort("404")，但该 controller 对应的路由压根没注册（比如忘了写 beego.Router("/xxx", &XxxController{})），那这个 Abort 根本不会被执行，请求直接被路由层判为 404，进的是全局 Error404()，而不是你预期的那个 controller 里的逻辑。
真正难排查的问题往往卡在这里：你以为是 Abort 触发的错误页，其实是路由没配对导致的“真 404”，两者共用同一个方法，但上下文（c.Data、c.Ctx 状态）完全不同。
