无法搭配MongoDB Pro扩展使用Liquibase的问题求助

执行liquibase update时出现报错（错误截图：），项目已将1.0.0版本的liquibase-commercial-mongodb jar包放入liquibase/lib目录，但仍无法正常使用mongosh相关功能，可按以下步骤排查：

1. 补全依赖包 #

liquibase-commercial-mongodb 1.0.0并非独立运行，必须搭配以下依赖：

• 添加mongodb-driver-sync（4.4+版本）和mongodb-driver-core jar包到liquibase/lib目录
• 确保liquibase-core版本与扩展兼容（需为4.10.0~4.19.x范围，建议用4.15.x稳定版）

2. 核对配置文件参数 #

检查liquibase.properties的关键配置：

• 连接URL需遵循MongoDB扩展格式：url: mongodb://<用户名>:<密码>@<主机>:<端口>/<数据库名>?authSource=admin
• 驱动类必须设置为：driver: com.mongodb.client.MongoClient
• 确认changeLogFile路径指向正确的changelog文件

3. 校验版本兼容性 #

• 避免使用超出兼容范围的Liquibase Core版本，扩展1.0.0不支持4.20.x及以上核心版本
• 确保本地mongosh版本与目标MongoDB服务器版本匹配（推荐5.0+版本）

4. 开启调试日志定位问题 #

执行命令时添加调试参数，获取更详细的报错堆栈：

liquibase update --log-level=DEBUG

根据日志中类加载失败、依赖缺失的具体提示，针对性补充缺失的jar包

5. 检查仓库文件完整性 #

从项目仓库来看，需确认：

• lib目录下的所有依赖jar包都已提交到仓库（避免本地有但仓库缺失导致部署时出错）
• changelog文件中使用的MongoDB专属变更类型（如mongodb-collection-create）语法是否正确，无拼写错误

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