Golang为模型变量赋值gorm.DB实例时触发nil空指针panic问题

报错的核心原因是Go包初始化执行顺序与预期不符，你在models包的init()中获取数据库连接时，database包的数据库初始化逻辑还未执行，拿到的是空指针，最终调用GORM方法时触发nil pointer dereference panic。

Go程序的初始化执行顺序是固定的：

• 程序启动后会按导入依赖关系，递归初始化所有导入包：每个包先初始化包级变量，再执行包内所有init()函数，全部执行完成后才会回到main包
• main包同样先初始化自身包级变量、执行自身init()，最后才会执行main()函数中的业务逻辑

你的代码执行流程实际是：

1. 启动时先初始化database包：未自定义init()，包级变量DB为类型零值nil
2. 接着初始化models包：执行init()调用database.GetDB()，此时database.DB还是nil，赋值给models.Conn的也是空值
3. 最后进入main()函数，执行database.InitDatabase()给database.DB赋上有效连接实例，但此时models.Conn已经存了之前的nil值，不会同步更新
4. 调用models.GetAll()时，对nil的Conn调用Find()方法，直接触发空指针panic

你把database.GetDB()移动到GetAll()内部就能正常运行，本质是因为GetAll()在database.InitDatabase()执行完成后才被调用，此时拿到的database.DB已经是有效实例，不存在空值问题。

要实现数据库连接仅初始化一次、模型层全局复用的需求，不要依赖包init()隐式获取连接，以下两种方案都可以稳定实现需求：

方案1：懒加载（侵入性最低，支持并发安全） #

在模型层通过sync.Once实现连接的单次初始化，第一次调用数据库方法时才获取连接，后续全局复用，修改models/meme.go代码：

package models

import (
    "sync"
    "gorm.io/gorm"
    "gitlab.com/webeoparty/api/database"
)

type Meme struct {
    gorm.Model
    Id  uint32
    Source string
    Filename_local string
    Original_filename string
    Public_id string
    Url string
    Secure_url string
    Resource_type string
    Width uint32
    Height uint32
}

var (
    Conn *gorm.DB
    connOnce sync.Once
)

// 并发安全的获取连接方法，保证只赋值一次
func getConn() *gorm.DB {
    connOnce.Do(func() {
        Conn = database.GetDB()
    })
    return Conn
}

func GetAll() ([]Meme, error) {
    var memes []Meme
    tx := getConn().Find(&memes)
    if tx.Error != nil {
        return []Meme{}, tx.Error
    }
    return memes, nil
}

方案2：显式初始化（流程完全可控） #

去掉隐式的init()逻辑，在main函数中按顺序显式完成各模块初始化：

1. 删除models/meme.go中原来的init()函数，新增显式初始化方法：

// models/meme.go 新增
func Init() {
    Conn = database.GetDB()
}

2. 调整main.go的执行顺序，数据库初始化完成后再初始化模型层：

func main() {
    err := godotenv.Load()
    if err != nil {
        panic("Error loading .env file")
    }

    database.InitDatabase()
    models.Init() // 数据库连接初始化完成后，再给模型层赋值连接实例

    memes, err := models.GetAll()
    if err != nil {
        log.Fatal("err database get memes")
    }

    for _, meme := range memes {
        log.Printf(meme.Url)
    }
}

你贴出的database/database.go代码中，import块缺少"os"包，调用os.Getenv("DATABASE_URL")时会触发编译错误，记得补上对应导入。

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