使用golang-migrate执行PostgreSQL迁移时migrate.New报空指针如何解决

问题排查与修复方案 #

1. 首要错误：迁移文件路径配置错误 #

你代码中migrate.New传入的sourceURL为file:///database/migration/，三个斜杠前缀代表读取系统根目录下的/database/migration路径，而你Makefile中使用的是file://database/migration（两个斜杠前缀，对应项目根目录下的相对路径）。绝大多数场景下你不会把迁移文件放在系统根目录，migrate找不到对应路径就会初始化失败，返回的m为nil空指针。

2. 语法错误 #

你贴出的Migration方法代码中，migrate.New调用行末尾多了一个多余的右括号，会直接引发编译错误：

// 错误写法，末尾多了一个)
m, err := migrate.New("file:///database/migration/", "postgres://postgres:postgres@127.0.0.1:5432/go_graphql?sslmode=disable"))

删除多余的右括号即可。

3. 错误被吞导致无法定位根因 #

你当前捕获migrate.New的错误后，直接返回了自定义的通用报错，没有透出原始错误信息，无法区分是路径错误、数据库连接错误还是其他问题，修改错误返回逻辑透传原始错误：

if err != nil {
    return fmt.Errorf("error happened when migration: %w", err)
}

4. 其他可能的触发原因 #

• 确认运行Go程序时PostgreSQL服务正常启动，go_graphql数据库已提前创建，账号密码、端口配置正确
• 建议不要在Migration方法中硬写数据库连接串，直接复用你已经读取到的config.Database.URL即可，避免两处配置不一致的问题。

修复后的参考代码 #

func (db *DB) Migration() error {
    // 路径改为两个斜杠的相对路径，匹配Makefile的配置
    m, err := migrate.New("file://database/migration/", db.config.Database.URL)
    if err != nil {
        return fmt.Errorf("init migrate failed: %w", err)
    }
    if err := m.Up(); err != nil && err != migrate.ErrNoChange {
        return fmt.Errorf("migrate up failed: %v", err)
    }
    log.Println("migration completed!")
    return nil
}

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