PostgreSQL中FILTER子句是唯一合法的聚合内行级过滤机制，必须写作“AGG() FILTER (WHERE cond)”，括号不可省、不可嵌套、不支持窗口函数或DISTINCT；它筛行而非映射值，空集时除COUNT(*)返回0外均返回NULL。
FILTER 子句不是可选语法糖，而是 PostgreSQL 中唯一合法的「聚合函数内行级过滤」机制——不加 FILTER，就只能靠 CASE WHEN 模拟，但语义不同、易出错、难维护。
为什么直接写 sum(amount WHERE status = 'paid') 会报错？
PostgreSQL 解析器根本不会识别这种写法，直接抛出 syntax error at or near "WHERE"。WHERE 是查询级关键字，不能嵌套进聚合函数参数里。FILTER 是专为此类需求设计的语法修饰子句，必须显式写出且位置严格：
-
FILTER必须紧贴在聚合函数右括号之后，例如sum(amount) FILTER (WHERE status = 'paid') -
FILTER (WHERE ...)的括号不可省略，漏掉就是语法错误 - 不能写成
sum(amount FILTER (WHERE ...))（误当函数参数）或sum(amount) FILTER WHERE ...（缺括号）
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 - 若需默认值（比如空集时显示
0），必须手动包一层：COALESCE(sum(amount) FILTER (WHERE paid), 0) -
FILTER条件中引用的列名，必须来自原始表或当前作用域，不能是SELECT中定义的别名（如HAVING COUNT(*) FILTER (WHERE total > 100)会报错“列不存在”）
真正容易被忽略的，是 FILTER 的执行时机：它发生在 GROUP BY 之后、HAVING 之前。这意味着你不能指望它改变分组逻辑，也不能用它绕过 WHERE 的前置过滤——顺序错了，统计就偏了。
