SQL Server STRING_AGG 超过 8000 bytes：聚合输入转换为 max

按组拼接文本时，小批数据正常，大组却报 STRING_AGG aggregation result exceeded the limit of 8000 bytes。先检查 STRING_AGG 第一个参数的实际类型：返回类型由输入表达式决定，短字符串列参与聚合，并不会因为组内行数增加就自动变成 max 类型。

下面针对 SQL Server 2017 及以后版本。报错中的 8000 是字节限制，不能一律当成 8000 个字符；nvarchar 还有自身的存储规则。这个故障应调整聚合表达式的类型，不能照搬其他数据库的聚合长度会话参数。

大组为什么才失败

当前规则中，varchar(1..8000) 的聚合结果为 varchar(8000)，nvarchar(1..4000) 的结果为 nvarchar(4000)。输入已经是 varchar(max) 或 nvarchar(max) 时，结果才是相应的 max 类型。整数、日期等非字符串输入通常先转为 nvarchar，聚合结果为 nvarchar(4000)。

因此，每一行只有几十个字符，很多行及其分隔符加起来仍可能超出结果类型。源表单行字段够长，与这个组的聚合结果容量，是两件不同的事。

先核对失败组的行数、连接条件、表达式及预期长度。连接产生重复行也会扩大结果；如果业务需要唯一条目，应明确去重语义，不能只为消除报错随意删掉重复值或改变 GROUP BY。

转换应放到 STRING_AGG 里面

下面是已有报表表结构的只读查询示例，表名、字段和分组键需替换成真实对象：

SELECT group_id,
       STRING_AGG(CONVERT(nvarchar(max), item_name), N',') AS items
FROM dbo.ReportItems
GROUP BY group_id;

把输入转换为 nvarchar(max)，让聚合从开始就采用相应的返回类型。下面这种写法在聚合后才转换，内部步骤仍可能先触发原上限，不是同样的处理：

SELECT CONVERT(nvarchar(max), STRING_AGG(item_name, ','))
FROM dbo.ReportItems;

第二段仅展示不适合用来绕过内部限制的写法，不建议拿失败查询当常规修复步骤。

根据数据契约选择 varchar(max) 或 nvarchar(max)。需要保留 Unicode 时选择合适的 Unicode 路径；输入是 varchar 时，分隔符不能采用 nvarchar 类型。不要只改分隔符为 N','，却让输入保持 varchar，再引入新的类型不匹配。

输入本身就是复杂表达式时，也核对表达式内部是否已截断内容。把最终表达式转换为 max 能改变聚合结果类型，但不能补回更早一步已经丢失的文本。

顺序、NULL 和展示截断分别检查

STRING_AGG 忽略 NULL，不为它额外添加分隔符。如果业务需要占位值，应在聚合输入中明确处理 NULL，并保持与调用方约定一致。需要固定顺序时采用 WITHIN GROUP，相关排序子句要求数据库兼容级别至少为 110；不要依赖查询偶然返回的行序。

例如，在 SQL Server 2017 及以后且兼容级别满足条件时，可将排序合并为：

SELECT group_id,
       STRING_AGG(CONVERT(nvarchar(max), item_name), N',')
           WITHIN GROUP (ORDER BY item_name) AS items
FROM dbo.ReportItems
GROUP BY group_id;

这是按名称排序的示例，不能替代业务要求的编号或时间顺序。需要先去重时，应在输入子查询中按真实键构造数据；STRING_AGG 的语法没有通用的 DISTINCT 参数可直接插入。

查询不再报错后，若管理工具里仍只能看到一段文本，检查结果显示和导出限制。SQL Server Management Studio 的 Results to Text 默认会截断每列的显示长度；这与服务器抛出聚合上限错误不同，不能只因屏幕没有完整显示就继续扩大数据库字段。

用业务实际结果验收

改动前保存查询和报表配置，优先在受控数据上比较最大组。修复后应确认查询没有原错误，组内预期条目、分隔符、NULL 处理和顺序正确，并用应用实际读取或导出路径取得完整结果。

max 类型仍有存储容量和资源成本，不意味着可以无限聚合。大组可能增加内存、排序和传输压力，应核对执行计划及调用方可接受的结果大小；必要的分页或返回结构变化需要单独协调接口。

这项修复通常只改查询表达式，无需重启服务或扩大源表单行字段。回退时恢复保存的查询，但原大组可能再次失败；若旧结果曾写入其他表或导出文件，代码回退不会自动重建它们，相关产物应单独核对。