Revel目录结构不可更改,大小写必须严格匹配:app/controllers、app/models、app/views为硬编码扫描路径,控制器类名须以Controller结尾,方法首字母大写,视图路径须完全镜像包结构(如admin/UserController → app/views/admin/User/Index.html),routes为唯一路由入口,Controller仅负责收参、调service、返回结果。

Revel目录结构不能改,大小写必须严格匹配
Revel在启动时硬编码扫描app/controllers、app/models、app/views这三个路径,任何重命名(比如controllers → handlers)或大小写偏差(比如AppController对应视图却放在app/views/app/)都会导致路由 404,且错误日志里只显示“template not found”或空响应,不提示具体哪一级路径错。
- 控制器类名必须以
Controller结尾,方法首字母大写(如Index、CreateUser) - 对应视图路径必须完全镜像控制器包结构:
app/controllers/admin/UserController.go→app/views/admin/User/Index.html -
routes是唯一路由入口,不支持自动反射扫描;所有GET /users这类映射必须显式写进去
Controller里只能调度,业务逻辑必须外移
把SQL查询、密码哈希、第三方API调用塞进AppController.CreateUser方法,是Revel项目后期难以维护的最常见起点。Controller只该做三件事:收参、调service、返回结果。
- 校验逻辑(如手机号格式)不能重复写五次,应抽成
services/validator.go里的独立函数 Service方法必须接收DTO(如 - 事务边界必须由Service控制——比如扣库存+创建订单+发通知,这整套操作应在
services/order.go里用gorp.Transaction包裹,而不是在Controller里手动Begin/Commit
CreateOrderRequest),不依赖*revel.Controller或HTTP上下文模板注释只能用<!-- -->,别碰{{/* */}}
Revel 0.19.0(当前稳定版)明确禁用Go原生模板的{{/* */}}语法,强行使用会报template: unexpected unclosed action。所有注释必须是标准HTML注释,且会原样输出到HTML响应体中。
- 上线前必须
grep -r "<!--.*DEBUG" .清理调试注释,否则可能泄露{{.User.Token}}之类敏感字段 - 条件性隐藏内容请用
{{if false}}{{end}},它彻底不渲染,比注释更安全 - 不要在
{{range}}内部每项都加<!-- 用户卡片开始 -->,只在外层写一次即可
表单验证失败后,Keep()和FlashParams()缺一不可
只调c.Validation.Required("username")但不处理失败结果,非法数据会直接进入业务层;而漏掉c.Validation.Keep(),重定向后.errors就为空,模板里{{.errors.username.Message}}永远不显示。
- 验证链必须紧接在参数接收之后:
username := c.Params.Get("username")→c.Validation.Required(username)→ ... - 判断失败必须用
c.Validation.HasErrors(),不是len(c.Validation.Errors) > 0(后者不触发内部状态更新) -
c.FlashParams()必须在Keep()之后立即调用,顺序颠倒会导致参数丢失
真正容易被忽略的是:Revel没有“编译期注释”或“开发环境过滤”,所有<!-- -->都会进生产包;而routes文件一旦写错路径,连热重载都救不了——改完保存,浏览器F5还是404,得看日志里那句模糊的“no route matched”。


















