SQLite min 与 max 的参数个数：多写一个值，为什么汇总结果变成了逐行结果
原查询用 max(v) 求整张表的最大值。为了让结果至少为五，维护者顺手改成 max(v, 5)，结果接口突然收到三行。这里多出来的实参改变了函数类别：SQLite 的 min 和 max 在只有一个实参时进行聚合，两个或更多实参时则作为普通标量函数，在当前表达式里比较各个值。
先不要从结果中取第一行来掩盖变化。下面建立只有三个样本的内存数据库，数值分别是二、九和空值；同时比较数值、行数与空输入。将完整代码保存为 demo.py，使用 python demo.py 执行，无需现成数据库文件。本例实际连接的 SQLite 版本为3.53.1。
AI生成概念插图：左侧多行合成一个结果，右侧每行分别与一个值比较，表示两种函数调用范围；不是软件界面或运行截图。
import sqlite3
db = sqlite3.connect(":memory:")
try:
db.execute("CREATE TABLE sample(id INTEGER PRIMARY KEY, v INTEGER)")
db.executemany("INSERT INTO sample VALUES(?, ?)",
[(1, 2), (2, 9), (3, None)])
aggregate = db.execute("SELECT min(v), max(v) FROM sample").fetchall()
scalar = db.execute(
"SELECT id, min(v, 5), max(v, 5) FROM sample ORDER BY id"
).fetchall()
combined = db.execute("SELECT max(min(v, 5)) FROM sample").fetchall()
empty_aggregate = db.execute(
"SELECT min(v), max(v) FROM sample WHERE 0"
).fetchall()
empty_scalar = db.execute(
"SELECT min(v, 5), max(v, 5) FROM sample WHERE 0"
).fetchall()
assert aggregate == [(2, 9)]
assert scalar == [(1, 2, 5), (2, 5, 9), (3, None, None)]
assert combined == [(5,)]
assert empty_aggregate == [(None, None)]
assert empty_scalar == []
print("aggregate:", aggregate)
print("scalar:", scalar)
print("combined:", combined)
print("empty:", empty_aggregate, empty_scalar)
finally:
db.close()函数名相同，计算范围已经不同
aggregate 输出 [(2, 9)]，整张表的非空值被收敛成一行最小值与最大值。scalar 则保留三条样本的位置，每行分别把 v 与五比较。第一行得到二和五，第二行得到五和九。这里的五参与每次行内比较，既不是默认值，也不是要求整个查询只返回一条记录的标记。
所以，想求所有值的最大值后再设置下限，应明确先聚合、再与常量比较，例如把 max(v) 作为一个子查询结果，在外层做双参数比较。想先把每一条记录截到上限再汇总，则应倒过来安排两层。设计查询时先把这两句话写清楚，比只看函数嵌套是否短更可靠。
空值不能按同一种规则解释
第三条样本的两个标量结果都是空值，在 Python 中显示为 None。单参数聚合会跳过空输入值，但不能据此推断多参数调用也会从其他实参中挑一个非空值。若缺失需要默认五，应先确定业务规则，再使用合适的空值处理表达式；把缺失默认为零可能改变真正的最小值。
combined 查询先逐行计算 min(v, 5)，得到二、五和空值，再由外层单参数 max 汇总成五。这个例子中的每一层都有独立角色：内层是两个实参的标量函数，外层是一个实参的聚合函数。不要把函数嵌套本身误读为两次聚合，更不要只靠括号数量判断查询类型。
WHERE 0 故意让输入为空。没有 GROUP BY 的聚合查询仍返回一行，两项都是 None；逐行标量查询则返回空列表，因为根本没有行可计算。这一区别会直接影响接口的“无数据”处理：一行空字段与零行记录需要分别验收，不能只测试有正常数值的情况。
本例限定整数与空值，避免把文本排序规则混进来。真实列混有数字形状的文本时，比较还会涉及存储类型与排序规则；多参数函数的文本比较规则也要另查官方说明。先统一数据含义，再写聚合范围，最后断言返回形状，才能避免一个看似无害的额外参数改掉整个接口契约。
资料核对日期：2026年10月2日（北京时间）。示例在本地CPython 3.12.14实际运行并通过断言，结果对应文中固定输入。
