Liquibase导出Oracle Schema为H2兼容XML格式异常求助

核心原因 #

Liquibase生成XML格式变更日志时，默认会保留源数据库（此处为Oracle）的原生类型定义，不会自动转换为目标数据库（H2）的兼容类型；而SQL格式会针对目标数据库做语法适配，这是两种格式的处理逻辑差异导致的。

具体解决方案 #

1. 配置Liquibase类型映射规则 #

在Liquibase配置中添加Oracle到H2的类型映射，强制将Oracle特有类型转换为H2兼容格式：

• Maven插件配置（pom.xml）：

<plugin>
    <groupId>org.liquibase</groupId>
    <artifactId>liquibase-maven-plugin</artifactId>
    <version>你的Liquibase版本号</version>
    <configuration>
        <changeLogFile>generatedChangelog.h2.xml</changeLogFile>
        <url>jdbc:h2:mem:test;DB_CLOSE_DELAY=-1</url>
        <username>sa</username>
        <password></password>
        <driver>org.h2.Driver</driver>
        <database>
            <name>h2</name>
            <properties>
                <property>
                    <name>liquibase.mapVarchar2ToVarchar</name>
                    <value>true</value>
                </property>
                <property>
                    <name>liquibase.mapDateTypes</name>
                    <value>true</value>
                </property>
            </properties>
        </database>
    </configuration>
</plugin>

• liquibase.properties配置：

liquibase.mapVarchar2ToVarchar=true
liquibase.mapDateTypes=true

该配置会让Liquibase生成XML时，自动将VARCHAR2(255 BYTE)转换为H2兼容的VARCHAR(255)。

2. 基于H2数据库生成变更日志 #

先将Oracle Schema同步到H2内存库，再直接针对H2生成XML变更日志：

1. 用Oracle的变更日志更新H2库：

mvn liquibase:update -Dliquibase.url=jdbc:h2:mem:test -Dliquibase.username=sa -Dliquibase.password= -Dliquibase.driver=org.h2.Driver -Dliquibase.changeLogFile=oracle-origin-changelog.xml

2. 针对H2生成适配的XML变更日志：

mvn liquibase:generateChangeLog -Dliquibase.url=jdbc:h2:mem:test -Dliquibase.username=sa -Dliquibase.password= -Dliquibase.driver=org.h2.Driver -Dliquibase.outputChangeLogFile=generatedChangelog.h2.xml

这样生成的XML完全基于H2元数据，天然适配H2语法。

3. 手动修正XML类型（应急方案） #

如果上述配置不生效，可直接修改生成的XML：

• 将所有<column name="NAME" type="VARCHAR2(255 BYTE)">替换为<column name="NAME" type="VARCHAR(255)">
• 其他Oracle特有类型（如NUMBER(10,0)）替换为H2兼容的INT或DECIMAL(10,0)

验证方法 #

生成XML后，执行以下命令验证H2兼容性：

mvn liquibase:update -Dliquibase.url=jdbc:h2:mem:test -Dliquibase.username=sa -Dliquibase.password= -Dliquibase.driver=org.h2.Driver -Dliquibase.changeLogFile=generatedChangelog.h2.xml

若能正常创建表且无报错，则说明变更日志适配成功。

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