MySQL sys.list_add 怎样为逗号分隔配置追加一项

需要给 sql_mode、optimizer_switch 这类逗号分隔配置追加一个值时，可以直接使用 sys.list_add(in_list, in_add_value)。它接收原列表和待追加值，返回新的 TEXT 字符串；如果要真正改变配置，还要把返回值写回目标变量。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/sys-list-add.html

最小写法是：先读取当前列表，再用 sys.list_add() 生成新字符串，最后通过 SET 写回会话变量。不要把它当成去重函数，也不要跳过写回后的结果查询。

• 原列表和追加值是两个独立参数，函数返回的是新的文本值。
• 函数调用本身只产生字符串，不会自动修改系统变量。
• 生产使用前要单独决定重复值、空列表、权限和回滚策略。

先把列表输入和追加值分开

sys.list_add() 的参数边界很简单：in_list 是待修改的逗号分隔列表，in_add_value 是要放入列表的新值。先把函数当作“字符串构造器”，比直接修改配置更容易看清结果。

-- 先查看当前会话的逗号分隔配置
SELECT @@SESSION.sql_mode AS current_mode;

-- 只构造新字符串，不修改变量
SELECT sys.list_add(
    'ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES',
    'NO_ENGINE_SUBSTITUTION'
) AS next_mode;

上面的调用只返回一个新文本值。它不会因为函数名里有 add 就自动写回 sql_mode，也不会替你判断业务上是否允许重复项。把这一步单独拿出来，便于在变更前记录旧值。

把返回值写回配置变量

确认新字符串符合预期后，再把表达式放进 SET。下面使用会话级 sql_mode，影响范围只限当前连接，适合先做低风险验证。

-- 将当前会话的 sql_mode 追加一项
SET SESSION sql_mode = sys.list_add(
    @@SESSION.sql_mode,
    'NO_ENGINE_SUBSTITUTION'
);

-- 写回后重新读取，确认变量已经采用新文本
SELECT @@SESSION.sql_mode AS updated_mode;

这里有两个容易混淆的点。第一，@@SESSION.sql_mode 是函数的输入，SET SESSION 才是写回动作；第二，结果查询应放在写回之后，否则看到的只是修改前的值。若改成全局变量，必须另外评估权限、连接继承关系和回滚窗口，不能只替换一个关键字。

用重复值和空列表做边界对比

sys.list_add() 解决的是“在逗号分隔文本后追加一项”，不是集合运算。若追加值已经存在，不能默认它会去重；如果输入来自表单、环境变量或脚本，也不要把空字符串、前后空格和逗号误当成合法配置项。

-- 先观察候选值，再决定是否写回目标变量
SELECT sys.list_add('STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION',
                    'NO_ENGINE_SUBSTITUTION') AS possible_duplicate;

-- 对外部输入先做清洗或白名单判断，再调用追加函数
SELECT sys.list_add('STRICT_TRANS_TABLES', 'NO_ENGINE_SUBSTITUTION')
       AS cleaned_append_result;

实务上可以把输入处理拆成三层：调用方保证追加值不是空文本；配置层按逗号分隔后检查是否已存在；写回层保留旧值，必要时用 sys.list_drop() 或原值恢复。这样即使函数调用成功，也不会把“字符串拼接成功”误判成“配置变更符合预期”。

用四个指标判断方案是否适合上线

这类小函数没有必要凭感觉比较。可以把评估表固定下来，再对手写 CONCAT()、脚本拼接和 sys.list_add() 做同口径核对：

如果只是一次性生成文本，调用函数后读取返回值即可；如果要改变 MySQL 行为，必须把权限、作用域和回滚一起纳入方案。这样衡量的不是函数调用快不快，而是配置变更是否可读、可控、可恢复。

常见问题

sys.list_add 会自动修改 sql_mode 吗？

不会。它先返回新的 TEXT 值，只有把表达式放进 SET，目标变量才会改变。

追加值已经存在时能保证不重复吗？

不能把去重责任交给这个函数。调用前应按业务规则拆分列表、检查重复项，再决定是否写回。