Golang中使用Packr嵌入数据库迁移无生效问题排查

你遇到的核心问题是代码中Packr未能正确加载迁移文件，导致migrate.Exec无错误但未执行任何迁移，而CLI工具能正常识别并执行。以下是具体排查方向和解决方法：

1. 修正Packr的路径指向 #

最常见的原因是相对路径错误：你的sqlite.go所在目录与migrations文件夹的相对位置和代码中写的./migrations不匹配。

示例项目结构假设 #

如果你的项目结构是：

your-project/
├── migrations/
│   └── 001_initial.up.sql
└── storage/
    └── sqlite/
        └── sqlite.go

那么在sqlite.go中，./migrations会指向storage/sqlite/migrations（不存在的路径），正确的相对路径应该是../../migrations。

修正后的代码 #

func (s Storage) Migrate() error {
    const op = "storage.sqlite.Migrate"

    // 调整为正确的相对路径，指向项目根目录下的migrations文件夹
    migrations := &migrate.PackrMigrationSource{
        Box: packr.New("migrations", "../../migrations"),
    }

    // 调试：打印加载到的迁移文件，确认路径是否正确
    if files := migrations.Box.List(); len(files) == 0 {
        return fmt.Errorf("%s: no migration files found, check path", op)
    }

    count, err := migrate.Exec(s.db, "sqlite3", migrations, migrate.Up)
    if err != nil {
        return fmt.Errorf("%s: %w", op, err)
    }
    fmt.Printf("Applied %d migrations\n", count)
    return nil
}

2. 确认Packr版本兼容性 #

Packr v1和v2的API存在差异：

• 如果你使用Packr v2，需要导入github.com/gobuffalo/packr/v2，并将packr.New替换为packr.NewBox：

  migrations := &migrate.PackrMigrationSource{
      Box: packr.NewBox("../../migrations"),
  }
  

3. 验证数据库连接一致性 #

确保代码中s.db连接的数据库文件，与CLI工具sql-migrate up操作的是同一个文件：

• 检查代码中sqlite连接的DSN（如./db.sqlite），是否和CLI配置文件（如dbconfig.yml）中的路径一致。
• 避免使用内存数据库（:memory:），否则迁移效果仅存在于当前进程中，CLI无法看到。

4. 检查迁移文件命名规范 #

sql-migrate要求迁移文件必须遵循[版本号]_[描述].up.sql的命名格式（如001_initial.up.sql），否则PackrMigrationSource无法识别。

5. 开发/生产环境打包验证 #

• 开发环境下，Packr会直接读取磁盘文件；生产环境需要用packr build命令编译，将迁移文件嵌入二进制中，否则运行时会找不到文件。

内容的提问来源于stack exchange，提问作者Alex Zhulin