使用Liquibase连接Azure SQL MI时msal4j.JsonHelper初始化失败

核心问题分析 #

报错Could not initialize class com.microsoft.aad.msal4j.JsonHelper本质是依赖版本不匹配或缺失必要传递依赖，导致MSAL4J的JSON工具类无法正常加载。常见触发原因：

• msal4j版本与SQL Server JDBC驱动版本不兼容
• 缺失Jackson等msal4j依赖的核心组件
• Liquibase自带的第三方库（如Jackson）与msal4j所需版本冲突

解决方案 #

1. 用官方认证包简化依赖管理 #

微软提供了mssql-jdbc-auth包，内置AD认证所需的所有依赖（包括msal4j及其传递依赖），无需手动拼凑jar包：

• 下载对应JDBC驱动版本的mssql-jdbc-auth包（根据系统架构选x64/x86版本）
• 将该包与mssql-jdbc驱动包一起放入Liquibase的lib目录，或添加到类路径

2. 严格匹配JDBC驱动与msal4j版本 #

如果必须手动管理依赖，需确保版本完全对应（以JDBC驱动12.x版本为例）：

需同时添加以下核心依赖jar：

• msal4j-<对应版本>.jar
• jackson-databind-<对应版本>.jar
• jackson-core-<对应版本>.jar
• jackson-annotations-<对应版本>.jar
• slf4j-api-1.7.36.jar（或对应兼容版本）

3. 排查类路径冲突 #

用以下命令查看类加载细节，定位冲突或缺失的类：

java -cp "你的类路径（所有jar用分号/冒号分隔）" -verbose:class com.microsoft.aad.msal4j.JsonHelper

如果输出中出现ClassNotFoundException或加载了错误版本的Jackson类，需移除冲突的jar包（比如Liquibase自带的旧版Jackson）。

4. 验证JDBC连接参数 #

确保JDBC URL的AD认证参数正确：

jdbc:sqlserver://<你的SQL MI地址>:1433;database=<数据库名>;user=<AD用户UPN，如xxx@domain.com>;password=<AD密码>;encrypt=true;trustServerCertificate=false;hostNameInCertificate=*.xxxx.database.windows.net;loginTimeout=30;authentication=ActiveDirectoryPassword

注意user必须是AD用户的完整UPN格式，不能只用用户名。

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