STRING_AGG必须配合GROUP BY使用，否则SQL Server报错“STRING_AGG is not allowed in the context”；分隔符必填且不可为NULL，排序须用WITHIN GROUP(ORDER BY...)显式声明，不支持DISTINCT和空值占位。
STRING_AGG必须配合GROUP BY，否则直接报错
不写 GROUP BY 就调用 STRING_AGG，SQL Server 会立刻抛出错误：STRING_AGG is not allowed in the context。它不是窗口函数，也不是标量函数，本质就是聚合——和 SUM、COUNT 一样，必须明确“按什么分组”。
想对全表做一次拼接（比如把所有用户名连成一行），不能省略分组，得用兼容写法：
-
GROUP BY ()是 PostgreSQL 写法，SQL Server 不认 - 正确写法是
GROUP BY (SELECT NULL)或GROUP BY 1（如果 SELECT 列里只有聚合表达式） - 更稳妥的是加个常量字段：
SELECT STRING_AGG(name, ', ') FROM users GROUP BY 1
ORDER BY 必须写在 WITHIN GROUP 里，外层 ORDER BY 无效
很多人写成这样：STRING_AGG(name, ', ') ORDER BY name，结果发现排序没生效。因为 ORDER BY 在函数外部只影响最终结果集顺序，不影响拼接逻辑本身。
真正控制拼接顺序的，只能是 WITHIN GROUP (ORDER BY ...) 子句：
- 不写
WITHIN GROUP→ 拼接顺序未定义，每次执行可能不同 - 分隔符后不能直接跟
ORDER BY，那是 PostgreSQL 的简写语法，SQL Server 不支持 - 排序字段必须来自当前作用域，比如
WITHIN GROUP (ORDER BY sort_order DESC)，其中sort_order得是 SELECT 列或 GROUP BY 列
分隔符是必填参数，NULL 或空字符串要小心
STRING_AGG 的第二个参数（分隔符）不允许为 NULL，传进去会报错：delimiter must not be null。但空字符串 '' 是合法的，表示无缝连接。
常见踩坑点：
- 写成
STRING_AGG(name, )—— 缺少分隔符，语法错误 - 写成
STRING_AGG(name, NULL)—— 运行时报错 - 想用空格分隔却写了
' '（带空格），结果每项前后多出空格；想紧凑就用''，别漏引号 - 字段含换行符或制表符时，拼出来可能难以阅读，必要时先
REPLACE(col, CHAR(10), ' ')清洗
去重和 NULL 处理得靠前置逻辑，STRING_AGG 本身不干这事
STRING_AGG 不接受 DISTINCT，也不提供去重开关。写 STRING_AGG(DISTINCT name, ',') 会直接报语法错误。
要实现去重拼接，必须在进入 STRING_AGG 前完成：
- 用子查询或 CTE 先
SELECT DISTINCT group_id, name FROM t，再外层GROUP BY group_id - 原始数据有
NULL时，STRING_AGG默认跳过，不会留空位；若需占位，用ISNULL(name, 'N/A')或COALESCE(name, '') - 注意 JOIN 后容易引入隐式重复，比如一对多关联没加
DISTINCT就直接聚合，结果串里同一值出现多次
最常被忽略的一点：即使你确认数据没重复、没 NULL、版本也够新，只要没显式写 WITHIN GROUP (ORDER BY ...)，拼接顺序就是不可靠的——SQL Server 不承诺无序聚合的稳定性，生产环境千万别赌运气。
