Revel框架中静态资源必须置于app/public/目录并通过GET /public/*filepath路由显式映射，否则即使文件存在也会404；引用须用绝对路径如"/js/main.js"，且需配置resourceVersion拦截器注入版本号以避免缓存问题。
静态资源必须放在 public/ 目录下才能被访问
Revel 不会从 app/、views/ 或 conf/ 目录提供任何静态文件——哪怕你把 style.css 放进 app/views/css/，浏览器请求 /css/style.css 也会直接返回 404。唯一有效的根路径是 public/，且必须通过绝对路径引用。
常见错误现象：
- 模板里写
<link href="css/app.css">（相对路径）→ 浏览器按当前 URL 拼接，大概率 404 - 把 JS 放在
app/assets/js/→ Revel 路由不识别该路径，不转发也不报错，静默 404 - 用
http.FileServer直接挂载./dist→ 绕过 Revel 的拦截器链，CompressFilter、ETag、版本注入等全部失效
正确做法：
- 所有资源放入
public/css/、public/js/、public/images/等子目录 - 模板中使用以
/开头的绝对路径：<script src="/js/main.js"></script> - 确认项目结构中存在
app/public/（不是public/顶层目录），Revel 只认这个位置
GET /public/*filepath 路由必须显式注册
Revel 默认不自动服务 public/ 下的文件，必须在 conf/routes 中加一行通配符路由，否则即使文件放对位置，照样 404。
关键细节：
- 必须写成
GET /public/*filepath Static.Serve("public")，开头斜杠不能少 - 这行必须放在
routes文件末尾，否则可能被前面更具体的路由拦截 -
Static.Serve("public")中的"public"是指app/public/这个相对路径，不是磁盘绝对路径 - 如果项目用模块（module），模块自己的静态资源需额外配置
staticDir:modulename:public
验证方式：启动后 curl http://localhost:9000/public/css/app.css，能返回内容才算生效。
带版本号的资源 URL 要靠拦截器注入，不能硬编码
浏览器缓存 CSS/JS 是常态，但 Revel 不内置资源指纹（fingerprinting），直接改文件名或加哈希后缀得手动操作，容易漏。推荐用配置驱动的 ?v=xxx 方式，既零侵入又易维护。
实操要点：
- 在
conf/app.conf里加resourceVersion = "20261019-abc123"（可用构建时注入的 Git commit 或时间戳） - 写一个拦截器（如
app/controllers/resourceversion.go），用c.RenderArgs["resourceVersion"]注入模板上下文 - 在模板中拼接：
<link href="/public/css/app.css?v=${resourceVersion}"> - 别忘了在
app/init.go中注册：revel.InterceptMethod(controllers.SetVersion, revel.BEFORE)
注意：${resourceVersion} 是 Revel 模板语法，不是 Go template；若用 {{.resourceVersion}} 会报错。
压缩和缓存行为取决于是否走 Revel 路由
只有经 GET /public/*filepath 路由处理的请求，才会触发 CompressFilter 和 ETag 生成。绕过它，就等于放弃所有框架层优化。
典型陷阱：
- Nginx 配置了
location /public/ { alias /path/to/app/public/; }→ 静态文件由 Nginx 直接返回，Revel 压缩、版本拦截、日志记录全失效 - 前端构建输出
dist/后，用http.FileServer(http.Dir("dist"))启动独立服务 → 和 Revel 完全无关，别指望它参与任何流程 - 启用
results.compressed = true却没开results.compression.filter = true→ 日志里看不到CompressFilter installed，压缩不会发生
真正起作用的组合是：资源放对位置 + 路由正确映射 + 拦截器注册 + 压缩开关双开。四个条件缺一不可，最容易漏的是中间那个路由注册。
