Spring Boot中用Maven、Liquibase、Hibernate生成Diff-File报错

问题诊断 #

执行mvn liquibase:diff时触发的错误，核心原因是Liquibase无法从指向JPA实体的Hibernate参考URL中识别驱动类，同时你的配置文件和依赖版本存在多处不兼容问题。

修复步骤 #

1. 修正配置文件名拼写错误 #

你的配置文件被命名为liquidate.properties，正确名称应为**liquibase.properties**，文件名错误会导致Liquibase无法加载正确配置。

2. 调整liquibase.properties配置 #

补充referenceUrl的必要参数，并明确指定参考驱动类，解决自动识别失败问题：

# 实际数据库连接配置
url = jdbc:postgresql://localhost:5432/employeediff
username = myuser
password =
driver=org.postgresql.Driver
classpath=/usr/local/opt/liquibase/internal/lib/postgresql.jar

# Liquibase变更日志配置
changeLogFile = src/main/resources/db/changelog/changelog-master.xml
diffChangeLogFile = src/main/resources/db/changelog/diffchangelog.xml

# Hibernate参考配置（指向JPA实体所在包）
referenceUrl=hibernate:spring:com.example.demo?dialect=org.hibernate.dialect.PostgreSQLDialect&hibernate.physical_naming_strategy=org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy&hibernate.implicit_naming_strategy=org.springframework.boot.orm.jpa.hibernate.SpringImplicitNamingStrategy
referenceDriver=org.postgresql.Driver

• 添加referenceDriver参数直接指定驱动类，规避自动识别逻辑的问题
• 移除referenceUrl参数中的多余空格，将HTML转义符&替换为原生&

3. 统一依赖版本，解决兼容性冲突 #

你的Liquibase核心包、Maven插件、Hibernate扩展版本不匹配，这是引发此类问题的常见原因：

• 删除dependencies节点下的liquibase-maven-plugin依赖（插件依赖只需在plugin节点内声明）
• 使用版本属性统一管理Liquibase相关组件版本，确保主版本一致：

<properties>
    <liquibase.version>4.10.0</liquibase.version>
    <liquibase-hibernate5.version>4.10.0</liquibase-hibernate5.version>
</properties>

<dependencies>
    <!-- 保留其他原有依赖，仅修改liquibase-core版本 -->
    <dependency>
        <groupId>org.liquibase</groupId>
        <artifactId>liquibase-core</artifactId>
        <version>${liquibase.version}</version>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.liquibase</groupId>
            <artifactId>liquibase-maven-plugin</artifactId>
            <version>${liquibase.version}</version>
            <configuration>
                <propertyFile>src/main/resources/liquibase.properties</propertyFile>
            </configuration>
            <dependencies>
                <dependency>
                    <groupId>org.liquibase.ext</groupId>
                    <artifactId>liquibase-hibernate5</artifactId>
                    <version>${liquibase-hibernate5.version}</version>
                </dependency>
                <!-- 保留Spring相关依赖，确保版本与Spring Boot 2.7.x兼容 -->
                <dependency>
                    <groupId>org.springframework</groupId>
                    <artifactId>spring-beans</artifactId>
                    <version>5.3.22</version>
                </dependency>
                <dependency>
                    <groupId>org.springframework.data</groupId>
                    <artifactId>spring-data-jpa</artifactId>
                    <version>2.7.2</version>
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>

• liquibase-hibernate5版本必须与liquibase-core主版本保持一致，否则会出现类加载或方法调用错误
• 确保Spring相关依赖版本与你的Spring Boot 2.7.x版本匹配

4. 验证PostgreSQL驱动可用性 #

确认postgresql依赖已正确下载到本地Maven仓库，或classpath配置的jar文件路径有效。

验证执行 #

完成所有修改后，重新执行命令：

mvn clean liquibase:diff

此时应能成功生成差异文件到src/main/resources/db/changelog/diffchangelog.xml路径。

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