Revel框架404页面不生效,因未注册App.NotFound控制器动作及对应模板;需在init.go注册拦截器、app.go定义NotFound方法,并严格按app/views/App/NotFound.html路径放置模板。

Revel 框架里 404 页面为什么总不生效
Revel 不像 Laravel 或 Django 那样自动查找 404.html,它靠路由匹配失败后触发的 App.NotFound 控制器动作。如果你没显式注册这个动作,请求会直接返回空响应或默认文本(比如 “404 page not found”),根本不会渲染你写的模板。
必须在 app/init.go 的 init() 函数里注册:
revel.InterceptFunc(app.NotFound, revel.BEFORE)
同时确保 app/controllers/app.go 中定义了 NotFound 方法:
func (c App) NotFound() revel.Result {
return c.Render()
}
然后创建模板 app/views/App/NotFound.html——路径和控制器名、方法名严格绑定,错一个字母都不行。
- 模板路径必须是
app/views/{Controller}/{Action}.html,不能放在views/errors/下 - 不要依赖
revel.Config.StringDefault("app.notfound", ...),这个配置项只影响日志和 fallback 行为,不接管视图渲染 - 如果用了子模块(如
admin),需单独为该模块注册Admin.NotFound,否则子路由 404 仍走全局
500 错误页被 panic 堆栈覆盖怎么办
Revel 默认启用 revel.PanicFilter,一旦发生 panic,它会直接写入堆栈到响应体,并跳过所有控制器逻辑(包括 App.Error)。所以即使你写了 App.Error() 方法,也根本不会执行。
解决方式是禁用默认 panic 处理,改用自定义 filter:
// 在 app/init.go 中移除或注释掉 revel.PanicFilter // revel.InterceptFunc(revel.PanicFilter, revel.BEFORE) // 然后添加自己的 recover filter revel.InterceptFunc(app.RecoverFilter, revel.BEFORE)
并在 app/controllers/app.go 中实现:
func (c App) RecoverFilter(c *revel.Controller, fc []revel.Filter) revel.Result {
defer func() {
if err := recover(); err != nil {
c.Response.Status = 500
return c.Render()
}
}()
return nil
}
再建模板 app/views/App/Error.html。注意:这个模板不能调用任何可能 panic 的 helper(比如未初始化的 DB 查询),否则会二次 panic 导致空白响应。
- 500 模板里避免使用
{{.Flash}}或{{.Session}},它们在 panic 后状态可能已损坏 - 不要在
Error.html中引用外部 CSS/JS,用内联样式更稳妥 - 上线前务必设
revel.DevMode = false,否则revel.PanicFilter仍可能被自动启用
模板里怎么安全显示错误信息又不泄露敏感数据
Revel 的 App.Error 方法接收的 c.Params.Route 和 c.Params.Flash 在 panic 场景下不可靠,真正能稳定拿到的是 c.Response.Status 和 c.Request.URL.Path。
推荐在 Error.html 里只做三件事:
- 用
{{if eq .Status 500}}服务器出错了{{else}}页面找不到了{{end}}区分状态 - 显示
{{.Request.URL.Path}}帮用户确认访问路径(但别渲染.Error或.StackTrace) - 加一个上报按钮,用 fetch 发送
{path: "{{.Request.URL.Path}}", status: {{.Status}}}到监控接口
切记:Revel 没有类似 Laravel 的 $exception->getMessage() 可用。你想看到详细错误,只能在 recover filter 里手动记录日志,而不是塞进模板变量传出去。
静态资源 404 被 Web 服务器拦截,Revel 根本收不到
这是最常被忽略的一环:Nginx/Apache 会先检查 /css/app.css 这类路径是否存在物理文件,存在就直接返回;不存在就返回 404,且根本不会把请求交给 Revel。所以你在 App.NotFound 里写的逻辑对这类请求完全无效。
解决方案分两层:
- Nginx 配置里用
try_files $uri @revel,把所有非真实文件的请求都转给 Revel(@revel是 proxy_pass 到 Revel 的 location) - 在 Revel 的
app.conf里设置static.dir = "public",并确保public/css/下真有文件——否则连静态资源都 404 - 如果不想让静态资源走 Revel,就单独配 Nginx 的
ErrorDocument 404 /404.html,但这个页面和 Revel 的NotFound.html是两个独立系统,得分别维护
复杂点在于:你得明确区分「路由 404」和「静态资源 404」,前者由 Revel 渲染,后者由 Web 服务器兜底。混在一起调试时,很容易以为是代码问题,其实是 Nginx 规则漏了 @revel 分支。











