Beego ORM 的 Count() 用于条件行数统计，需配合 QueryTable() 和 Filter() 等使用，不支持字段参数和 GROUP BY；返回 -1 表示查询失败，常见于模型未注册或表名错误。
Beego ORM 的 Count() 方法怎么用
Beego ORM 的 Count() 不是直接返回总数的“查询函数”，而是一个链式调用的终态方法，必须配合 QueryTable() 和可选的 Filter()/Exclude() 等条件使用。它底层执行的是 SELECT COUNT(*)，但不会返回结果集，只返回 int64 类型的总数。
常见错误是以为能像 SQL 一样写 o.QueryTable("user").Count("id") —— Beego ORM 的 Count() 不接受字段参数，只统计行数（等价于 COUNT(*)）。
-
Count()必须在QueryTable()之后调用，且不能跟All()、One()等其他终态方法混用 - 如果需要带条件统计，用
Filter("status", 1)或Exclude("name__isnull", true)等提前加限制 - 不支持
GROUP BY场景；想按分组统计，得改用Raw()手写 SQL
查总数时为什么 Count() 返回 -1
返回 -1 是 Beego ORM 的错误信号，代表查询执行失败，不是数据为空。最常见原因是模型未注册或表名映射出错。
检查点：
- 确认已调用
orm.RegisterModel(new(User))，且User结构体有orm:"pk"主键标签 - 确认
QueryTable("user")中的字符串和实际数据库表名一致（注意大小写、下划线）；若结构体名是User，默认表名是user，但可通过orm:"table(user_info)"覆盖 - 数据库连接未就绪或超时也会导致
-1，可在调用前加err := o.Raw("SELECT 1").Exec()快速验证连通性
带条件查总数的典型写法
比如统计启用状态的用户数，不要拼 SQL 字符串，用 ORM 链式构建更安全：
o := orm.NewOrm()
var count int64
err := o.QueryTable("user").Filter("status", 1).Count(&count)
if err != nil {
// 处理错误，不是 count == 0
log.Println("count error:", err)
return
}
// count 就是符合条件的行数
注意：Count() 的参数是 *int64，不是 int64；传值会 panic。
- 多个条件用连续
Filter()：.Filter("status", 1).Filter("created__gte", "2024-01-01") - 时间范围推荐用
__gte/__lt，避免手动格式化时间字符串 - 如果条件逻辑复杂（如 OR），优先考虑
Raw()，ORM 对复杂布尔组合支持有限
想查分组后的 Count 怎么办
Beego ORM 原生不支持 GROUP BY + 聚合，Count() 只能做全表或条件行数统计。真要分组统计（比如每个部门的用户数），只能走 Raw()：
o := orm.NewOrm()
var results []map[string]interface{}
_, err := o.Raw("SELECT dept_id, COUNT(*) as cnt FROM user GROUP BY dept_id").Values(&results)
if err != nil {
// handle error
}
// results 是 []map[string]interface{}，需手动类型断言取 cnt
这时候要注意字段别名（如 as cnt）必须小写，且 Values() 返回的是 map，不是结构体；如果要强类型，得自己定义 struct 并用 Raw().QueryRows() + Scan()。
分组场景下，ORM 的便利性基本归零，不如直接写 SQL 清晰可控——这是容易被忽略的边界：别硬套 Count() 去解决它设计之外的问题。
