GORM不支持i18n字段原生分页，需用LEFT JOIN+COALESCE显式查询并fallback默认语言，避免Preload/INNER JOIN导致漏数据或计数不准，且须手动为(product_id,lang_code)建联合索引。
直接上结论：GORM 本身不提供国际化（i18n）字段的原生分页检索能力，必须靠手动拼接语言条件 + SELECT 显式指定多语言字段 + JOIN 或子查询实现，否则会漏数据或查错行。
为什么 GORM 的 Find 和 Limit/Offset 不能直接用于多语言商品表？
常见错误是把商品主表（products）和翻译表（product_i18n）当成一对普通关联来处理。GORM 的 Preload 或 Joins 在分页时极易出问题：
-
Preload会先查主表再查翻译表，但Limit是作用在主表结果上的，导致“只加载了前 N 条商品的翻译”，而实际要展示的是“前 N 条含指定语言的完整商品” -
Joins默认是INNER JOIN，如果某商品缺失目标语言（比如lang_code = 'zh'）的翻译记录，整条商品就直接被过滤掉，而不是 fallback 到默认语言 - GORM 的
Count方法对带JOIN的查询统计总数时，可能因重复行或 NULL 导致计数不准
正确做法：用 Joins + SELECT + COALESCE 构建单次查询
核心思路是：把语言字段显式 SELECT 出来，并用 COALESCE fallback 到默认语言（如 'en'），避免空值。GORM 支持原生 SQL 表达式，但需注意字段别名和类型映射。
假设表结构为：
products (id, sku, created_at) product_i18n (product_id, lang_code, name, description)
对应 Go 结构体：
type ProductI18n struct {
ProductID uint `gorm:"primaryKey;column:product_id"`
LangCode string `gorm:"primaryKey;column:lang_code"`
Name string
Description string
}
分页检索中文商品的推荐写法：
var results []struct {
ID uint `gorm:"column:id"`
SKU string `gorm:"column:sku"`
Name string `gorm:"column:name"`
Description string `gorm:"column:description"`
CreatedAt time.Time
}
err := db.Table("products").
Select("products.*, COALESCE(zh.name, en.name) AS name, COALESCE(zh.description, en.description) AS description").
Joins("LEFT JOIN product_i18n zh ON products.id = zh.product_id AND zh.lang_code = ?", "zh").
Joins("LEFT JOIN product_i18n en ON products.id = en.product_id AND en.lang_code = ?", "en").
Order("products.created_at DESC").
Limit(20).
Offset(0).
Find(&results).Error
- 两个
LEFT JOIN确保商品不丢失，即使没中文翻译也能 fallback 到英文 -
COALESCE是数据库函数，不是 GORM 特性，必须写进Select字符串里 - 不要用
Preload替代 —— 它无法控制JOIN类型和 fallback 逻辑 - 如果默认语言固定，可把
en换成硬编码值；若需动态，建议封装成函数生成 SQL 片段
分页总数统计必须单独写 Count 查询
db.Count() 对上面带 JOIN 的语句不可靠，因为 COALESCE 不影响行数，但 JOIN 可能引入冗余行（虽然这里是 LEFT JOIN 且主键关联，通常不会）。稳妥做法是单独统计主表：
var total int64
db.Model(&Product{}).Count(&total)
或者更精确地模拟业务逻辑（比如只统计有任一语言翻译的商品）：
db.Table("products").
Joins("INNER JOIN product_i18n ON products.id = product_i18n.product_id").
Where("product_i18n.lang_code IN (?)", []string{"zh", "en"}).
Count(&total)
- 别依赖
db.Scopes(...).Count()复用分页查询逻辑 —— GORM 的Count会忽略Select和Joins中的别名和表达式，容易错 - 如果产品允许无任何翻译（即
product_i18n为空），那主表COUNT才是真实总数
最易被忽略的一点：数据库索引必须覆盖 (product_id, lang_code) 组合，否则 LEFT JOIN 在大数据量下会极慢。GORM 的 AutoMigrate 不会自动为翻译表建这个联合索引，得手动加。
