Buffalo项目启动失败90%因数据库未连通、依赖未拉全或session中间件配置错误：需先验证数据库服务，正确配置database.yml，执行go mod tidy和npm install，显式启用session.Middleware()并调用Save()，手动执行migrate，注意特殊字符URL编码。
Buffalo 项目开发环境跑不起来，90% 是因为数据库没连上、依赖没拉全、或 session 中间件配置错位——不是框架难，是它默认把“可运行”和“可调试”拆成了三步，漏掉任何一步都会卡在 buffalo dev 启动失败或页面白屏。
database.yml 配置必须先通数据库再填字段
别急着改 config/database.yml。先确认本地 PostgreSQL 或 MySQL 真的在跑：
- PostgreSQL：用
pg_isready -h localhost -p 5432或telnet localhost 5432测试端口；失败就别往下填了 - MySQL：运行
mysqladmin -u root -p ping，输密码后看到mysqld is alive才算到位 - 填
development:区块时，dialect必须小写且拼写准确："postgres"或"mysql"，写成"postgresql"或"pg"会报unknown dialect - MySQL 的
host建议写"127.0.0.1"而非"localhost"，避免 Unix socket 解析失败
go mod tidy 和 npm install 缺一不可
buffalo dev 启动时会同时触发 Go 编译和前端资源构建，两套依赖都得提前装好：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 执行
go mod tidy补全所有子依赖，尤其是github.com/gobuffalo/pop/v6—— 缺这个，buffalo db migrate直接 panic - 即使你删了
assets/，首次仍要运行npm install（或yarn install），否则buffalo dev在尝试调用 webpack 时找不到node_modules会直接退出 - 如果项目用 SQLite，确保系统已安装
gcc：Go 的sqlite3驱动需要 C 编译器，否则go build阶段失败
session.Middleware() 必须显式启用才可用 Session
开发时想用 c.Session().Set() 却发现值丢了？大概率是中间件没挂上：
- 检查
app.go中是否包含app.Use(session.Middleware())，没有就加一行——否则c.Session()返回空对象，Set()调用静默失效 -
c.Session().Set()后必须紧跟c.Session().Save()，否则 Cookie 不下发，刷新就丢数据 - 读取时注意类型断言：
id, ok := c.Session().Get("user_id").(int)，ok为 false 说明 key 不存在或类型不匹配，硬断言会 panic - 测试环境里
c.Session()默认不可用，得用c.Set("key", value)模拟，别指望c.Session().Set()
buffalo dev 启动前必须手动 migrate
buffalo dev 不会自动执行迁移，它只管热重载代码——数据库结构不就位，访问页面立刻 table not found：
- 先跑
buffalo db create -a创建库，失败提示permission denied就得用 DBA 账号手动建库并赋权 - 再跑
buffalo db migrate应用所有未执行的 migration 文件，按文件名时间戳升序执行 - 如果 migration 失败，看错误信息里具体哪条 SQL 报错，别直接
rollback——开发阶段更建议删掉出问题的 migration 文件重g model - 端口被占？加参数
buffalo dev -p 4000，别去改config/env.go，那个只影响生产构建
最常被忽略的点：database.yml 里的 password 字段若含特殊字符（如 @、/），必须 URL 编码；session.yml 里的 secret 为空会导致 Save() 返回 500；还有——Buffalo 不启动数据库，它只连接。
