Beego.ErrorHandler注册后不生效主因是调用时机错误或作用域问题：必须在路由注册前、beego.Run()前完成；仅对this.Abort("code")主动触发有效，且Abort参数须与ErrorHandler注册key严格一致。
Beego.ErrorHandler 注册后不生效的常见原因
注册自定义错误处理器后仍返回默认 400/404/500 页面，大概率不是代码写错，而是调用时机或作用域问题。Beego 的 ErrorHandler 必须在路由注册前、beego.Run() 前完成注册，且仅对通过 this.Abort("code") 主动触发的错误生效。
以下情况会导致注册失效：
-
beego.ErrorHandler("404", handler)放在beego.Router()之后 —— 路由已初始化，错误处理器未被加载 - 使用了
beego.ErrorController(&controllers.ErrController{})但控制器中方法名不是Error404、Error500等严格命名格式 - 在测试环境中未导入路由包（如
import _ "your-project/routers"），导致整个路由系统未启动，所有请求都落入默认 404 处理器，而非你注册的自定义 handler
Abort 字符串参数必须与 ErrorHandler 注册的 key 完全一致
this.Abort() 的参数是纯字符串匹配，大小写、下划线、空格都敏感。它不解析 HTTP 状态码数字，只查表匹配你注册时传入的 key。
例如：
-
beego.ErrorHandler("dbError", dbHandler)→ 必须用this.Abort("dbError")，不能写成this.Abort("dberror")或this.Abort("500") -
beego.ErrorHandler("404", notFoundHandler)→ 只响应this.Abort("404")，不会捕获 URL 未匹配导致的隐式 404 - 若想统一接管所有未匹配路由，应配合
beego.ErrorController+Error404方法，而非依赖Abort("404")
多端适配响应：JSON API 与 HTML 页面共存的处理逻辑
同一个错误码（如 401）在 Web 页面和移动端 API 中需要不同响应格式：前者渲染 HTML 模板，后者返回 JSON。Beego 不自动区分请求来源，需手动判断 this.Ctx.Input.IsAjax() 或检查 Accept 头。
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
推荐做法是在自定义错误处理器中做内容协商：
- 检查
r.Header.Get("Accept")是否包含application/json - 或用
this.Ctx.Input.IsAjax()快速识别前端 AJAX 请求（它基于X-Requested-With: XMLHttpRequest） - 避免在
Abort后继续执行后续逻辑 ——Abort会终止当前方法，但不会阻止中间件或 Prepare 阶段代码，务必确保权限校验类逻辑放在Prepare()中并配合Abort()
示例片段（在自定义 handler 中）：
func apiError(rw http.ResponseWriter, r *http.Request) {
if strings.Contains(r.Header.Get("Accept"), "application/json") {
rw.Header().Set("Content-Type", "application/json; charset=utf-8")
rw.WriteHeader(http.StatusUnauthorized)
json.NewEncoder(rw).Encode(map[string]string{"error": "unauthorized"})
return
}
// 否则渲染 HTML 模板
t, _ := template.New("401.html").ParseFiles(beego.BConfig.WebConfig.ViewsPath + "/401.html")
t.Execute(rw, nil)
}
beego.ErrorController 与模板上下文传递的坑
使用 beego.ErrorController(&controllers.ErrController{}) 时，ErrController 的 Error404 等方法内无法直接访问原始请求的 this.Data 或 this.TplName，因为错误控制器是全新实例，不继承原 Controller 上下文。
若需透传原始请求信息（如用户 ID、trace ID），只能通过以下方式之一：
- 在
Prepare()中将关键字段写入this.Ctx.Input.Data，然后在Error404()中用c.Ctx.Input.GetData("key")读取 - 将必要信息编码进 URL query（如重定向到
/error/404?from=/api/user），再在Error404()中解析 - 避免强依赖原始上下文，改用日志或监控系统关联请求链路（更健壮）
另外注意：ErrorController 的模板路径默认走 ViewsPath，但不会自动加载 layout 模板，{{template "layout" .}} 需显式声明且 layout 文件必须存在。
