MySQL GROUP_CONCAT 结果为什么被截断：group_concat_max_len 与字符数验收

订单列表需要把同一客户的多个订单号拼成一列时，GROUP_CONCAT() 很方便，但它有一个容易被忽略的边界：结果默认最多返回 1024 字节，超出部分会被截断。这个现象通常不会让 SQL 直接报错，接口却可能少一截订单号，直到业务对账时才暴露。

默认上限为什么会让完整结果消失

GROUP_CONCAT() 会把分组内非 NULL 值连接起来，默认分隔符是逗号，也可以用 ORDER BY、DISTINCT 和 SEPARATOR 控制结果。MySQL 8.4 手册把 group_concat_max_len 的默认值列为 1024，限制的单位是字节，不是中文字符数。

例如一个客户有 300 个订单号，每个订单号 12 个 ASCII 字符，再加上逗号，理论长度已经超过 1024。若字段里还有中文标签，字符数看起来不大，UTF-8 字节数却会更快达到上限。结果被截断后，查询仍可能正常返回一行。

先区分参数变化和 SQL 写法问题

遇到结果不全，先不要把 GROUP BY 或连接条件全部改掉。可以在同一个连接里执行下面的检查：

SELECT @@session.group_concat_max_len AS max_bytes,
       @@global.group_concat_max_len AS global_max_bytes;

SELECT customer_id,
       GROUP_CONCAT(order_no ORDER BY order_no SEPARATOR ',') AS order_list,
       COUNT(order_no) AS source_count,
       CHAR_LENGTH(GROUP_CONCAT(order_no ORDER BY order_no SEPARATOR ',')) AS result_chars,
       LENGTH(GROUP_CONCAT(order_no ORDER BY order_no SEPARATOR ',')) AS result_bytes
FROM customer_orders
GROUP BY customer_id;

这里的 COUNT(order_no) 是源值数量，CHAR_LENGTH() 看字符数，LENGTH() 看字节数。对只含英文订单号的数据，两者可能相同；一旦混入中文或其他多字节字符，就不能拿字符数代替字节数。

临时调大时，使用会话级边界

如果报表确实需要更长的拼接值，优先只改当前连接：

SET SESSION group_concat_max_len = 8192;

SELECT customer_id,
       GROUP_CONCAT(order_no ORDER BY order_no SEPARATOR ',') AS order_list
FROM customer_orders
GROUP BY customer_id;

改完后重新执行查询，并再次读取 @@session.group_concat_max_len。会话级设置不会把其他连接的上限一起改掉，更适合一次性报表或后台任务。数值也不要凭感觉设成极大值：返回结果还受 max_allowed_packet 等边界影响，过大的聚合结果会增加内存和网络压力。

用三个信号确认结果真的完整

源数量和分隔符数量一致

如果值本身不包含逗号，可以用分隔符数量做快速核对：完整结果的逗号数应等于源值数量减一。更稳妥的方式仍是把聚合结果与源表统计放在同一份验收查询里，避免过滤条件不一致。

检查末尾值，而不是只检查开头

截断通常发生在结果末尾。给 GROUP_CONCAT() 加上稳定的 ORDER BY，再检查末尾订单号是否存在；没有排序时，返回顺序本来就不应被当成业务顺序。

把长列表当成接口设计问题

如果一个客户的订单数可能持续增长，把所有值塞进一个字符串并不总是好方案。分页明细、单独的明细接口或 JSON 聚合都可能更合适。参数调大只能解决当前长度上限，不能消除响应体过大、客户端解析慢和审计不易定位等问题。

常见问题与边界

GROUP_CONCAT() 返回 NULL 是截断吗？

不一定。分组里没有非 NULL 值时，函数可以返回 NULL；这和结果达到长度上限是两种不同情况，应结合源行数检查。

把上限改成 1024 个字符就够了吗？

不够。参数按字节限制，中文、表情或其他多字节字符会让字节数高于字符数。验收时同时记录 CHAR_LENGTH() 和 LENGTH()。

调大参数后还需要排序吗？

需要。长度设置只影响能返回多少内容，不会自动提供稳定顺序。对账、导出和缓存键场景都应显式指定排序字段。

把“SQL 成功”改成“结果可核对”

排查 GROUP_CONCAT() 截断时，顺序应是：查看会话参数，确认源值数量，比较字符数与字节数，必要时只在当前会话调大，再检查末尾值和接口体积。如果长列表已经成为常态，就应重新评估返回模型，而不是持续堆高一个全局参数。