使用Liquibase连接DocumentDB v5时遇驱动类未识别错误求助

问题核心 #

该错误源于Liquibase无法自动识别MongoDB/DocumentDB对应的驱动类，即便指定了databaseClass，也需要确保配置传递路径正确，或显式声明驱动类。

具体修复步骤 #

1. 修正Maven插件配置 #

将databaseClass、连接参数及依赖直接配置在Liquibase Maven插件中，确保扩展和驱动被插件正确加载：

<pluginManagement>
    <plugins>
        <plugin>
            <groupId>org.liquibase</groupId>
            <artifactId>liquibase-maven-plugin</artifactId>
            <version>4.31.1</version>
            <dependencies>
                <dependency>
                    <groupId>org.liquibase.ext</groupId>
                    <artifactId>liquibase-mongodb</artifactId>
                    <version>4.31.1</version>
                </dependency>
                <dependency>
                    <groupId>org.mongodb</groupId>
                    <artifactId>mongodb-driver-sync</artifactId>
                    <version>5.2.1</version>
                </dependency>
            </dependencies>
            <configuration>
                <changeLogFile>changelog-master.yaml</changeLogFile>
                <databaseClass>liquibase.ext.mongodb.database.MongoLiquibaseDatabase</databaseClass>
                <url>mongodb://administrator:[MY_PASSWORD]@mongodb-cluster.cluster-xyz.eu-west-1.docdb.amazonaws.com:27017/admin?tls=true&amp;tlsCAFile=global-bundle.pem&amp;replicaSet=rs0&amp;readPreference=secondaryPreferred&amp;retryWrites=false</url>
                <!-- 显式指定MongoDB驱动类 -->
                <driverClass>com.mongodb.client.MongoClient</driverClass>
            </configuration>
        </plugin>
    </plugins>
</pluginManagement>

2. 调整liquibase.properties的用途 #

Maven依赖必须放在pom.xml中，liquibase.properties仅用于配置Liquibase运行参数，示例内容如下：

changeLogFile=changelog-master.yaml
databaseClass=liquibase.ext.mongodb.database.MongoLiquibaseDatabase
url=mongodb://administrator:[MY_PASSWORD]@mongodb-cluster.cluster-xyz.eu-west-1.docdb.amazonaws.com:27017/admin?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false
driverClass=com.mongodb.client.MongoClient

确保该文件位于项目根目录，或通过Maven插件的propertyFile参数指定路径。

3. 验证tlsCAFile路径 #

DocumentDB的global-bundle.pem文件需保证Liquibase执行时可访问：

• 使用相对路径时，确保路径相对于Maven执行的工作目录（如项目根目录）
• 或直接使用绝对路径（如/opt/certs/global-bundle.pem）

4. 排查依赖冲突 #

执行以下命令检查是否有旧版本MongoDB驱动或Liquibase核心被意外引入：

mvn dependency:tree

若发现冲突，在对应依赖中添加exclusions排除旧版本。

5. 测试连接 #

使用Maven命令直接验证配置是否生效：

mvn liquibase:status

内容的提问来源于stack exchange，提问作者s.dragos