必须在项目根目录下运行buffalo dev，且数据库服务、迁移状态、端口、环境变量四者全部就绪，否则静默失败或panic；它强依赖预设状态，非“进目录就跑”命令。
必须在项目根目录下运行 buffalo dev，且数据库服务、迁移状态、端口、环境变量四者全部就绪，否则它不会报错，只会静默失败或 panic。
buffalo dev 前提条件缺一不可
它不是“进目录就跑”的命令，而是强依赖预设状态的生命周期入口：
- 当前目录必须包含
actions/、models/、buffalo.yaml—— 否则提示no app found - 数据库服务（PostgreSQL/MySQL/SQLite）必须已启动并可连通；
buffalo dev不拉起 DB，只连 DB - 执行过
buffalo db create和buffalo db migrate；若 migration 表脏（比如上次 migrate 中断），会直接 panic - 端口
:3000未被占用；它不提示冲突，而是卡住或返回空响应 —— 快速验证加-p 4000 -
GO_ENV=development必须在命令前导出，例如：GO_ENV=development buffalo dev；.env文件仅被buffalo dev读取，对buffalo build无效
常见静默失败现象和对应检查点
没有报错但页面打不开、控制台无日志、浏览器空白 —— 这是 buffalo dev 最典型的“假死”表现：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 访问
http://localhost:3000返回 500 或空白？立刻检查buffalo db migrate是否成功执行（看pop/soda输出是否含up to version xxx） - 终端无任何输出？确认
GO_ENV是否生效：在actions/app.go的app.New()后加log.Printf("env: %s", app.Env)，看是否打印development - LiveReload 不触发、页面不自动刷新？不是前端问题，而是中间件干扰了 WebSocket 响应头 —— 检查是否自定义了
app.Use()并修改了Content-Type或提前写了响应体 - 热重载完全不工作？确认你改的是
actions/或templates/下的文件；改main.go、go.mod或config/env.go不会触发重启
启动时加参数绕过典型陷阱
不是所有问题都要修代码，有些靠命令行开关就能跳过：
- 删了
assets/却仍卡在npm install？用buffalo dev --skip-assets - 不想每次启动都重建 SQLite 文件？确保
database.yml的development区块里url指向绝对路径，如sqlite3://./dev.db（相对路径在不同工作目录下会失效） - 想换端口又懒得记参数？写个 alias：
alias bd='GO_ENV=development buffalo dev -p 4000' - 怀疑 watcher 被 IDE 的 atomic write 干扰？手动触发一次：
touch actions/home.go
最容易被忽略的点是：它根本不校验数据库连接是否真通，只在第一次 HTTP 请求进来时才尝试 Dial。所以 buffalo dev 成功启动 ≠ 数据库可用 —— 第一个页面请求才真正暴露连接问题。
