postgresql 9.4+ 支持 filter，必须紧贴聚合函数右侧并用括号包裹 where 条件；多个 filter 可并列互不影响，但不可嵌套或用于窗口函数；filter 筛空时 count(*) 返回 0，其余聚合返回 null。
确认数据库版本和兼容性
PostgreSQL 9.4+ 才支持 FILTER，低于该版本或非 PostgreSQL 数据库（如 MySQL、SQL Server、Oracle 26ai 之前）直接执行会报 syntax error at or near "FILTER"。别在 DBeaver 连着 MySQL 实例时复制粘贴 COUNT(*) FILTER (WHERE ...)——它不会“降级运行”，只会失败。
先查版本：SELECT version();。结果里必须明确含 PostgreSQL 9.4 或更高字样，才能继续。阿里云 RDS PostgreSQL、腾讯云 CVM 上的自建实例大多满足；但 RDS MySQL 实例哪怕标称“兼容 PostgreSQL 语法”，也不支持 FILTER。
FILTER 的正确语法位置和括号规则
FILTER 不是函数参数，也不是独立子句，它必须紧贴聚合函数右侧、且完整包裹在括号中。任何位移或省略都会触发解析错误。
- ✅ 正确：
COUNT(*) FILTER (WHERE status = 'paid')、SUM(amount) FILTER (WHERE created_at >= '2024-01-01') - ❌ 错误：
COUNT(*) FILTER WHERE status = 'paid'（缺括号） - ❌ 错误：
COUNT(*) FILTER (WHERE status IN (?))（占位符?不被接受） - ❌ 错误：
AVG(salary FILTER (WHERE salary > 5000))（FILTER写进函数括号内，语法错）
记住：它是“聚合函数 + 空格 + FILTER (WHERE ...)”，中间不能断，括号不能少。
多个 FILTER 并列使用但互不干扰
同一 SELECT 中可为不同聚合分别加 FILTER，它们共享一次表扫描，条件彼此隔离，无需担心覆盖或交叠。
例如统计店铺维度的多维指标：
SELECT shop, COUNT(*) AS total_orders, COUNT(*) FILTER (WHERE status = 'success') AS success_cnt, COUNT(*) FILTER (WHERE status = 'failed') AS failed_cnt, AVG(payment) FILTER (WHERE status = 'success') AS avg_payment_success FROM order_info WHERE created_at >= '2024-01-01' GROUP BY shop;
注意点：
- 所有
FILTER都作用于WHERE后已过滤的数据集，不重复扫描 - 每个
FILTER条件只影响对应聚合，AVG(payment) FILTER (...)不会改变COUNT(*)的分母 - 不能嵌套：
COUNT(*) FILTER (WHERE a) FILTER (WHERE b)直接报错 - 不能用于窗口函数：
AVG(x) FILTER (WHERE y) OVER (...)会提示FILTER is not allowed in window function calls
空结果和 NULL 值的隐含行为
FILTER 筛不出任何行时，多数聚合返回 NULL（COUNT(*) 是例外，返回 0）。这容易被前端误判为“无数据”，实际只是“无匹配行”。
另外，FILTER 的条件若求值为 FALSE 或 NULL（比如 score IS NULL），该行会被彻底排除——不是跳过字段，是整行剔除。
- ⚠️ 危险写法：
AVG(score) FILTER (WHERE score > 60)——score IS NULL的行也被滤掉，可能不符合业务本意 - ✅ 更安全：
AVG(score) FILTER (WHERE score IS NOT NULL AND score > 60) - ✅ 默认兜底：
COALESCE(SUM(amount) FILTER (WHERE paid), 0)显式转0，避免NULL透出
真正容易被忽略的是：它不改变聚合函数自身的 NULL 处理逻辑，只决定哪些行参与计算。用错条件表达式，比写错 CASE WHEN 更难调试，因为没报错，只有结果偏低。
