xorm 框架中聚合函数通过 session 对象提供的 sum() 和 avg() 方法调用,直接对数据库字段进行计算并返回结果。使用时无需手动编写 sql 语句,只需指定目标模型和要计算的列名即可获取数值。若查询结果为空或无匹配行,默认返回零值(如 0.0),不会报错。

如何正确调用 Sum 获取单列总和
调用 Sum() 时传入模型实例和列名字符串,XORM 会自动生成 SUM(column) 查询并解析到对应类型。例如对 User 模型的 Age 字段求和,返回值为 float64 类型,即使原字段是整数也会自动转换。该方法支持链式调用 Where() 来限定范围,确保只统计符合条件的数据。

package main
import (
"fmt"
"xorm.io/xorm"
_ "xorm.io/xorm/drivers/mysql_driver"
)
type User struct {
ID int64
Name string
Age int
}
func main() {
engine, err := xorm.NewEngine("mysql", "root:root@tcp(127.0.0.1:3306)/test")
if err != nil { panic(err) }
defer engine.Close()
// 假设表中已有数据:ID=1,Name="Alice",Age=25; ID=2,Name="Bob",Age=30
var sum float64
sum, err = engine.Sum(&User{}, "Age")
if err != nil { panic(err) }
fmt.Printf("Total Age: %.2f\n", sum) // 输出: Total Age: 55.00
}
上述代码在 MySQL 环境下运行,预期输出为 Total Age: 55.00,类型为 float64。若表中无数据,sum 将为 0.0,不触发错误。列名必须与结构体标签或字段名一致,否则可能返回零值或引发 SQL 错误。
如何正确使用 Avg 计算平均值并处理精度
Avg() 方法与 Sum() 用法相同,但返回的是算术平均值。由于浮点数精度问题,建议将结果格式化为两位小数用于展示。当参与计算的列为 NULL 时,XORM 会忽略该行,仅对非空值求平均。若所有值均为 NULL 或无数据,同样返回 0.0。

package main
import (
"fmt"
"xorm.io/xorm"
_ "xorm.io/xorm/drivers/mysql_driver"
)
type Product struct {
ID int64
Price float64
Stock int
}
func main() {
engine, err := xorm.NewEngine("mysql", "root:root@tcp(127.0.0.1:3306)/test")
if err != nil { panic(err) }
defer engine.Close()
// 假设表中已有数据:ID=1,Price=10.5; ID=2,Price=20.0; ID=3,Price=NULL
var avg float64
avg, err = engine.Avg(&Product{}, "Price")
if err != nil { panic(err) }
fmt.Printf("Avg Price: %.2f\n", avg) // 输出: Avg Price: 15.25
}
该程序在 MySQL 中执行,预期输出为 Avg Price: 15.25,因为 NULL 值被排除,仅对 10.5 和 20.0 求平均。若所有价格均为 NULL,则输出 0.00。注意:Stock 字段未参与计算,不影响结果。返回值始终为 float64,便于后续数学运算。
当聚合列包含 NULL 值时 Sum 和 Avg 的行为差异是什么
在同一个程序中,若某列存在 NULL 值,Sum() 会跳过这些行继续累加有效值,而 Avg() 不仅跳过 NULL,还会因分母减少导致平均值变化。例如,若 Age 列有 [25, 30, NULL],Sum 仍为 55,但 Avg 变为 27.5 而非 18.33(后者是含 NULL 的误算)。这种差异源于 SQL 标准行为:聚合函数天然忽略 NULL,但不改变其他值的贡献权重。











