Revel 升级后需严格匹配版本与 Go Modules 兼容性，确保 GO111MODULE=on、go.mod 与 app.importPath 一致，资源路径须用 revel.AppPath 构建，模板 range 需显式声明双变量，生产部署必须设为 PROD 模式并绑定 127.0.0.1。
revel run 启动失败、模板渲染报错、路由不生效——这些不是代码写错了，而是 Revel 框架升级后路径解析、模块加载和模板作用域规则变了。直接替换二进制或升级 CLI 版本，大概率会触发运行时 panic 或静默失效。
确认 Revel 版本与 Go Modules 兼容性
Revel v0.25+ 才真正支持 Go Modules；v1.x 是当前稳定主线，但 v0.1x 仍广泛存在于老项目中。若revel version 输出低于 v0.25，不要强行升级 CLI，先检查项目是否已启用 Modules：
• 运行 go env GO111MODULE，结果必须是 on 或空（默认值），不能是 off
• 项目根目录下必须存在 go.mod 文件，且其中 module 声明的路径与 conf/app.conf 中的 app.importPath 严格一致（大小写、斜杠方向均敏感）
• 若仍报 not found in GOPATH，说明 Revel 仍在 fallback 到旧路径逻辑——此时应删除 conf/app.conf 中所有 revel. 开头的过时配置项（如 revel.build.path），改用环境变量控制
revel.AppPath 替代 runtime.Caller 定位资源目录
升级后runtime.Caller(1) 在测试或 IDE 启动时返回 asm 文件，os.Getwd() 在容器或 systemd 下不可靠——这不是 bug，是 Revel 运行机制决定的。
• 所有资源路径（如 SQLite 数据库路径、静态文件根目录）必须基于 revel.AppPath 构建，它是 Revel 初始化时唯一可靠识别的项目根目录
• 示例：在 app/models/init.go 中初始化 DB 时，写成 filepath.Join(revel.AppPath, "data", "app.db")，而非 filepath.Dir(runtime.Caller(1).File)
• 不要试图“推导” model.go 所在目录——Go 程序运行时不携带源码位置信息，这个思路从底层就不可行
模板中 range 传参必须显式声明双变量
升级到 Revel v1.x 后，html/template 引擎行为更严格，单变量 {{range .Items}} 无法在子模板中访问索引。
• 需改为 {{range $index, $item := .Items}}，然后用 {{template "item.html" $index}} 或 {{template "item.html" $item}}
• 变量名前必须加 $，否则在嵌套 {{with}} 或 {{if}} 块中会被覆盖为 nil
• 若子模板依赖索引生成 ID（如 id="item-{{$index}}"），漏掉 $index 会导致 HTML ID 为空或重复
生产部署必须禁用开发模式并绑定回环地址
新版本 Revel 默认开启热重载和详细错误页，若未显式关闭，上线后会暴露源码路径、数据库配置甚至堆栈。• 启动命令必须带 REVEL_RUNMODE=prod revel run -a myapp -p 8089 -addr 127.0.0.1
• Nginx 反向代理配置中，proxy_pass 必须指向 http://127.0.0.1:8089，绝不能是 0.0.0.0:8089 或公网 IP
• 检查 conf/app.conf 中 app.mode 是否设为 PROD，且 revel.intercepterrors 设为 true，否则 panic 会直接透出到客户端
revel.BinPath、revel.SamplePath 或硬编码相对路径的地方，都得重审。别信“结构没变就能跑”，要信 revel.AppPath 和日志里每一条 “failed to load template” 的真实路径。 
