本文详解 gorm 与 gin 集成时查询多个数据库记录并序列化为 json 的常见错误与正确写法，重点解决因结构体指针误用导致仅返回单条数据的问题。
本文详解 gorm 与 gin 集成时查询多个数据库记录并序列化为 json 的常见错误与正确写法，重点解决因结构体指针误用导致仅返回单条数据的问题。
在使用 GORM 与 Gin 构建 RESTful API 时，一个高频误区是：调用 db.Find(&struct{}) 试图获取多条记录，却只得到单个对象（甚至可能是第一条或零值）。根本原因在于——GORM 的 Find() 方法行为取决于传入参数的类型：
- 若传入
*model.Person（单个结构体指针），GORM 默认按主键查找一条记录（等价于First()）； - 若传入
*[]model.Person（切片指针），GORM 才会执行全表查询并填充整个切片。
原始代码的问题正在于此：
var users = db.Find(&models.Person{}) // ❌ 传入单结构体指针 → 只查1条
✅ 正确做法是：声明一个目标切片，并传递其地址：
func GetUsers(c *gin.Context) {
var users []models.Person // 声明空切片（非指针）
if err := db.Find(&users).Error; err != nil {
c.JSON(500, gin.H{"error": "failed to fetch users", "details": err.Error()})
return
}
c.JSON(200, users) // 注意：此处可直接传 users（切片值），Gin 会自动序列化
}
? 关键细节说明：
-
db.Find(&users)中的&users是*[]models.Person类型，GORM 识别后执行SELECT * FROM persons； - 切片
users必须预先声明为[]models.Person（零值为空切片），不可用var users *[]models.Person（这是指向切片的指针，GORM 不支持）； - 建议始终检查
db.Find(...).Error，避免静默失败； -
c.JSON(200, users)中直接传切片值即可（users是值类型，但 Go 切片本身包含底层数组指针，序列化无性能问题）；传&users亦可，但非必需。
? 进阶提示：若需分页、字段过滤或关联预加载，推荐改用更明确的链式方法：
db.Where("status = ?", "active").Order("created_at DESC").Find(&users)
// 或预加载关联字段
db.Preload("Profile").Find(&users)
总结：GORM 的 Find() 方法不是“万能查询”，其语义高度依赖接收参数的类型。务必用 []T{} + &slice 模式查询列表，避免因类型误用导致数据丢失——这是 Gin + GORM 开发中最易踩坑的底层细节之一。
