H2执行Liquibase添加列时尝试删表的问题排查与解决

1. H2 2.x的DDL执行策略变更：H2 2.x版本在处理ALTER TABLE ADD COLUMN时，若目标表存在外键、索引等依赖对象，默认会采用「创建临时表→迁移数据→删除原表→重命名临时表」的流程完成变更。当原表被其他表的外键引用时，删除原表的操作会触发约束校验，导致临时表删除失败，出现无法删除TABLE_COPY_xxx类表的报错。
2. 兼容性模式未对齐PostgreSQL：升级后Spring Boot自动配置的H2连接参数未指定PostgreSQL兼容模式，H2默认行为与PostgreSQL差异较大——PostgreSQL支持直接在原表上添加列，无需重建表结构。
3. Liquibase与H2版本适配问题：Liquibase 4.26.0对H2 2.x的DDL生成逻辑未做针对性优化，无论使用addColumn标签还是原生SQL，都触发了H2的表重建流程，而非直接添加列。

1. 配置H2为PostgreSQL兼容模式 #

在测试环境的H2连接URL中添加兼容参数，让H2模拟PostgreSQL的DDL执行逻辑，避免重建表：

spring.datasource.url=jdbc:h2:mem:testdb;MODE=PostgreSQL;DATABASE_TO_LOWER=TRUE;DEFAULT_NULL_ORDERING=HIGH

• MODE=PostgreSQL：强制H2采用PostgreSQL的语法与行为，支持直接在原表上添加列。
• 其余参数用于对齐PostgreSQL的细节特性，减少其他兼容性问题。

2. 禁用H2的表重建行为 #

在H2连接URL中添加ALTER_TABLE_RECREATION=DISABLE参数，强制H2直接修改原表而非重建：

spring.datasource.url=jdbc:h2:mem:testdb;ALTER_TABLE_RECREATION=DISABLE;MODE=PostgreSQL

该参数会阻止H2使用重建表的方式处理ALTER操作，适用于绝大多数添加列的场景。

3. 针对H2调整Liquibase Changeset #

使用Liquibase的数据库条件判断，为H2和PostgreSQL分别指定适配的DDL逻辑：

<changeSet id="add-new-column-h2" author="your-name">
    <preConditions onFail="MARK_RAN">
        <dbms type="h2" />
    </preConditions>
    <sql>ALTER TABLE your_table ADD COLUMN new_column VARCHAR(255) NULL</sql>
</changeSet>
<changeSet id="add-new-column-postgres" author="your-name">
    <preConditions onFail="MARK_RAN">
        <dbms type="postgresql" />
    </preConditions>
    <addColumn tableName="your_table">
        <column name="new_column" type="varchar(255)" nullable="true"/>
    </addColumn>
</changeSet>

4. 隔离Hibernate与Liquibase的DDL管理 #

确保Hibernate的自动DDL配置不会干扰Liquibase的变更，测试环境建议设置：

spring.jpa.hibernate.ddl-auto=none

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