多Schema场景下Liquibase-Hibernate生成实体与数据库差异变更日志的问题

正好我在类似的Servlet 3.1全编程配置项目里用过这套技术栈，结合你提到的版本信息（Spring 5.0.4.RELEASE、Hibernate 5.2.15.Final、JPA 2.1.1、Liquibase Hibernate5 v3.6、Liquibase Maven Plugin v3.5.5），下面是经过验证的配置和步骤，帮你从单个基础包的Hibernate实体和干净Oracle 11gR2 XE生成JSON格式的变更日志差异。

1. Maven POM核心配置 #

首先得把依赖和插件配置捋顺，这里要特别注意版本兼容，毕竟你用的插件版本和Hibernate扩展版本有小差异，我会在配置里做处理：

<dependencies>
    <!-- Hibernate & JPA核心依赖 -->
    <dependency>
        <groupId>org.hibernate</groupId>
        <artifactId>hibernate-core</artifactId>
        <version>5.2.15.Final</version>
    </dependency>
    <dependency>
        <groupId>org.hibernate.javax.persistence</groupId>
        <artifactId>hibernate-jpa-2.1-api</artifactId>
        <version>2.1.1</version>
    </dependency>
    <!-- Liquibase Hibernate5集成包 -->
    <dependency>
        <groupId>org.liquibase.ext</groupId>
        <artifactId>liquibase-hibernate5</artifactId>
        <version>3.6</version>
    </dependency>
    <!-- Oracle 11gR2 JDBC驱动 -->
    <dependency>
        <groupId>com.oracle.database.jdbc</groupId>
        <artifactId>ojdbc6</artifactId>
        <version>11.2.0.4</version>
        <scope>runtime</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.liquibase</groupId>
            <artifactId>liquibase-maven-plugin</artifactId>
            <version>3.5.5</version>
            <configuration>
                <!-- 目标Oracle数据库连接信息 -->
                <url>jdbc:oracle:thin:@localhost:1521:XE</url>
                <username>你的数据库用户名</username>
                <password>你的数据库密码</password>
                <driver>oracle.jdbc.OracleDriver</driver>
                <!-- 关键：通过Spring上下文扫描Hibernate实体 -->
                <referenceUrl>hibernate:spring:com.your.base.package?dialect=org.hibernate.dialect.Oracle10gDialect</referenceUrl>
                <!-- 指定生成JSON格式的变更日志路径 -->
                <changeLogFile>src/main/resources/db/changelog/db.changelog-diff.json</changeLogFile>
                <!-- 明确要对比的数据库对象类型，避免冗余变更 -->
                <diffTypes>tables,columns,indexes,foreignkeys,sequences</diffTypes>
            </configuration>
            <dependencies>
                <!-- 显式引入Spring依赖，适配你的全编程配置 -->
                <dependency>
                    <groupId>org.springframework</groupId>
                    <artifactId>spring-context</artifactId>
                    <version>5.0.4.RELEASE</version>
                </dependency>
                <dependency>
                    <groupId>org.springframework</groupId>
                    <artifactId>spring-orm</artifactId>
                    <version>5.0.4.RELEASE</version>
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>

2. 关键配置细节说明 #

• referenceUrl：这里用hibernate:spring前缀是为了适配你的Spring全编程配置，替换com.your.base.package为你的实体类所在的基础包就行。Oracle10gDialect完全兼容11gR2，不用特意找11g的方言。如果你的项目里有persistence.xml，也可以换成hibernate:persistence:你的持久化单元名称。
• diffTypes：我只列了常用的对象类型，如果你需要视图、存储过程之类的，可以自己加进去。
• Oracle驱动：一定要用对应11gR2的ojdbc6版本，别随便用高版本，容易出现兼容性问题。

3. 执行差异生成命令 #

在项目根目录下打开终端，运行：

mvn liquibase:diff

执行成功后，你要的JSON格式变更日志就会出现在src/main/resources/db/changelog/db.changelog-diff.json里。

4. 踩过的坑和排查技巧 #

• 版本兼容问题：如果遇到类找不到、方法不匹配的错误，大概率是插件和Hibernate扩展的版本不搭。虽然3.5.5插件和3.6扩展是兼容的，但真出问题的话，把插件版本升到3.6.x就能解决。
• 实体扫描不到：先检查referenceUrl里的包路径对不对，再确认实体类上有没有@Entity注解，以及Spring的组件扫描有没有覆盖到这些实体（或者在Hibernate配置里显式注册了）。
• Oracle权限不足：确保你的数据库用户有查询系统表的权限，比如USER_TABLES、USER_COLUMNS这些，不然Liquibase没法读取数据库元数据生成差异。

5. 验证变更日志 #

生成日志后，先手动检查一遍，确认所有实体对应的表、列、约束都正确生成了。没问题的话，就可以用下面的命令把变更应用到数据库：

mvn liquibase:update

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