Spring Boot集成Azure MSSQL用ActiveDirectoryMSI认证启动报DataSource配置错误

当前启动失败的核心原因有两个：

• 写的自定义配置完全没有向Spring容器注册可用的DataSource实例：标注了@Bean的connectToDb方法返回值是void，方法里临时new出来的SQLServerDataSource在测完连接后就被回收了，整个Spring容器里根本没有合法的DataSource Bean，自动装配逻辑找不到数据源，才会触发"url未指定、无法匹配驱动类"的报错。
• 之前的认知存在偏差：ActiveDirectoryMSI认证确实不需要手动拼传统JDBC URL，但这和需要向Spring容器提供标准DataSource实例是两回事，只是不需要靠spring.datasource.url这类yml硬配置来初始化数据源而已。

1. 修正数据源Bean的注册逻辑 #

将原本仅用于临时测试的SQLServerDataSource真正作为Bean纳入Spring容器管理，把连接测试逻辑从Bean初始化流程中剥离，避免对象被提前回收。调整不需要修改现有从Azure Key Vault读取参数的逻辑，只要属性源能正常把sql.databaseName等配置值注入到配置类的字段中即可。
调整后的完整配置类代码如下：

@Configuration
@Slf4j
public class DataSourceConfig {

    @Value("${sql.databaseName}")
    private String sqlDbName;

    @Value("${sql.serverName}")
    private String sqlServer;

    @Value("${sql.msiClientId}")
    private String sqlIdentity;

    // 核心改动：将构建完成的SQLServerDataSource作为Bean返回，而非返回void
    @Bean
    public DataSource azureSqlDataSource() {
        SQLServerDataSource ds = new SQLServerDataSource();
        ds.setServerName(sqlServer + ".database.windows.net");
        ds.setDatabaseName(sqlDbName);
        ds.setMSIClientId(sqlIdentity);
        ds.setAuthentication("ActiveDirectoryMSI");
        // 可按需补充连接超时、加密等生产环境常用参数
        ds.setLoginTimeout(30);
        ds.setEncrypt(true);
        return ds;
    }

    // 将原连接测试逻辑挪到应用启动完成后执行，不干扰Bean注册流程
    @Bean
    public ApplicationRunner connectionCheckRunner(DataSource dataSource) {
        return args -> {
            try (Connection connection = dataSource.getConnection()) {
                log.info("成功通过托管身份认证连接到Azure SQL数据库");
            } catch (SQLException e) {
                log.error("数据库连接初始化失败", e);
                throw new IllegalStateException("应用启动终止：数据库连接校验未通过", e);
            }
        };
    }
}

调整逻辑说明：只要Spring容器中存在类型为javax.sql.DataSource的Bean，Spring Boot的数据源自动装配逻辑就会优先使用容器内的已有实例，自动跳过对spring.datasource.url、驱动类名这类配置项的校验，从根本上消除当前的启动报错。

2. （可选）彻底关闭数据源自动配置的干扰 #

如果需要从机制上完全杜绝自动配置的校验逻辑，可以在Spring Boot启动类上排除自动配置类，完全接管数据源的创建流程：

@SpringBootApplication(exclude = {
    DataSourceAutoConfiguration.class,
    DataSourceTransactionManagerAutoConfiguration.class
})
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

排除自动配置后，Spring不会主动扫描application.yml中的数据源相关配置，完全使用手动注册的数据源实例完成JPA、事务管理的装配。

3. 依赖兼容性校验 #

• 确认当前引入的mssql-jdbc驱动版本支持ActiveDirectoryMSI认证（Spring Boot父工程默认匹配的9.4及以上版本的驱动已内置该认证能力，无需额外引入Azure身份认证扩展包）。
• 保持H2依赖的test作用域不变，避免自动配置误将H2识别为生产环境的嵌入式数据库。

常见认知纠正：不需要在application.yml中补任何spring.datasource.url的占位符配置。只要容器内存在合法的DataSource Bean，自动配置的校验逻辑会直接跳过对URL的检查，完全适配从Azure Key Vault动态读取参数的场景。

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