Spring Boot集成MongoDB Liquibase插件时Liquibase无法启动

碰到这种情况确实挺头疼的——数据库连接正常，但Liquibase完全没动静，连条日志都没有，根本摸不着头绪对吧？我之前处理过好几个类似的问题，大多都是配置或依赖的小疏漏，给你梳理几个排查方向：

• 先确认依赖是否正确引入
  MongoDB的Liquibase支持需要专门的扩展依赖，不能只加普通的Liquibase核心包。比如在Maven项目里，你需要同时引入这两个依赖（注意版本要和你的Spring Boot、MongoDB版本兼容）：

  <dependency>
      <groupId>org.liquibase.ext</groupId>
      <artifactId>liquibase-mongodb</artifactId>
      <version>适配你的版本号</version>
  </dependency>
  <dependency>
      <groupId>org.liquibase</groupId>
      <artifactId>liquibase-core</artifactId>
  </dependency>
  

  如果是Gradle项目，对应的依赖配置也要调整，确保扩展包被正确拉取。

• 检查Liquibase的核心配置
  打开你的application.properties或application.yml，确认这几个关键配置：

  1. spring.liquibase.enabled必须设为true（默认是true，但有时候会被误改或通过其他配置覆盖）
  2. 必须指定spring.liquibase.change-log的正确路径，比如classpath:db/changelog/db.changelog-master.yaml，路径错了的话Liquibase找不到变更脚本，甚至可能不启动
  3. MongoDB的连接配置要和Liquibase关联，比如：

     spring:
       liquibase:
         mongodb:
           uri: mongodb://localhost:27017/你的数据库名
     

• 验证Spring Boot自动配置是否生效
  检查你的启动类，有没有不小心加了@SpringBootApplication(exclude = LiquibaseAutoConfiguration.class)这种排除Liquibase自动配置的注解？如果有，赶紧去掉，不然Spring根本不会加载Liquibase的相关组件。

• 调整日志级别，强制输出Liquibase日志
  有时候是日志级别设置太高，Liquibase的启动信息被过滤掉了。你可以在配置文件里把Liquibase的日志级别调到INFO：

  logging:
    level:
      liquibase: INFO
  

  这样哪怕Liquibase正常启动，也会输出初始化、锁检查这类基础日志，能帮你确认它到底有没有在运行。

• 检查变更日志文件的格式
  MongoDB的Liquibase变更脚本和关系型数据库的语法不一样，必须用MongoDB专属的标签。比如一个最简单的插入数据的变更集：

  databaseChangeLog:
    - changeSet:
        id: 1
        author: 你的名字
        changes:
          - mongodb:
              collectionName: users
              operation: insert
              documents:
                - { name: "test", email: "test@example.com" }
  

  如果脚本格式错误，Liquibase可能会静默失败，但调整日志级别后应该能看到错误信息。

按这个顺序排查下来，大概率能找到问题所在。

内容来源于stack exchange