GORM Preload异常：查询被错误添加WHERE (1 <> 1)条件无结果

我定义了如下User和Role结构体，二者通过user_roles_map表实现多对多关联：

type User struct {
    ID                   uuid.UUID `gorm:"type:uuid;primary_key;"`
    ...
    Roles                []*Role `gorm:"many2many:user_roles_map"`
}

func (User) TableName() string {
    return "user"
}

type Role struct {
    ID       int64 `gorm:"type:bigserial;primaryKey"`
    RoleName string
    Users    []*User `gorm:"many2many:user_roles_map"`
}

func (Role) TableName() string {
    return "role"
}

但当我使用db.Preload("Roles")预加载关联时，生成的查询语句带有WHERE (1 <> 1)条件，导致无结果返回：

SELECT * FROM "role" INNER JOIN "user_roles_map" ON "user_roles_map"."role_id" = "role"."id" WHERE (1 <> 1)

我尝试手动为Preload添加条件：

db.Debug().Preload("Roles", func(d *gorm.DB) *gorm.DB {     
    return d.Where("user_id = ?", id)    
}).First(&user, "id = ?", id)

此时生成的查询虽包含正确条件，但仍保留WHERE (1 <> 1)，导致查询失效：

SELECT * FROM "role" INNER JOIN "user_roles_map" ON "user_roles_map"."role_id" = "role"."id" WHERE (user_id = '00000000-0000-0000-0000-000000000000') AND (1 <> 1)

请问我哪里操作有误，为何这个无效条件会持续出现在预加载查询中？

原因分析 #

出现WHERE (1 <> 1)的核心原因主要有两种：

1. 主查询未获取到有效记录：当First(&user, "id = ?", id)没有查到对应的用户时，GORM判定没有需要关联的主数据，会自动生成1 <> 1的条件直接返回空结果集，避免无效的关联查询。
2. 多对多关联配置不明确/类型不匹配：GORM自动推断外键时，可能因结构体ID类型（如User的uuid.UUID）与关联表字段类型不匹配，或关联标签未明确指定外键规则，导致关联逻辑出错，进而生成无效条件。

解决步骤 #

1. 验证主查询结果
   先单独执行主查询，确认能获取到有效用户：

   var user User
   if err := db.First(&user, "id = ?", id).Error; err != nil {
       // 处理用户不存在的情况
       return err
   }
   

   如果用户不存在，预加载自然不会有结果，此时1 <> 1是GORM的合理优化。

2. 明确指定多对多关联的外键标签
   修改结构体的关联标签，明确关联表的外键与引用键，避免GORM自动推断出错：

   type User struct {
       ID                   uuid.UUID `gorm:"type:uuid;primary_key;"`
       ...
       Roles                []*Role `gorm:"many2many:user_roles_map;joinForeignKey:user_id;joinReferences:role_id"`
   }
   

   type Role struct {
       ID       int64 `gorm:"type:bigserial;primaryKey"`
       RoleName string
       Users    []*User `gorm:"many2many:user_roles_map;joinForeignKey:role_id;joinReferences:user_id"`
   }
   

3. 检查关联表字段类型
   确保user_roles_map表的user_id字段为uuid类型，role_id为bigint类型，与结构体中ID的类型完全匹配，避免类型不匹配导致的关联失败。

4. 移除手动添加的冗余条件
   正常情况下，GORM会自动根据主查询的用户ID关联user_roles_map表，无需手动在Preload中添加user_id = ?的条件，冗余条件可能与GORM自动生成的逻辑冲突。

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