GORM embedded struct使用时访问ID字段报未定义错误

该编译错误由Go结构体匿名嵌入的写法错误导致，和GORM逻辑无关。 #

运行时抛出的报错 #

controllers/users.go:61:36: user.ID undefined (type models.User has no field or method ID)

触发报错的逻辑片段 #

var user models.User

// ... 其他逻辑
jwtToken, err := generateJWT(user.ID, user.Username)

现有模型定义代码 #

package models

import "time"

type BaseModel struct {
    ID        uint `json:"id" gorm:"primaryKey"`
    CreatedAt time.Time
    UpdatedAt time.Time
}

type User struct {
    BaseModel BaseModel `gorm:"embedded"`
    Username  string    `json:"username"`
    Password  string    `json:"password"`
}

具体原因 #

Go的结构体字段提升规则（即直接通过外层结构体访问内层结构体字段/方法）仅对匿名嵌入字段生效：匿名嵌入要求字段只声明类型、不自定义字段名。
当前代码中User结构体里的BaseModel是显式命名字段（字段名和类型名都为BaseModel），不属于匿名嵌入，因此BaseModel内部的ID、CreatedAt等字段不会被提升到User层级，直接访问user.ID会触发编译期的字段不存在错误。
GORM自动迁移正常是因为字段上的gorm:"embedded"标签会被GORM识别，将BaseModel的字段平级映射到数据库表，这个标签仅对GORM的ORM逻辑生效，不会改变Go编译器本身的字段访问规则。

修复方案 #

将User结构体中的BaseModel字段改为匿名嵌入写法即可，修改后代码如下：

type User struct {
    BaseModel // 仅声明类型，不设置字段名，即为匿名嵌入
    Username  string `json:"username"`
    Password  string `json:"password"`
}

修改后BaseModel的所有字段、方法会自动提升到User层级，可直接通过user.ID访问字段，同时GORM对匿名嵌入结构体默认做平级字段映射，和原有自动迁移生成的表结构完全兼容，无需调整数据库结构。 #

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