SQL Server 2019 使用 STRING_AGG 必须配合 GROUP BY，显式声明 WITHIN GROUP 排序，NULL 值默认跳过但全组 NULL 返回 NULL，不支持去重（需子查询），动态分隔符需预处理。

SQL Server 2019 完全支持 STRING_AGG，但直接套用会出错——常见问题不是函数不存在，而是漏了 GROUP BY、排序未声明、或 NULL 值处理不当。

必须配合 GROUP BY，否则逻辑失效

STRING_AGG 是聚合函数，不是字符串工具。单独写 SELECT STRING_AGG(name, ', ') 会把整张表压成一行，丢失原始分组意图。

• 错误写法：SELECT STRING_AGG(name, ', ') FROM users; → 所有用户被拼成一条，无法区分部门/类别
• 正确写法：按业务维度分组，比如按 dept 合并员工名：SELECT dept, STRING_AGG(name, ', ') AS members FROM users GROUP BY dept;
• 若真要全表拼接（极少见），也得显式写 GROUP BY () 或加常量分组，例如：SELECT STRING_AGG(name, ', ') FROM users GROUP BY 1;

排序必须显式声明，WITHIN GROUP 不可省略

不写 WITHIN GROUP，输出顺序是未定义的——哪怕数据插入有序，查询结果也可能乱序。

• 正确语法：STRING_AGG(name, ', ') WITHIN GROUP (ORDER BY sort_order ASC)
• 不能写成：STRING_AGG(name, ', ') ORDER BY sort_order（语法错误）
• 推荐始终带上排序，哪怕只是 ORDER BY id，避免结果不可重现
• 多字段排序也支持：WITHIN GROUP (ORDER BY status DESC, updated_at DESC)

NULL 值默认跳过，但整组为 NULL 时返回 NULL

STRING_AGG 对 NULL 安静忽略，不会插空字符串，也不会报错；但如果某组所有值都是 NULL，函数返回 NULL，不是空字符串。

• 想把 NULL 显式转成占位符：STRING_AGG(ISNULL(name, '[missing]'), ', ')
• 想确保结果不为 NULL（比如报表字段不能为空）：COALESCE(STRING_AGG(name, ', '), '')
• 注意：ISNULL 是 SQL Server 特有，跨数据库迁移时建议用 COALESCE
• 别依赖 NULLIF 处理空值，它用途不同，且在此场景下无意义

去重和动态分隔符需额外处理

STRING_AGG 本身不支持去重，也不支持运行时计算分隔符，但可以用子查询或 CTE 绕过限制。

• 去重写法：STRING_AGG(DISTINCT name, ', ') —— SQL Server 2022+ 支持，但 2019 不行；2019 必须先去重再聚合：SELECT STRING_AGG(name, ', ') FROM (SELECT DISTINCT name FROM users WHERE dept = @d) t;
• 动态分隔符（如按条件换逗号/分号）：无法在 STRING_AGG 内部实现，需提前在子查询中构造带分隔符的字符串，再用空分隔符拼接：STRING_AGG(prefix + name, '')
• 分隔符里含特殊字符？没问题，STRING_AGG(name, CHAR(10)) 可换行，STRING_AGG(name, ' → ') 也可用

最易被忽略的是：JOIN 后使用 STRING_AGG 时，LEFT JOIN 的空关联会导致该组聚合结果为 NULL，而应用层可能期望空字符串——这个语义差异必须由你主动用 COALESCE 或子查询兜底，不能假定行为一致。