当 PostgreSQL 的 WHERE column = ANY(?) 子句接收空数组时，默认不匹配任何行；本文介绍如何通过 COALESCE(NULLIF(...)) 组合，使空列表自动退化为全量查询，并兼顾 NULL 值匹配的特殊场景。
当 postgresql 的 `where column = any(?)` 子句接收空数组时，默认不匹配任何行；本文介绍如何通过 `coalesce(nullif(...))` 组合，使空列表自动退化为全量查询，并兼顾 null 值匹配的特殊场景。
在动态前端过滤场景（如用户多选子分类标签）中，后端常将选中的值拼入 SQL 的 ANY 子句：
SELECT * FROM "table" WHERE "column" = ANY(ARRAY['cat1', 'cat2']);
但若用户未选择任何标签，前端传入空数组 ARRAY[]::text[]，则原查询等价于：
WHERE "column" = ANY('{}'::text[]); -- 永远为 FALSE，无结果返回
解决方案：用 COALESCE(NULLIF(...)) 实现“空则全量”语义
核心思路是——当输入数组为空时，将其替换为一个能保证恒真匹配的表达式。PostgreSQL 中最简洁的方式是让 ANY 作用于仅含目标列自身的单元素数组，即 ANY(ARRAY["column"])，这等价于 "column" = "column"（对非 NULL 行恒成立）：
PostgreSQL 18.4 官方 Ubuntu 安装包现已发布，这是目前最新的稳定版本。推荐通过官方 APT 仓库安装：先执行 sudo apt update 更新索引，再运行 sudo apt install postgresql-18 即可完成部署。新版本引入了异步 I/O 子系统，在顺序扫描与 VACUUM 场景下性能提升显著，同时支持 UUID v7 原生生成函数与虚拟生成列。
SELECT *
FROM "table"
WHERE "column" = ANY(
COALESCE(
NULLIF(
{{ $state.categoriesBadge.filter(item => item.isSelected).map(item => item.value) }},
'{}'::text[] -- 显式声明空文本数组
),
ARRAY["column"] -- 空时 fallback：生成 [column] 数组
)
);
✅ 工作原理：
- 若前端传入非空数组（如 {'A','B'}），NULLIF(..., '{}') 返回原数组，COALESCE 保留它 → 正常按 ANY 过滤；
- 若传入空数组 '{}'::text[]，NULLIF 返回 NULL，COALESCE 捕获并替换为 ARRAY["column"] → 条件变为 "column" = ANY(ARRAY["column"])，对所有 column IS NOT NULL 的行成立。
⚠️ 重要限制：NULL 值无法被 = 匹配
由于 ANY 内部使用 = 比较，而 NULL = NULL 结果为 UNKNOWN（非 TRUE），因此即使数组中包含 NULL 或 column 本身为 NULL，这些行永远不会被返回。
如需支持 NULL 匹配（例如允许用户显式筛选 “未分类” 即 NULL 值），应改用 array_position()：
SELECT *
FROM "table"
WHERE array_position(
COALESCE(
NULLIF(
{{ $state.categoriesBadge.filter(item => item.isSelected).map(item => item.value) }},
'{}'::text[]
),
ARRAY["column"]
),
"column"
) IS NOT NULL;
array_position(arr, elem) 使用 IS NOT DISTINCT FROM 语义，天然支持 NULL 安全比较：array_position(ARRAY[NULL], NULL) 返回 1，而非 NULL。
? 总结建议：
- 优先使用 COALESCE(NULLIF(...)) + ANY 方案，简洁高效，适用于绝大多数非 NULL 场景；
- 若业务明确需要处理 NULL 分类（如 subcategory IS NULL 视为有效选项），务必切换至 array_position(...) IS NOT NULL；
- 始终对前端注入的数组做类型显式转换（如 ::text[]），避免隐式转换错误；
- 在应用层可预判空数组并跳过 WHERE 子句，但服务端统一处理更健壮、减少分支逻辑。
