revel 不内置静态文件服务，需手动配置：开发用 http.fileserver 挂载 /public/ 目录，生产交由 nginx 处理；模板中应使用相对路径如 /public/js/app.js，避免硬编码域名或版本号。
Revel 不提供内置静态文件服务，必须手动配置 HTTP 服务层
Revel 本身不处理 /public/css/style.css 或 /public/images/logo.png 这类请求——它只管 MVC 流程，静态资源得靠 Web 服务器（如 Nginx）或 Go 的 http.FileServer 来响应。如果你在开发中直接访问 http://localhost:9000/public/js/app.js 返回 404，不是路由写错了，而是 Revel 根本没注册这个路径。
常见错误现象：
- 浏览器控制台报
Failed to load resource: the server responded with a status of 404 () - 模板里写了
<script src="/public/js/app.js"></script>，但实际没加载 - 误以为
RenderFile能用于公开静态资源（它只适合单次下载，不支持缓存、ETag、范围请求等）
开发阶段：用 http.FileServer 挂载 public/ 目录
Revel 的 app/init.go 是启动前唯一可控的入口点，这里可以安全地复用 Go 原生的 http.ServeMux 注册静态路由。关键点是：必须在 revel.Harness.Init() 之后、revel.Run() 之前插入。
实操建议：
- 在
app/init.go中找到revel.Run()上方位置，添加如下代码： http.Handle("/public/", http.StripPrefix("/public/", http.FileServer(http.Dir(revel.BasePath + "/public"))))- 确保
public/目录在项目根目录下（即与app/、conf/同级），而不是放在app/内部 - 路径前缀
/public/必须带尾部斜杠，否则StripPrefix会失效 - 不要用
revel.InterceptMethod拦截静态请求——性能差且绕过 HTTP 缓存机制
生产环境：应交由反向代理（如 Nginx）处理静态资源
Go 进程直接 serve 静态文件在高并发下效率低、无压缩、不支持 Brotli、无法设置强缓存头。Nginx 可以自动加 Cache-Control: public, max-age=31536000 和 ETag，还能 gzip/brotli 压缩 JS/CSS。
典型 Nginx 配置片段：
location /public/ {
alias /var/www/my-revel-app/public/;
expires 1y;
add_header Cache-Control "public, immutable";
gzip on;
brotli on;
}
注意：alias 后路径末尾必须有 /，且和 Revel 中模板引用的路径前缀（如 /public/js/）严格一致；若用 root，则路径拼接逻辑不同，容易 404。
模板中引用静态资源时，别硬编码版本号或协议+域名
比如写成 <img src="http://localhost:9000/public/images/icon.png?x-oss-process=image/resize,p_40"> 或 <script src="/public/js/app.js?v=20261016"></script> 都有问题：前者本地开发还行，部署到 HTTPS 域名就跨协议失败；后者每次构建都得改 HTML，违背“零侵入”原则。
更稳妥的做法：
- 保持路径为相对 URL：
/public/js/app.js，由 Nginx 或http.FileServer统一响应 - 如需缓存失效，走 Revel 的拦截器注入版本参数（参考
resourceVersion配置 + 模板?v=${resourceVersion}），但仅限开发或简单部署场景 - 避免在 JS/CSS 文件内容里写死
window.location.origin拼 URL——静态资源本身不该关心部署环境
真正容易被忽略的是：Revel 的热重载只监视 app/ 目录，改了 public/ 下的文件不会触发重启，但你可能误以为要重启才能看到新图片——其实只要刷新浏览器就行，前提是 http.FileServer 已正确挂载。
