Buffalo new 报错因要求目录完全为空(无go.mod、.git等),需清空后重试;generate resource 默认含HTML中间件,返回403或模板错误需改c.JSON、注释session/csrf中间件并设app.Templates=nil。

buffalo new 为什么总报错:directory not empty 或 module already exists
因为 Buffalo 强制要求项目初始化必须在**完全空的目录**中进行,且不能已有 go.mod。它不兼容已有模块、隐藏文件(如 .git)、README.md 甚至 IDE 配置目录(如 .vscode)。
常见错误现象:error: directory is not empty 或 failed to create module: go mod init failed。
- 执行前先确认:
ls -A(macOS/Linux)或dir /a(Windows)——目录下不能有任何文件或子目录 - 若已执行过
go mod init,必须删掉go.mod和go.sum再试 - 想跳过前端构建?加
--api参数:buffalo new myapi --api --skip-yarn,它会自动忽略assets/、templates/等目录
buffalo generate resource 生成的接口为什么返回 403 或模板未定义
因为 buffalo generate resource 默认为 HTML 页面设计,硬编码了 session、CSRF、DB 事务中间件,且所有 handler 都调用 c.Render()——它会强制查找 HTML 模板,删了模板就报 template: "xxx.html" is undefined;POST/PUT 请求没带 token 就直接 403。
Buffalo框架 1.0.1 版本源码包下载,适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 删模板 ≠ 解决问题:中间件链还在运行,
session.Middleware和csrf.New()仍会拦截请求 -
c.Render(200, r.Auto(c, data))必须改成c.JSON(200, data),否则 Content-Type 仍是text/html - 必须注释掉
app.Use(session.Middleware)、app.Use(csrf.New())、app.Use(pop.Transaction)这三行 - 确认
app.Templates = nil已设置,否则r.Auto()仍会尝试加载模板
buffalo dev 启动失败:command not found 或 assets 构建卡住
Buffalo CLI 不是“装完就能用”的二进制——它依赖 Go 工具链(go mod、go build)和 Node.js(Webpack 构建 assets),任一缺失都会让 buffalo dev 失败。
-
buffalo version报command not found?说明$GOBIN(默认$GOPATH/bin)没进$PATH,需手动添加 -
buffalo dev卡在building assets...?先跑npm install,再确认node -v≥ 18.x、npm -v≥ 9.x - Linux/macOS 缺
gcc会导致buffalo db create失败(sqlite3 驱动编译不过),Ubuntu 执行sudo apt-get install build-essential,macOS 执行xcode-select --install
buffalo test 在 CI 中一直 timeout 或连不上数据库
CI 环境里 buffalo test 默认读取 database.yml 并尝试连接真实 DB,同时初始化 Pop migration,而大多数 CI 并不启动 PostgreSQL/MySQL 容器——结果就是超时或 panic。
- 必须设环境变量:
BUFFALO_ENV=test,否则它可能误读开发配置 - 禁用 DB 初始化:在
actions/app.go中把pop.Transaction中间件替换成空 handler,或直接删掉相关代码 - 跳过 session 初始化:注释掉
session.Middleware,或改用内存 store(session.NullStore)避免 Redis 依赖 - 别用
buffalo test跑全量测试;改用分层go test ./actions/...或go test ./models/...,更可控也更快
实际项目里最容易被忽略的是中间件清理顺序:删模板、改 c.JSON、关中间件这三步缺一不可,少一步就可能返回 500 而不是你预期的 JSON。尤其 csrf.Middleware 对非浏览器客户端是隐形杀手,它不会报错提示,只静默拒绝。










