Gorm如何复用公共查询条件分别执行列表查询与计数查询

你遇到的计数不生效且无报错的情况，核心原因是 GORM 的 *gorm.DB 结构体内部包含 Statement 等引用类型字段，直接对指针解引用做值拷贝属于浅拷贝，两个查询实例会共享内部的查询状态，列表查询添加的 Offset、Limit 参数会被带到计数查询中，最终导致计数结果不符合预期。

下面是两种稳定的公共查询复用方案： #

方法1：使用 Session 方法创建独立会话（官方推荐） #

GORM 内置的 Session 方法可以基于现有查询创建完全独立的查询分支，新会话会完整克隆原查询的所有条件，且后续两个会话的链式操作不会互相影响，是最简便的查询分叉方案：

// 公共查询部分保持不变
common_query_part := app.GetDB().
        Model(&models.Course{}).
        Where("status=?", models.CourseStatusPublished)

// 计数查询：基于公共查询生成独立会话
var total int64
result := common_query_part.Session(&gorm.Session{}).Count(&total)
if result.Error != nil {
    // 处理错误
}

// 列表查询：再生成一个独立会话，追加分页参数
var courses []models.Course
result = common_query_part.Session(&gorm.Session{}).
    Offset(offset).
    Limit(limit).
    Find(&courses)
if result.Error != nil {
    // 处理错误
}

方法2：公共查询封装为函数 #

如果公共查询逻辑需要在多业务场景复用，可以封装为返回 *gorm.DB 的函数，每次调用都会生成全新的查询实例，天然隔离查询状态：

// 封装公共查询逻辑，动态参数可以作为函数入参传入
func getPublishedCourseQuery() *gorm.DB {
    return app.GetDB().
        Model(&models.Course{}).
        Where("status=?", models.CourseStatusPublished)
}

// 执行计数查询
var total int64
result := getPublishedCourseQuery().Count(&total)
if result.Error != nil {
    // 处理错误
}

// 执行列表查询
var courses []models.Course
result = getPublishedCourseQuery().
    Offset(offset).
    Limit(limit).
    Find(&courses)
if result.Error != nil {
    // 处理错误
}

• 禁止直接对 *gorm.DB 做解引用值拷贝，内部引用字段会导致查询状态共享污染
• 所有独立的查询分支都要通过 Session 或者新建查询实例的方式创建，避免链式操作互相影响
• 如果公共查询包含动态筛选条件（比如用户权限过滤），封装函数时可以把动态参数作为入参传入

内容的提问来源于stack exchange，提问作者Noob Coder