Liquibase错误解析SQL脚本字符串内--符号的解决方法

Liquibase内置SQL解析器默认不识别单引号包裹的字符串字面量边界，会全局扫描所有位置出现的--字符序列，无差别将其判定为单行注释起始标记，直接截断后续内容，哪怕--属于字符串内部的参数值也会被误处理，最终传给数据库的SQL就会出现字符串被截断的语法错误。

按生产环境推荐优先级排序：

• 最优方案：给对应changeset添加splitStatements:false属性
  该参数会告知Liquibase跳过当前changeset的语句拆分、注释预扫描逻辑，将changeset头到自定义结束分隔符之间的全部内容原样透传给数据库执行，完全避免解析器误判字符串内特殊字符的问题。修改后的脚本示例：

  --changeset TASK-NNN-create_new_tasks endDelimiter:\\ splitStatements:false
  DECLARE
      email VARCHAR2(60) := 'some_person@example.com';
  BEGIN
      CREATE_TASK(
          'new_task_1',
          'python task_executor.py --processor-name "new"',
          'New task 1',
          REPORT_TO => email
      );
      CREATE_TASK(
          'new_task_2',
          'python task_executor.py --processor-name "new_2"',
          'New task 2',
          REPORT_TO => email
      );
  END;
  \\
  

  这是Liquibase编写包含PL/SQL匿名块、存储过程等复杂逻辑脚本的标准实践，改动量极小，不会破坏原有业务逻辑，兼容性最好。
• 备选方案1：自定义注释前缀
  如果需要保留Liquibase的语句拆分能力，可以在changeset上添加commentPrefix:参数，指定一个不会和业务内容冲突的注释标记（比如commentPrefix:--liquibase-comment），让解析器只识别带特定后缀的--作为注释，但该方案需要保证全脚本的注释写法统一，维护成本较高。
• 备选方案2：字符串拼接规避特殊序列（不推荐）
  可以把字符串内的连续横杠拆成拼接形式，比如将'python task_executor.py --processor-name "new"'改写为'python task_executor.py '||'-'||'-processor-name "new"'，从内容层面避开连续的--序列，但这种写法会大幅降低脚本可读性，提升后续维护成本，仅适合临时应急场景使用。

注意：Liquibase 4.0+版本提供了原生数据库SQL解析器开关，但不同数据库方言的兼容性存在差异，生产环境启用前必须完成全量脚本兼容性验证。

内容的提问来源于stack exchange，提问作者Alexander Khristosenko