如何使用Golang学习GORM框架开发流程-Golang-PHP中文网

gorm 初始化失败主因是dsn格式错误或mysql驱动未导入，结构体字段不映射因未导出、标签缺失或命名策略未启用；查询失败多因零值参与where或未用errors.is判断errrecordnotfound。

如何使用golang学习gorm框架开发流程

直接上手 GORM 最容易卡在「连不上数据库」和「结构体字段不映射」这两步，不是框架难，是初始化配置和标签写法有隐含规则。

gorm.Open 为什么总 panic: failed to initialize database

绝大多数情况是 DSN 格式不对或驱动没导入。GORM v2 不再自动注册驱动，sql.Open 的底层驱动必须显式导入。

MySQL：必须 import _ "github.com/go-sql-driver/mysql"，不能只 import gorm
DSN 中的 parseTime=true 和 loc=Local 要成对出现，否则 time.Time 字段会扫描失败
连接池设置别漏掉：db.SetMaxOpenConns(10)、db.SetMaxIdleConns(5)，否则压测时直接报 dial tcp: lookup xxx: no such host

测试连通性最简代码：

db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{SkipDefaultTransaction: true})
if err != nil {
    log.Fatal(err) // 别只 print，err 里有具体驱动报错
}

struct 字段不入库？检查 GORM 标签和首字母大小写

GORM 只处理导出字段（首字母大写），且默认按 struct 字段名映射列名。不加标签、不设类型、乱用下划线，都会导致字段被忽略或类型错配。

Golang Stay Updated

提供最新的 Golang 新闻、社群和值得关注的人。适用于寻找 Go 学习资源、发现新库等。

下载

ID 字段必须是 uint、int、int64 或 string，且需显式声明 primaryKey 标签，否则 GORM 不认主键
CreatedAt/UpdatedAt 这类时间字段，要加 autoCreateTime/autoUpdateTime，光靠字段名不会自动赋值
列名含下划线？别依赖 snake_case 自动转换——GORM v2 默认关闭该行为，必须手动开启：gorm.NamingStrategy{SingularTable: true, NameReplacer: strings.NewReplacer("ID", "id")}

示例正确写法：

type User struct {
    ID        uint      `gorm:"primaryKey"`
    Name      string    `gorm:"size:100"`
    CreatedAt time.Time `gorm:"autoCreateTime"`
    UpdatedAt time.Time `gorm:"autoUpdateTime"`
}

First/Where 查不到数据？注意零值和 SQL 生成逻辑

db.Where(&User{Name: "foo"}).First(&u) 看似合理，但 GORM 会把空字段（如 ID: 0）也拼进 WHERE，导致查不到。这不是 bug，是设计选择。

避免用 struct 传参做查询条件，改用 map 或表达式：db.Where("name = ?", "foo").First(&u)
First 找不到会返回 ErrRecordNotFound，但错误类型是 *gorm.Error，直接 err == nil 判断不可靠，要用 errors.Is(err, gorm.ErrRecordNotFound)
想查多个字段又不想写全 struct？用 Select("name, email")，否则 GORM 默认 SELECT *
软删除字段 DeletedAt 默认启用，如果数据被删过，First 就查不到——确认是否需要 Unscoped()，但别滥用