buffalo dev 启动前必须手动执行 buffalo db migrate 和 buffalo task db:seed，否则数据库为空导致 nil pointer panic；db:seed 须用 pop/v2 在 tasks/db/seed.go 中定义，密码需 bcrypt 哈希，环境数据库 url 需严格区分。
buffalo dev 启动前必须手动跑 migration 和 seed
Buffalo 不会在 buffalo dev 启动时自动执行迁移或填充测试数据，这点和 Rails 不同。你得显式调用命令，否则数据库为空、模型查不到任何记录，连登录页都可能因空指针 panic。
常见错误现象：panic: runtime error: invalid memory address or nil pointer dereference 出现在 handler 里访问 c.DB() 查询后直接取字段时——往往是因为表根本没建，或 seed 没跑，查出来是 nil。
- 先确保 migration 已应用：
buffalo db migrate - 再运行 seed：
buffalo task db:seed（前提是已定义该 task） - 如果提示
task not found，说明还没创建 seed task，需手动补上
db:seed task 必须用 pop/soda 定义，不能只写 Go 函数
Buffalo 的 seed 机制依赖 github.com/gobuffalo/pop/v2（即 soda），不是原生 Go 函数调用。直接在 actions/app.go 里写个 initTestData() 是无效的，buffalo task 命令压根识别不了。
正确做法是：在 tasks/db/seed.go（路径必须匹配）中定义：
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
package db
import (
"github.com/gobuffalo/buffalo/task"
"github.com/gobuffalo/pop/v2"
"yourapp/models"
)
func init() {
task.Add("db:seed", "Seeds the database", func(c buffalo.Context) error {
tx, err := models.DB.Connect()
if err != nil {
return err
}
defer tx.Close()
// 示例：插入一个管理员用户
u := &models.User{
Email: "admin@example.com",
Password: "password",
}
if verr := u.Create(tx); verr != nil {
return verr
}
return nil
})
}
- 文件路径必须是
tasks/{namespace}/{name}.go，否则buffalo task扫描不到 - 函数名无关紧要，但
task.Add第一个参数字符串必须是namespace:name格式 - 别用
models.DB直接操作——它可能未初始化；要用models.DB.Connect()显式获取事务连接
seed 中避免硬编码密码，用 bcrypt.GenerateFromPassword 预哈希
如果你的 User 模型有密码字段且用了 bcrypt（Buffalo 默认 auth 模板就是），直接存明文会导致登录失败：校验时比对的是哈希值，而 seed 里塞的明文永远不匹配。
示例中 Password: "password" 是错的，必须提前哈希：
import "golang.org/x/crypto/bcrypt"
// … 在 seed 函数内：
hashed, _ := bcrypt.GenerateFromPassword([]byte("password"), bcrypt.DefaultCost)
u.Password = string(hashed)
- 别跳过
bcrypt.GenerateFromPassword，哪怕只是测试数据 - 错误写法：
u.SetPassword("password")—— 这是 pop 的钩子方法，但仅在Create或Update时触发，seed 里手动赋值不会触发 - 更安全的做法：把哈希逻辑封装进 model 的
BeforeCreatehook，但 seed 仍建议显式调用，避免 hook 未注册导致静默失败
测试环境用 sqlite + 内存 DB 可跳过 seed，但 CI 中务必还原
开发时若用 sqlite3://./dev.sqlite，每次 buffalo dev 启动前删掉 dev.sqlite 文件就能重置——此时 seed 可省略。但这是偷懒，CI 流程（如 GitHub Actions）通常用 PostgreSQL 或 MySQL，没有文件可删，必须靠 buffalo db migrate + buffalo task db:seed 组合保证状态一致。
容易被忽略的一点：Buffalo 的 database.yml 中不同环境的 url 字段必须明确区分。比如测试环境误配成和开发一样指向 dev.sqlite，那 CI 跑测试时就会污染本地数据库文件，后续 buffalo dev 启动看到一堆“测试用户”，非常干扰调试。
