Buffalo 默认不自动提供静态文件服务,必须显式调用 app.ServeFiles("/assets", http.Dir("public/assets")) 等路由注册,否则访问 /assets/ 或 /uploads/ 会直接 404;路径前缀与磁盘目录须严格匹配,且生产环境应交由 nginx 等反向代理处理静态资源。

Buffalo 的静态路由不会自动生效,必须显式调用 app.ServeFiles 并确保路径匹配,否则 /assets/ 或 /uploads/ 会直接 404。
为什么 public/ 目录下的文件打不开?
Buffalo 默认不提供任何静态文件服务。即使你把 logo.png 放进 public/images/,访问 http://localhost:3000/images/logo.png 也会返回 404 —— 因为没有注册对应路由。
-
buffalo dev启动后只注册了应用路由(如GET /),public/是纯目录,不是路由 - Web 服务器(如 nginx)能直接服务
public/,但 Buffalo 内置的http.Server不会自动映射它 - 如果你删过
app.ServeFiles调用(比如用了--api模板后手动清理过app.go),那基本所有静态资源都挂了
app.ServeFiles 怎么写才对?
关键在两处:前缀路径(URL 路径)和本地路径(磁盘路径),且二者不能颠倒或错配。
- 第一个参数是 URL 前缀,例如
"/assets",表示浏览器请求/assets/app.js时触发该规则 - 第二个参数是磁盘路径,必须用
http.Dir()包裹,且指向public/下的子目录,例如http.Dir("public/assets") - 错误写法:
app.ServeFiles("/assets", http.Dir("./assets"))—— 缺少public/,路径不存在 - 正确写法:
app.ServeFiles("/assets", http.Dir("public/assets")) - 若想暴露整个
public/,可写app.ServeFiles("/", http.Dir("public")),但会覆盖根路由,慎用
Webpack 构建产物怎么和静态路由联动?
Webpack 输出必须落到 public/assets/,且 app.ServeFiles 必须绑定到 "/assets",二者路径要镜像对齐。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 检查
webpack.config.js:output.path必须是path.join(__dirname, "public/assets"),不是dist/或build/ - 检查
output.publicPath必须是"/assets/"(结尾带斜杠),否则生成的app.js引用路径变成/assetsapp.js - 启动前确认
public/assets/app.js文件真实存在;如果buffalo dev没触发 Webpack 构建,手动跑一次npm run build - 模板里引用要用
<script src="/assets/app.js"></script>,不能写成./assets/app.js或../assets/app.js
生产环境要不要保留 app.ServeFiles?
不要。生产部署时应由反向代理(nginx / Caddy)接管静态文件服务,Buffalo 进程只处理动态请求。
- 保留
app.ServeFiles会导致 Go 进程阻塞读取磁盘文件,吞吐下降,且无法利用 HTTP 缓存头、gzip、Brotli 等优化 - Docker 镜像中若用
scratch基础镜像,public/目录虽被复制进去,但 Go 进程已无文件系统权限去读取它 - 正确做法:在 nginx 配置里加
location /assets { alias /app/public/assets; },然后在 Buffalo 中移除所有app.ServeFiles调用
最容易被忽略的是 publicPath 和 app.ServeFiles 前缀的严格一致性 —— 差一个字符(比如少斜杠、多点号),就全链路失效,而且没报错,只有 404。










