数据库迁移引发H2数据库多字段新增ALTER语句报错问题

该语法错误的核心诱因是H2数据库的MySQL兼容模式未实现MySQL支持的「单条ALTER TABLE语句通过逗号分隔多个ADD子句批量加字段」的语法特性：

1. 原生MySQL允许在一条ALTER TABLE语句后拼接多个逗号分隔的ADD 列定义子句，一次操作新增多个字段；
2. 即使配置了MODE=MYSQL参数，H2也仅实现了部分MySQL语法，并未覆盖多ADD子句的场景，其语法解析器在单条ALTER语句中遇到第一个ADD子句后的逗号时，就会判定语法不符合规则抛出异常，这和「仅保留单个ADD子句时语句可正常执行」的现象完全吻合。
   从错误码42000-200可确认当前使用的是H2 1.4.x系列版本，该系列所有版本均存在这个兼容差异。

根据实际场景选择对应方案即可：

• 优先推荐：拆分批量新增语句为多条独立ALTER语句，该写法同时兼容H2和MySQL，不需要区分环境调整脚本，示例：

alter table account add is_provider_root_account varchar(1) not null;
alter table account add provider_organisation_id varchar(255) null;

• 若迁移脚本仅需在H2环境执行，可使用H2原生支持的括号包裹多列定义的批量新增语法，示例：

alter table account add (
  is_provider_root_account varchar(1) not null,
  provider_organisation_id varchar(255) null
);

注意该写法不被MySQL识别，禁止在正式环境MySQL实例上执行。

• 若使用Flyway/Liquibase等数据库迁移工具，也可通过配置路径匹配规则，为H2测试环境单独编写适配语法的迁移脚本，该方案维护成本较高，非必要不选择。

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