在 PostgreSQL 中，COALESCE 函数是处理空值（NULL）的核心工具，用于返回参数列表中第一个非空值。其语法为 COALESCE(value1, value2, ..., valueN)，若所有值均为 NULL 则返回 NULL。

一、核心功能与语法

1. 基本用法

SELECT COALESCE(NULL, 'A', 'B');  -- 返回 'A'
SELECT COALESCE(NULL, NULL, 100); -- 返回 100

• 从左到右依次检查参数，返回首个非 NULL 值。
• 所有参数为 NULL 时返回 NULL。

2. 数据类型要求

所有参数必须是兼容的数据类型（如均为文本、数字等），否则需显式转换：

SELECT COALESCE(age::TEXT, 'N/A') FROM users;  -- 将数字转为文本

二、典型应用场景

1. 空值替换（设置默认值）

-- 用户表中，若电话号码为空则显示 '未提供'
SELECT name, COALESCE(phone, '未提供') AS contact 
FROM users;

2. 多字段优先级选择

-- 优先返回邮箱，次选电话，最后用固定值
SELECT COALESCE(email, phone, '无联系方式') AS contact_info 
FROM contacts;

3. 聚合计算中处理 NULL

-- 计算平均销售额，将 NULL 视为 0
SELECT AVG(COALESCE(sales, 0)) AS avg_sales 
FROM orders;

4. 动态生成非空结果

-- 结合条件判断：根据状态显示不同文案 
SELECT order_id, 
         COALESCE(
                 CASE WHEN status = 'shipped' THEN ship_date END,
                 '未发货'
         ) AS delivery_info
FROM orders;

三、与其他函数的对比

注意：
- PostgreSQL 原生不支持 NVL，但可通过 COALESCE 替代 。
- NULLIF 常用于避免除零错误：SELECT 10 / NULLIF(column, 0) FROM table; 。

四、性能与最佳实践

1. 参数顺序优化

将最可能非空的参数放左侧，减少计算量。

-- 优先检查高频字段（如最近更新时间）
SELECT COALESCE(last_update, create_time, '1970-01-01') FROM logs;

2. 避免嵌套过深

参数过多可能影响性能，建议限制在 5 个以内，复杂逻辑改用 CASE 语句。

3. 与 CASE 的取舍

• COALESCE 更简洁，适合直接值替换。
• 含复杂条件时（如范围判断）用 CASE：

SELECT CASE 
                WHEN score >= 90 THEN 'A'
                WHEN score >= 80 THEN 'B'
                ELSE COALESCE(grade, '未评分')
            END
FROM exams;

五、常见错误示例

-- 错误：混合不兼容类型（整数与文本）
SELECT COALESCE(age, 'Unknown');  -- 需显式转换: COALESCE(age::TEXT, 'Unknown')

-- 错误：未处理全 NULL 场景导致意外结果
SELECT COALESCE(NULL, NULL) + 100; -- 返回 NULL 而非 100

六、总结

• 核心价值：COALESCE 是 PostgreSQL 中处理空值的首选函数，提供灵活的多级回退机制 。
• 适用场景：数据清洗、报表默认值、动态字段优先级等。
• 替代方案：简单场景可用 NULLIF，其他数据库迁移时注意 NVL/IFNULL 的语法差异。