GORM 默认的 many2many 关联会按约定生成如 reviews_group_id 和 auth_user_id 的外键列名，但面对已有数据库中使用 group_id/user_id 等非默认命名的中间表时，需显式指定外键映射关系，否则查询将因列不存在而失败。
gorm 默认的 many2many 关联会按约定生成如 `reviews_group_id` 和 `auth_user_id` 的外键列名，但面对已有数据库中使用 `group_id`/`user_id` 等非默认命名的中间表时，需显式指定外键映射关系，否则查询将因列不存在而失败。
在 GORM 中实现与现有数据库 schema 兼容的多对多（many2many）关联，关键在于绕过 GORM 对中间表字段名的默认推导逻辑，转而通过显式声明外键和关联键来精准控制 SQL 生成行为。你遇到的错误 column reviews_group_users.reviews_group_id does not exist 正是因为 GORM 尝试访问不存在的 reviews_group_id 字段——它未识别到你的中间表实际使用的是 group_id 和 user_id。
✅ 正确做法是：不依赖 many2many 标签的自动推导，而是采用“显式中间模型 + 外键注解”的方式，即定义一个结构体代表中间表（如 ReviewsGroupUser），并分别在主模型中建立一对多关系。这种方式完全可控、语义清晰，且兼容任意字段命名。
以下是推荐的重构方案：
// 中间表模型（对应数据库表 reviews_group_users）
type ReviewsGroupUser struct {
ID uint `gorm:"primaryKey"`
GroupID uint `gorm:"column:group_id;not null"` // 显式映射到数据库列名
UserID uint `gorm:"column:user_id;not null"`
// 可选：添加 createdAt 等审计字段
}
// 主模型：用户
type AuthUser struct {
ID *int `gorm:"primaryKey"`
Username *string `sql:"size:30"`
FirstName *string `sql:"size:30"`
LastName *string `sql:"size:30"`
Email *string `sql:"size:75"`
IsActive *bool
IsStaff *bool
IsSuperuser *bool
DateJoined *time.Time
LastLogin *time.Time
// 关联：一个用户属于多个 ReviewGroup（通过中间表）
ReviewsGroups []ReviewsGroup `gorm:"many2many:reviews_group_users;joinForeignKey:UserID;joinReferences:ID"`
}
// 主模型：分组
type ReviewsGroup struct {
ID uint `gorm:"primaryKey"`
Name string `gorm:"size:100"`
// 可选：反向关联（若需要）
Users []AuthUser `gorm:"many2many:reviews_group_users;joinForeignKey:GroupID;joinReferences:ID"`
}? 关键标签说明：
- many2many:reviews_group_users：指定中间表名（必须与 DB 表名一致）；
- joinForeignKey:UserID：表示该模型（AuthUser）在中间表中的外键字段名为 user_id；
- joinReferences:ID：表示 AuthUser 主键字段为 ID（注意：你的原始结构中 ID 是 *int，建议改为 uint 或 int 并设为主键，GORM 对指针主键支持有限且易出错）；
- 同理，ReviewsGroup 中用 joinForeignKey:GroupID 映射 group_id。
? 使用示例（预加载分组）：
func (app *AppEnv) FindAuthUser(username string) (*AuthUser, error) {
var user AuthUser
err := app.DB.Preload("ReviewsGroups").Where("username = ?", username).First(&user).Error
return &user, err
}此调用将生成正确的 JOIN 查询，引用 reviews_group_users.user_id 和 reviews_group_users.group_id，彻底避免列名错误。
⚠️ 注意事项：
- 避免混用旧版 GORM v1 标签（如 foreignkey/associationforeignkey），它们在 GORM v2+ 中已废弃，应统一使用 joinForeignKey / joinReferences；
- 若仍使用 GORM v1，请改用 gorm:"many2many:reviews_group_users;foreignKey:user_id;associationForeignKey:group_id"（注意字段名大小写与 DB 严格一致）；
- 建议将 ID 字段类型从 *int 改为 uint 或 int，并添加 gorm:"primaryKey" 标签，确保主键行为稳定；
- 中间表结构体（如 ReviewsGroupUser）非必需，仅当你需要操作中间表数据（如添加时间戳、状态字段）时才定义；纯关联场景下可省略，仅靠 many2many 标签 + 正确外键配置即可。
通过显式控制外键映射，你既能无缝对接遗留数据库，又能保持 GORM 的链式操作与预加载能力，是生产环境处理自定义 join 表的最佳实践。
