Golang中使用Gorm Preload无法加载Student关联Siblings数据

1. 修正Student模型的关联配置 #

你当前的自关联多对多标签配置不完整，需要明确指定外键与中间表字段的映射关系，修改Student结构体中的Siblings字段：

type Student struct {
    UserID           uint `gorm:"primaryKey"`
    CreatedAt        time.Time
    UpdatedAt        time.Time
    DeletedAt        gorm.DeletedAt
    User             User           `gorm:"foreignKey:UserID"`
    // 补充完整多对多关联映射规则
    Siblings         []Student      `gorm:"many2many:siblings;foreignKey:UserID;joinForeignKey:student_id;associationForeignKey:UserID;joinAssociationForeignKey:sibling_id"`

    LearningGroupID  uint
    LearningGroup    LearningGroup `gorm:"foreignKey:LearningGroupID"`
    DormitoryID      uint
    Dormitory        Dormitory `gorm:"foreignKey:DormitoryID"`
    StudentClubID    uint
    StudentClub      StudentClub `gorm:"foreignKey:StudentClubID"`
    AttendanceNumber uint
    Curriculum       string `gorm:"type:varchar(250);"`
}

中间表Sibling模型保持简洁即可（Gorm会自动与数据库表映射）：

type Sibling struct {
    StudentID uint `gorm:"primaryKey;column:student_id"`
    SiblingID uint `gorm:"primaryKey;column:sibling_id"`
    CreatedAt time.Time
    DeletedAt gorm.DeletedAt
}

2. 修正查询逻辑 #

你的Preload回调手动添加了错误的JOIN逻辑，会干扰Gorm自动处理关联查询；同时Count与Find的执行顺序有误（Count会修改查询上下文），调整后的代码如下：

func (r *repository) ListStudent(f *userDomain.StudentFilter) (students []*userDomain.Student,
    total int, err error,
) {
    var totalNumberInt64 int64

    // 单独执行统计总数，避免JOIN影响统计结果
    err = r.dbConn.Model(userDomain.Student{}).Count(&totalNumberInt64).Error
    if err != nil {
        return nil, -1, err
    }

    // 构建查询并预加载所有关联
    query := r.dbConn.Model(userDomain.Student{}).
        Preload("User").
        Preload("StudentClub").
        Preload("LearningGroup").
        Preload("Dormitory").
        Preload("Siblings"). // Gorm会自动根据关联配置查询中间表
        Joins("JOIN users on users.id = students.user_id")

    // 应用分页规则
    if f.Base.Pagination {
        query = query.Limit(f.Base.PerPage).
            Offset(f.Base.PerPage * (f.Base.PageNum - 1))
    }

    // 查询最终结果
    if err := query.Find(&students).Error; err != nil {
        return nil, -1, err
    }
    return students, int(totalNumberInt64), nil
}

关键问题说明 #

• 自关联多对多必须明确配置所有映射参数，确保Gorm能正确匹配Student主键与中间表的student_id、sibling_id字段。
• 不要在Preload中手动添加JOIN，Gorm会根据关联配置自动生成正确的关联查询语句，手动JOIN会破坏原有映射逻辑。
• Count操作需要单独执行，因为Count会强制修改查询的SELECT语句为COUNT(*)，后续的Find需要重新构建查询上下文才能正常获取完整数据。

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