GORM 在 SQLite 上执行多对多 Preload 时，会生成含 (col1, col2) IN ((val1, val2)) 的非法 SQL，而 SQLite 不支持元组形式的 IN 条件，导致语法错误；本文提供兼容 PostgreSQL 和 SQLite 的安全预加载方案。
gorm 在 sqlite 上执行多对多 `preload` 时，会生成含 `(col1, col2) in ((val1, val2))` 的非法 sql，而 sqlite 不支持元组形式的 `in` 条件，导致语法错误；本文提供兼容 postgresql 和 sqlite 的安全预加载方案。
GORM 的 Preload 对于 many2many 关系，在不同数据库后端的行为存在差异。问题核心在于：SQLite 不支持标准 SQL 中的行值构造器（row value constructor）语法，例如 WHERE (a, b) IN ((1, 'x'), (2, 'y'))，而 GORM v1.23+（尤其在复合主键或自定义外键场景下）可能生成此类语句——这在 PostgreSQL 中合法，但在 SQLite 中直接报错 near ",": syntax error。
在你的模型中，TableClient 的主键是 FacilityID string（gorm:"primary_key"），但 GORM 默认为 many2many 关联表（options_specific_needs）生成两个外键字段：table_client_id（对应 TableClient.ID）和 table_client_facility_id（尝试映射 FacilityID）。由于你未显式声明 FacilityID 为 ID 字段，GORM 可能误判主键结构，进而生成含 (table_client_id, table_client_facility_id) 的复合条件，触发 SQLite 语法不兼容。
✅ 推荐解决方案：显式配置关联关系 + 使用 JoinTable 自定义外键
type TableClient struct {
Model
Synchronised bool
FacilityID string `gorm:"primaryKey"` // ✅ 明确标记为复合主键字段（若仅此为主键，应设为单主键）
Age int
ClientSexID int
MaritalStatusID int
SpecificNeeds []TableOptionList `gorm:"many2many:options_specific_needs;joinForeignKey:FacilityID;joinReferences:OptionListID"`
}
type TableOptionList struct {
ID int `gorm:"primaryKey"`
Name string
Value string
Text string
SortKey int
}
// 关联表需显式定义（可选，但强烈建议）
type OptionsSpecificNeeds struct {
FacilityID string `gorm:"primaryKey"`
OptionListID int `gorm:"primaryKey"`
}
⚠️ 注意：SQLite 不支持真正的复合主键约束（虽可声明，但行为受限），因此更稳妥的做法是将
FacilityID设为唯一主键，并确保业务层逻辑一致性。若必须保留FacilityID作为唯一标识，应在迁移中添加唯一索引：db.Migrator().CreateIndex(&TableClient{}, "idx_facility_id")
✅ 替代方案：手动预加载（跨数据库兼容性最高）
当 Preload 不可靠时，采用两步查询 + 内存关联：
// 1. 查询主记录
var dbClient TableClient
err := db.Where("facility_id = ? AND client_id = ? AND id = ?",
URLFacilityID, URLClientID, URLIncidentID).First(&dbClient).Error
if err != nil { /* handle */ }
// 2. 手动查多对多关联项（使用标准 WHERE AND）
var optionIDs []int
err = db.Table("options_specific_needs").
Where("facility_id = ?", dbClient.FacilityID).
Pluck("option_list_id", &optionIDs).Error
if err != nil { /* handle */ }
// 3. 查选项详情
var specificNeeds []TableOptionList
if len(optionIDs) > 0 {
db.Where("id IN ?", optionIDs).Find(&specificNeeds)
}
dbClient.SpecificNeeds = specificNeeds
? 关键总结：
- ❌ 避免依赖 GORM 自动生成的复合键
IN条件（SQLite 不支持）； - ✅ 优先通过
joinForeignKey/joinReferences显式控制关联字段； - ✅ 在多数据库兼容场景下，手动分步查询比强依赖
Preload更健壮； - ? 若坚持用
Preload，可临时降级 GORM 版本（v1.21.x 前对 SQLite 的many2many处理更保守），但长期仍建议重构关联逻辑。
最后，该问题已存在于 GORM GitHub Issues（如 #5827），社区正在推动 SQLite 方言层对行值语法的兼容性补丁。
