GORM 在 SQLite 上执行多对多 Preload 时生成了非法 SQL（含 (a, b) IN ((v1, v2)) 语法），导致解析失败；根本原因是 SQLite 不支持复合列 IN 子句，需改用 OR 条件或绕过 ORM 原生逻辑。
gorm 在 sqlite 上执行多对多 `preload` 时生成了非法 sql（含 `(a, b) in ((v1, v2))` 语法），导致解析失败；根本原因是 sqlite 不支持复合列 in 子句，需改用 `or` 条件或绕过 orm 原生逻辑。
SQLite 引擎不支持 PostgreSQL 风格的行构造器语法，例如：
WHERE (col_a, col_b) IN (('val1', 'val2'))
该语句在 PostgreSQL 中合法，但在 SQLite 中会直接报错 near ",": syntax error——这正是你看到的错误根源。而 GORM（尤其旧版本或跨数据库适配场景）在生成多对多关联表（如 options_specific_needs）的 JOIN 条件时，未针对 SQLite 做语法降级，仍输出了 PostgreSQL 兼容写法。
✅ 正确解决方案
方案一：禁用自动 Preload，手动 JOIN + Raw SQL（推荐）
避免依赖 GORM 的 Preload("SpecificNeeds") 自动生成有问题的 SQL，改用 Select() + Joins() 显式控制查询：
var result struct {
TableClient `gorm:"embedded"`
OptionListID int `gorm:"column:table_option_list_id"`
OptionListName string `gorm:"column:name"`
OptionListValue string `gorm:"column:value"`
}
var results []struct {
TableClient `gorm:"embedded"`
SpecificNeeds []TableOptionList `gorm:"-"` // 手动填充
}
// 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. 手动查关联数据（使用安全的 OR 替代复合 IN）
var optionLists []TableOptionList
err = Db.Table("table_option_lists").
Select("table_option_lists.*").
Joins("INNER JOIN options_specific_needs ON options_specific_needs.table_option_list_id = table_option_lists.id").
Where("options_specific_needs.table_client_id = ? AND options_specific_needs.table_client_facility_id = ?",
dbClient.ID, dbClient.FacilityID).
Find(&optionLists).Error
if err != nil { /* handle */ }
dbClient.SpecificNeeds = optionLists
方案二：升级 GORM 并启用 SQLite 兼容模式（v1.23+）
GORM v1.23.6+ 已修复部分 SQLite 多对多预加载问题。确保使用最新稳定版，并显式配置：
import "gorm.io/driver/sqlite"
db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{
NowFunc: func() time.Time { return time.Now().UTC() },
})
// 同时建议关闭自动迁移中的复杂约束（SQLite 支持有限）
db.AutoMigrate(&TableClient{}, &TableOptionList{})
⚠️ 注意：即使升级，仍建议避免在 SQLite 中依赖
Preload复合主键关联——因FacilityID是string类型主键，而TableClient缺少ID uint字段，GORM 可能误判联合主键行为。请补充ID字段并设为真正主键：type TableClient struct { ID uint `gorm:"primaryKey"` FacilityID string `gorm:"index"` // 改为唯一索引，非 primary_key // ... 其他字段 }
方案三：临时降级为 Raw SQL（最可控）
当需快速验证或兼容性要求极高时，直接使用 db.Raw()：
var specificNeeds []TableOptionList
err := Db.Raw(`
SELECT ol.* FROM table_option_lists ol
INNER JOIN options_specific_needs osn
ON ol.id = osn.table_option_list_id
WHERE osn.table_client_id = ? AND osn.table_client_facility_id = ?
`, dbClient.ID, dbClient.FacilityID).Scan(&specificNeeds).Error
✅ 总结
-
根本原因：SQLite 不支持
(a,b) IN ((x,y))行值表达式，GORM 未做方言适配； -
首选实践：对复杂关联查询，优先使用显式
Joins+Where，而非盲目依赖Preload； - 长期建议：统一数据库选型（如全栈用 PostgreSQL），或在 SQLite 场景下精简关联深度，避免多对多嵌套预加载；
-
调试技巧：启用 GORM 日志查看真实 SQL：
gorm.Config{Logger: logger.Default.LogMode(logger.Info)}。
通过以上任一方案，即可彻底规避 SQLite 下的多对多预加载语法错误，保障双数据库切换的稳定性。
