GORM一对多查询报错‘documents: unsupported relations for schema User’求助

错误点1：Preload关联名称大小写不匹配 #

GORM的Preload方法需要严格匹配结构体中定义的关联字段名，你的User结构体里关联字段是大写开头的Documents，但查询时用了小写的"documents"，导致GORM无法识别该关联，触发unsupported relations报错。

错误点2：Find参数赋值错误 #

你声明了var users []models.User用于接收查询结果，但Find方法传入的是&[]models.User{}，这会创建一个新的空切片指针，查询结果不会赋值给你预先声明的users变量，最终返回的是初始空切片。

修正后的代码 #

数据模型（无需修改，本身符合GORM关联规则） #

type User struct {
    gorm.Model
    Name      string
    Email     string
    Password  string
    Documents []Document // 关联字段为大写D的Documents
}

type Document struct {
    gorm.Model
    Name         string
    DateCreated  string
    UserID uint   // 外键UserID对应User表的ID，符合GORM默认命名规则
}

查询函数修正 #

func GetAll(db *gorm.DB) ([]models.User, error) {
    var users []models.User
    // 1. Preload使用结构体字段名"Documents"
    // 2. Find传入&users，将查询结果赋值给声明的变量
    err := db.Preload("Documents").Find(&users).Error
    fmt.Println(err)
    fmt.Println("got users")
    return users, err
}

补充说明 #

GORM默认关联规则：

• 主表关联字段（如User的Documents）对应子表（documents）的外键为user_id，你的Document结构体中UserID会被GORM自动转换为蛇形的user_id字段，符合规则
• Preload对关联字段名称大小写敏感，必须与结构体定义完全一致

内容的提问来源于stack exchange，提问作者Black Eyed Beans