使用Liquibase Maven插件生成ChangeLog无数据输出问题排查

问题核心诊断 #

你的配置存在两个关键问题，导致无法导出Oracle数据库中的数据：

1. 目标数据库连接未配置
   pom.xml中<url>、<username>、<password>均为空，Liquibase无法连接到你的遗留Oracle数据库，自然无法读取数据生成ChangeLog。

2. 混淆了generateChangeLog与diffChangeLog的使用场景
   你配置了referenceUrl（Hibernate实体映射），但generateChangeLog是直接从目标数据库生成结构/数据的ChangeLog，而非对比参考库与目标库的差异（这是diffChangeLog的功能）。多余的referenceUrl会干扰Liquibase的执行逻辑。

具体修复步骤 #

1. 补全Oracle数据库连接参数

在Liquibase插件的<configuration>块中，填写正确的Oracle JDBC连接信息：

<url>jdbc:oracle:thin:@//[Oracle主机IP]:[端口]/[服务名]</url>
<username>你的数据库用户名</username>
<password>你的数据库密码</password>

示例：jdbc:oracle:thin:@//192.168.1.100:1521/ORCLPDB1

2. 移除不必要的referenceUrl配置

如果你的目标只是导出Oracle数据库的数据，直接删除<referenceUrl>这一行即可，避免Liquibase误解执行逻辑。

3. 明确数据导出配置（可选）

• 若需确保数据被包含在生成的ChangeLog中，可添加<includeData>true</includeData>配置；
• 若只需导出特定表的数据，可指定表名：

  <tables>USER_INFO,ORDER_DETAIL</tables> <!-- 多个表用逗号分隔 -->
  

• 保留diffTypes=data即可，该配置会让Liquibase仅生成数据相关的ChangeLog（如<insert>或<loadData>语句）。

4. 补充Oracle JDBC驱动依赖

确保插件的<dependencies>中包含Oracle JDBC驱动（避免连接失败）：

<dependency>
    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc8</artifactId>
    <version>19.18.0.0</version>
</dependency>

5. 升级Liquibase版本（推荐）

你使用的4.5.0版本较旧，可能存在Oracle兼容问题，建议升级到稳定的新版本（如4.24.x），同时同步更新liquibase-core和liquibase-hibernate5的版本保持一致。

验证执行 #

修改配置后，重新执行命令：

mvn liquibase:generateChangeLog -Poracle

查看日志输出，若显示changeSets count: [大于0的数字]，则说明数据已成功导出，对应的01-initial-data-dump.xml文件会包含数据插入的ChangeLog语句。

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