是，Revel模板路径严格匹配控制器命名空间，如admin.UserController的UserList方法必须对应app/views/admin/User/UserList.html，缺一级目录或大小写错误均导致“template not found”。
模板路径是否严格匹配控制器命名空间
Revel 对模板路径的解析是机械式的，不依赖约定或自动推导，而是直接拼接控制器全限定名。比如 admin.UserController 的 UserList 方法，必须对应 app/views/admin/User/UserList.html ——中间的 admin 和 User 目录缺一不可。
常见错误包括：
- 把
api/v2/PostController的视图放在app/views/api/Post/（漏掉v2） - 误以为
AppController可以省略App目录，实际必须是app/views/App/Index.html - 大小写不一致：Go 中
UserController和文件系统中user/userlist.html会被视为不同路径（尤其在 Linux/macOS）
错误日志里只显示“template not found”怎么办
这个提示本身不包含缺失路径的任何线索，它只是框架最终 fallback 的结果。真正有用的信息藏在启动日志和路由匹配过程里。
你应该做的是：
- 执行
revel routes -a yourapp，确认该 action 是否出现在输出中；如果没出现，说明config/routes没注册，或 import 路由时出错 - 在
conf/app.conf中临时添加revel.router.debug = true，重启后访问对应 URL，观察终端是否打印[router] Matched GET /xxx → App.Index—— 如果连这行都没有，说明请求根本没进到路由匹配阶段（可能是 404 前置拦截、HTTPS 重定向、反向代理截断等） - 检查
app/controllers下的 controller 文件是否被正确go build进入编译流程（比如文件名以_test.go结尾，或被// +build ignore注释掉）
模板文件存在但依然报 not found
文件物理存在 ≠ Revel 能加载它。Revel 在启动时会扫描 app/views/ 并预编译所有 .html 文件，若扫描失败或跳过，后续请求就会 fallback 到 “not found”。
典型原因有：
- 文件权限问题：Linux/macOS 下，若
app/views/xxx/yyy.html所有者不是当前运行 revel 的用户，且无读权限，Revel 会静默跳过该文件（不报错，也不加载） - 文件编码或 BOM：Windows 编辑器保存的 UTF-8 with BOM 格式会让 Revel 解析失败，表现为文件“不存在”。用
file -i app/views/xxx.html检查编码，用sed -i '1s/^\xEF\xBB\xBF//' app/views/xxx.html去 BOM - 文件扩展名不是
.html：Revel 只认.html，.htm、.tpl、.gotmpl全部忽略 - 文件被 IDE 或编辑器临时锁定（如 Vim 的
.swp、VS Code 的.~lock.xxx.html#），Revel 扫描时可能因 inode 冲突跳过整个目录
如何快速验证模板加载链路是否通畅
绕过业务逻辑，直击模板加载环节。在任意已知能工作的 controller action 里，临时加一行：
func (c App) DebugTemplate() revel.Result {
return c.RenderTemplate("errors/404.html")
}
然后访问 /app/debugtemplate。如果成功渲染出 404 页面，说明模板加载机制正常；如果报 template not found，那问题就出在 app/views/errors/404.html 路径或文件本身 —— 这是最干净的隔离测试法。
注意：RenderTemplate 不走路由匹配，只做纯路径查找+编译，所以它能帮你排除掉 controller 名称、方法名、routes 配置等干扰项。一旦这个调用失败，就只用盯死文件路径、权限、编码这三个点。
