Gorm中User与Song多关联配置报错，如何实现对象级关联？

问题 #

使用Go语言搭配Gorm框架与PostgreSQL开发简易应用，支持用户添加歌曲到列表并对歌曲投票。结构体定义如下：

type User struct {
    gorm.Model
    Name        string `json:"name"`        // Name of user
    DisplayName string `json:"displayName"` // Display name of user
    Password    string `json:"password"`    // Password
    SongsAdded  []Song `json:"songs"`       // Songs added by user
}

type Song struct {
    gorm.Model
    Title    string `json:"title"`    // Song title
    Artist   string `json:"artist"`   // Song artist
    ImageURL string `json:"imageUrl"` // URL to image
    UserId   uint   `json:"userId"`   // ID of user that added the song
    Likes    []User `json:"likes"`    // List of users that like the song
    Dislikes []User `json:"dislikes"` // List of users that dislike the song
}

执行db.AutoMigrate(&User{}, &Song{})时触发报错：

invalid field found for struct main.Song's field Likes: define a valid foreign key for relations or implement the Valuer/Scanner interface

需要保留对象级关联以避免额外查询，解决关联识别混乱的问题。

解决方案 #

问题根源是同一User与Song间存在三种关联关系（用户添加歌曲、用户点赞歌曲、用户点踩歌曲），Gorm无法自动识别多对多关联的规则，需通过Gorm标签明确每个关联的外键与中间表配置：

1. 重构结构体，明确关联规则 #

type User struct {
    gorm.Model
    Name          string  `json:"name"`          // Name of user
    DisplayName   string  `json:"displayName"`   // Display name of user
    Password      string  `json:"password"`      // Password
    // 一对多：用户添加的歌曲，明确外键为Song的UserId
    SongsAdded    []Song  `json:"songs" gorm:"foreignKey:UserId"`
    // 多对多：用户点赞的歌曲，指定中间表为song_likes
    LikedSongs    []Song  `json:"likedSongs" gorm:"many2many:song_likes;joinForeignKey:UserID;joinReferences:SongID"`
    // 多对多：用户点踩的歌曲，指定中间表为song_dislikes
    DislikedSongs []Song  `json:"dislikedSongs" gorm:"many2many:song_dislikes;joinForeignKey:UserID;joinReferences:SongID"`
}

type Song struct {
    gorm.Model
    Title     string `json:"title"`     // Song title
    Artist    string `json:"artist"`    // Song artist
    ImageURL  string `json:"imageUrl"`  // URL to image
    UserId    uint   `json:"userId"`    // ID of user that added the song
    // 反向关联：添加歌曲的用户，通过UserId关联
    AddedBy   User   `json:"addedBy" gorm:"foreignKey:UserId"`
    // 多对多：点赞该歌曲的用户，对应中间表song_likes
    Likes     []User `json:"likes" gorm:"many2many:song_likes;joinForeignKey:SongID;joinReferences:UserID"`
    // 多对多：点踩该歌曲的用户，对应中间表song_dislikes
    Dislikes  []User `json:"dislikes" gorm:"many2many:song_dislikes;joinForeignKey:SongID;joinReferences:UserID"`
}

2. 关键配置说明 #

• 一对多关联（用户添加歌曲）：通过gorm:"foreignKey:UserId"明确User.SongsAdded关联的是Song.UserId，同时Song.AddedBy实现反向关联，方便查询歌曲的添加者。
• 多对多关联（点赞/点踩）：
  • 用many2many标签指定中间表名称（song_likes/song_dislikes），Gorm会自动创建这两张中间表。
  • joinForeignKey是当前模型在中间表中的外键字段，joinReferences是关联模型在中间表中的外键字段，以此区分不同的多对多关系。

3. 使用示例（预加载关联对象） #

查询歌曲时可通过Preload一次性加载所有关联对象，避免额外查询：

var song Song
db.Preload("AddedBy").Preload("Likes").Preload("Dislikes").First(&song, 1)

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