Mulesoft Anypoint Studio连接SQL Server报SQLServerDriver加载错误

问题现象 #

连接SQL Server数据库时持续触发报错：

尝试加载驱动时出错: com.microsoft.sqlserver.jdbc.SQLServerDriver : 无法加载类'com.microsoft.sqlserver.jdbc.SQLServerDriver':
类'com.microsoft.sqlserver.jdbc.SQLServerDriver'未为区域'domain/default/app/s-claims'配置包映射

已完成的基础配置如下：

1. pom.xml中引入mssql-jdbc依赖：

<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
    <version>6.2.2.jre8</version>
</dependency>

2. pom.xml中已配置对应sharedLibrary共享库：

<sharedLibrary>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
</sharedLibrary>

使用相同凭据直连SQL Server可正常连通，已排除账号、网络、数据库本身可用性问题。

排查解决步骤 #

• 首先校验sharedLibrary配置位置和格式是否正确：sharedLibrary标签必须放在pom.xml的<build> -> <plugins> -> mule-maven-plugin插件的<configuration>节点下，直接放在build根节点或其他插件配置下不会生效，且父节点必须是复数形式的<sharedLibraries>标签，正确配置结构参考：

<plugin>
    <groupId>org.mule.tools.maven</groupId>
    <artifactId>mule-maven-plugin</artifactId>
    <version>${mule.maven.plugin.version}</version>
    <extensions>true</extensions>
    <configuration>
        <sharedLibraries>
            <sharedLibrary>
                <groupId>com.microsoft.sqlserver</groupId>
                <artifactId>mssql-jdbc</artifactId>
            </sharedLibrary>
        </sharedLibraries>
    </configuration>
</plugin>

注：漏写父标签末尾的s是该类问题最高发的配置错误。

• 清理缓存重新加载依赖：右键项目 -> 选择Mule -> Update Project Dependencies，等待依赖刷新完成后，点击顶部菜单栏Project -> Clean清理编译缓存，重启Studio后再测试连接。
• 校验JDBC驱动版本和Mule运行时的兼容性：6.2.2.jre8版本仅适配搭载JDK8的Mule运行时，如果使用Mule 4.4+版本（默认搭载JDK11），需要将mssql-jdbc版本替换为适配对应JDK版本的包，例如适配JDK11的10.2.0.jre11，替换后重新刷新依赖即可。
• 核对数据库连接配置项：驱动类名必须严格填写为com.microsoft.sqlserver.jdbc.SQLServerDriver，注意大小写不要写错，连接URL前缀需匹配为jdbc:sqlserver://。
• 如果项目关联了自定义域项目（Domain Project），需要把mssql-jdbc依赖和sharedLibrary配置同时放到域项目的pom.xml中，普通应用的类加载配置不会透传到域级别类加载器。

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