使用Liquibase操作MongoDB时出现ClassCastException问题求助

异常信息 #

class liquibase.database.core.UnsupportedDatabase cannot be cast to class liquibase.nosql.database.AbstractNoSqlDatabase (liquibase.database.core.UnsupportedDatabase and liquibase.nosql.database.AbstractNoSqlDatabase are in unnamed module of loader 'app')

对应Changelog文件 #

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog
        xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext"
        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog https://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd
        http://www.liquibase.org/xml/ns/dbchangelog-ext https://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd">

    <changeSet id="1" author="liquibase">
        <ext:dropCollection collectionName="dummy"/>
    </changeSet>
</databaseChangeLog>

可行解决方案 #

• 引入MongoDB专用扩展依赖
  异常本质是Liquibase未识别MongoDB数据库，核心原因是缺少liquibase-mongodb扩展包。根据项目构建工具添加对应依赖：

  • Maven项目（pom.xml）：

    <dependency>
        <groupId>org.liquibase.ext</groupId>
        <artifactId>liquibase-mongodb</artifactId>
        <version>与Liquibase核心版本兼容的版本（如4.25.0）</version>
    </dependency>
    

  • Gradle项目（build.gradle）：

    implementation 'org.liquibase.ext:liquibase-mongodb:4.25.0'
    

  注意：扩展版本必须和Liquibase核心版本保持一致，避免跨大版本混用。

• 修正数据库连接配置
  确保使用MongoDB专属的连接配置：

  • JDBC URL格式：mongodb://<host>:<port>/<database> 或 mongodb+srv://<username>:<password>@<cluster>/<database>
  • 无需指定传统JDBC驱动类，Liquibase MongoDB扩展会自动处理数据库识别

• 替换Changelog的命名空间
  原Changelog使用通用ext命名空间，改为MongoDB专属命名空间可确保操作被正确处理：

  <?xml version="1.0" encoding="UTF-8"?>
  <databaseChangeLog
          xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:mongodb="http://www.liquibase.org/xml/ns/dbchangelog/mongodb"
          xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog https://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd
          http://www.liquibase.org/xml/ns/dbchangelog/mongodb https://www.liquibase.org/xml/ns/dbchangelog/mongodb/dbchangelog-mongodb-latest.xsd">
  
      <changeSet id="1" author="liquibase">
          <mongodb:dropCollection collectionName="dummy"/>
      </changeSet>
  </databaseChangeLog>
  

• 升级Liquibase版本
  旧版本Liquibase对NoSQL数据库支持有限，建议升级到4.x以上的稳定版本，同时匹配对应版本的MongoDB扩展。

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