Revel新手卡在“写了代码却收不到请求”上,90%是因为路由没配对、控制器位置或包名错了——不是框架难,是它把约定硬编码进反射逻辑里,错一点就静默失败。

conf/routes 和 app/controllers 必须严格配对
Revel不报错,但请求直接 404 或参数为空。关键点全在空格、大小写和路径上:
-
GET /login App.Login✅ 正确:HTTP 方法、路径、控制器方法之间用单个空格分隔,App和Login首字母大写 -
get /login app.login❌ 失效:方法名小写,Revel 反射时找不到 -
GET /login App.Login()❌ 失效:routes文件不支持函数调用语法 - 第一行必须是注释,如
# This file defines all application routes,否则旧版本 Revel 会跳过整个文件
控制器文件位置和包名不能改
Revel只扫描固定路径,且包名必须是 app,否则方法根本不会被识别:
- ✅ 正确路径:
app/controllers/user.go,文件开头为package app - ❌ 错误路径:
controllers/user.go(缺app/前缀)、app/handlers/user.go(目录名不对) - ❌ 错误包名:
package controllers或package main→App.Login永远调用不到 - 结构体方法必须首字母大写,签名第一个参数是
*App或对应控制器指针,返回revel.Result,例如:func (c App) Index() revel.Result
模板路径和命名必须完全匹配控制器方法
页面空白?大概率是模板没被找到。Revel 对路径和文件名有强约束,不是“放哪都能渲染”:
-
app/controllers/hello.go中的Index()方法 → 模板必须是app/views/Hello/Index.html - 控制器名
Hello(首字母大写),对应目录名Hello;方法名Index→ 模板文件名必须是Index.html,小写index.html被忽略 - 模板路径固定为
app/views/{ControllerName}/{MethodName}.html,不能加前缀或改扩展名 - 调试时看
revel.INFO日志,出现Template not found: Hello/Index.html就说明路径或大小写错了
静态资源必须放 public/ 目录下
CSS、JS、图片等浏览器可访问的文件,只能从 public/ 目录提供服务:
- ✅ 正确存放:
public/css/app.css、public/js/main.js、public/images/logo.png - ❌ 错误存放:
app/views/css/、conf/static/、views/assets/→ 请求全部 404 - 模板中引用必须用绝对路径:
,开头的/表示相对于public/根目录 - SCSS 等预处理文件需用 Grunt 或其他工具编译后输出到
public/css/,Revel 本身不处理源码
最容易被忽略的是:Revel 的路由匹配、模板查找、静态资源服务三者都依赖硬编码的字符串路径拼接,没有 fallback,也没有 warning。一旦 conf/routes 里多一个空格、app/controllers 下包名写成 main、模板文件名用了小写,它就彻底“看不见”你写的代码——连日志都不会提示你哪里错了。











