直接写sum(amount WHERE status = 'paid')会报错，因为WHERE是查询级关键字，不能嵌入聚合函数参数；FILTER是PostgreSQL专为条件聚合设计的语法，必须紧贴聚合函数右括号后使用，如sum(amount) FILTER (WHERE status = 'paid')。
FILTER子句不是可选语法糖，而是PostgreSQL中唯一合法的聚合内行级过滤机制——不用它，就得靠CASE WHEN硬凑，但语义错、易出错、难维护。
为什么直接写 sum(amount WHERE status = 'paid') 会报错？
PostgreSQL 解析器根本不会识别这种写法，直接抛出 syntax error at or near "WHERE"。WHERE 是查询级关键字，不能塞进聚合函数参数里。FILTER 是专为此类需求设计的语法修饰子句，必须显式写出且位置严格：sum(amount) FILTER (WHERE status = 'paid')。
-
FILTER必须紧贴在聚合函数右括号之后，不能当函数参数（如sum(amount FILTER (WHERE ...))） - 括号
(WHERE ...)不可省略，漏掉就是语法错误 - 不能出现在
WHERE、GROUP BY或HAVING中——只允许在SELECT列表或HAVING的聚合表达式里使用
怎么避免 FILTER 和 CASE WHEN 的语义混淆？
关键区别在于：FILTER 筛行，CASE WHEN 映射值。这对结果影响真实存在，不是风格偏好。
-
avg(score) FILTER (WHERE score > 60)：只用 >60 的非-NULL 行参与计算，分母是这些行数 -
avg(CASE WHEN score > 60 THEN score ELSE 0 END)：所有行都参与，不满足条件的全变成 0，均值被严重拉低 -
string_agg(name, ', ') FILTER (WHERE active)：天然跳过active = false或name IS NULL的行，不会产生多余逗号 -
count(*) FILTER (WHERE flag)和count(CASE WHEN flag THEN 1 END)效果一致，但前者无缩进、无分支歧义
哪些组合会直接触发解析失败？
PostgreSQL 对 FILTER 有硬性限制，踩中任意一条就拒绝执行：
-
FILTER不能和窗口函数共存：sum(sales) FILTER (WHERE region = 'US') OVER (PARTITION BY year)→ 报错FILTER is not allowed in window function calls -
FILTER不支持嵌套：count(*) FILTER (WHERE a) FILTER (WHERE b)→ 语法错误 -
FILTER不能用于COUNT(DISTINCT col)：COUNT(DISTINCT id) FILTER (WHERE active)→ 直接不通过解析 -
FILTER条件中不能含子查询、ORDER BY、参数占位符（如$1或?）
空结果和 NULL 值怎么处理才安全？
FILTER 筛完没剩下任何行时，多数聚合返回 NULL（COUNT(*) 是例外，返回 0）。这容易在报表或 API 返回中被前端误判为“无数据”，实际只是“无匹配”。更隐蔽的是字段本身为 NULL：
-
avg(score) FILTER (WHERE score > 60)：会把score IS NULL的整行滤掉——如果你本意是“只过滤低分”，就得显式写成WHERE score IS NOT NULL AND score > 60 -
COUNT(*) FILTER (WHERE false)→0；SUM(amount) FILTER (WHERE false)→NULL；AVG()同样返回NULL - 需要默认值时，必须用
COALESCE(SUM(amount) FILTER (WHERE paid), 0)显式兜底
最容易被忽略的一点是：FILTER 不改变外层扫描范围，它只在每组内做二次筛选。WHERE 先过滤、GROUP BY 分组、FILTER 再筛行、HAVING 最后过滤结果——顺序错了，统计就偏了。
