buffalo框架迁移本质是调用soda cli工具，需确保soda在path中；迁移文件由buffalo pop generate fizz生成并置于models/migrations/，命名含时间戳前缀（如20260928152233_add_status_to_users.up.fizz），执行时须停buffalo dev并运行soda migrate up -e development。
Buffalo框架里用Pop做迁移，本质是调用pop/soda命令行工具
Buffalo本身不实现迁移逻辑，而是封装了pop/soda（即soda CLI），底层依赖github.com/gobuffalo/pop/v6。迁移文件由buffalo pop生成，执行靠soda二进制——这意味着你必须确保soda在PATH中，或显式指定路径。
- 安装
soda：运行go install github.com/gobuffalo/pop/v6/soda@latest（Go 1.21+），安装后验证soda version - 迁移文件默认放在
./migrations/下，命名格式为timestamp_name.up.fizz或.sql，Buffalo默认用fizz语法（类DSL的Go风格SQL描述） - 如果项目初始化时没启用Pop（比如用
--skip-pop），buffalo pop命令会报错，需先手动添加github.com/gobuffalo/pop/v6到go.mod并运行buffalo dev重载配置
执行迁移前必须检查database.yml和环境变量
soda读取database.yml（位于./database.yml）来连接数据库，但Buffalo运行时用的是GO_ENV环境变量决定加载哪个section，而soda默认只认development，除非显式传-e参数。
-
database.yml里development节必须配置正确，否则soda migrate连不上：常见错误是host写成localhost但PostgreSQL实际监听127.0.0.1，或sslmode没设成disable（本地开发时） - 密码含特殊字符（如
@、/）会导致URL解析失败，必须URL编码；例如密码pa@ss/word要写成pa%40ss%2Fword - 执行迁移时加
-e production才读production节，但Buffalo的buffalo task db:migrate默认不传该参数，所以别依赖task alias，直接用soda -e production migrate
用soda migrate执行时要注意up/down顺序和状态表
soda靠schema_migrations表（PostgreSQL/MySQL）或_migrations（SQLite）记录已执行的migration版本号，每次只执行未记录的.up文件，跳过已存在的version。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 执行
soda migrate等价于soda migrate up，它按文件名时间戳升序执行所有未应用的.up；soda migrate down则按降序回退最近一次（仅1次），不是全部 - 想重跑某次迁移？不能直接删
schema_migrations记录——得先soda migrate down，再手动删对应文件或改文件名，否则soda认为“已执行”而跳过 -
fizz文件里写create_table("users", func(t *Table) { ... })没问题，但若用了db.RawQuery(...).All()这类需要DB连接的操作，会在soda migrate阶段panic，因为此时DB连接尚未初始化（Pop的tx上下文未注入）
Buffalo task db:migrate只是soda命令的包装，别把它当黑盒
buffalo task db:migrate底层就是调soda migrate，但它会自动设置GO_ENV并尝试加载Buffalo的配置，容易掩盖真实错误。
- 调试失败时，优先绕过task，直接运行
soda -e development migrate -v（-v输出详细SQL），能看到具体哪条语句卡住 - 如果
soda报unknown driver "postgres"，说明import _ "github.com/gobuffalo/pop/v6/soda/cmd"没被引入——这个import在buffalo pop生成的main.go里，但如果你删了或重构了cmd入口，就得手动补上 - CI/CD中执行迁移，别用
buffalo task，直接soda -e production migrate，并确保database.yml里的production节有最小权限账号（比如只允许CREATE TABLE、ALTER TABLE，禁用DROP DATABASE）
真正麻烦的从来不是写迁移文件，而是database.yml的环境适配、soda的driver加载时机、以及回滚时对状态表的手动干预——这些地方出问题，日志往往只报“connection refused”或“no such table”，得一层层确认配置来源和执行上下文。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
