You need to enable JavaScript to run this app. 如何使用Spring Data JPA访问集成Azure AD的Azure PostgreSQL数据库
优惠活动
大模型
产品
解决方案
定价
更多

如何使用Spring Data JPA访问集成Azure AD的Azure PostgreSQL数据库

问题解答

1. 配置是否需要全量迁移到代码中

不需要将spring.datasource与spring.jpa的全量配置迁移到代码中。

  • 固定不变的参数(比如数据库连接URL、用户名、JPA方言、DDL策略)完全可以继续保留在application.properties配置文件中,沿用Spring Boot自动配置的逻辑,避免绕开自动配置导致的连接池适配、健康检查联动等额外开发成本。
  • 仅需要对动态变化的数据库密码(即Azure AD访问令牌)做扩展注入,实现侵入最小的改造,不需要全量硬编码配置。
  • 逻辑实现的最合适位置是通过Spring Boot官方提供的DataSourcePasswordProvider扩展点实现自定义逻辑,而非自行重写Datasource配置类:该扩展点会在每次创建数据库连接时被Spring调用获取最新的连接密码,和自动配置的兼容性最好,不需要手动维护连接池的全量参数。
  • 如果使用的Spring Boot版本低于2.7没有内置DataSourcePasswordProvider接口,可以通过自定义Hikari连接池的密码设置逻辑实现同等效果,但优先建议升级到支持官方扩展点的版本,减少自定义代码的维护成本。

2. 如何获取访问令牌并传递给Spring Data JPA

替换原有手动执行az命令获取令牌的流程,使用Azure官方SDK实现令牌获取,通过扩展点完成传递:

  • 首先补充所需依赖:在build.gradle中新增Azure Identity SDK依赖,用于直接在Java代码中完成Azure AD认证、获取目标资源的访问令牌:
    dependencies {
        // 原有依赖保留
        implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
        implementation 'org.springframework.boot:spring-boot-starter-web'
        runtimeOnly 'org.postgresql:postgresql'
        testImplementation 'org.springframework.boot:spring-boot-starter-test'
        // 新增令牌获取依赖
        implementation 'com.azure:azure-identity'
    }
    
  • 调整原有配置文件:删除硬编码的spring.datasource.password静态值,其余固定参数保持不变。
  • 自定义实现DataSourcePasswordProvider接口的组件,在方法内完成令牌获取逻辑:
    import com.azure.identity.DefaultAzureCredential;
    import com.azure.identity.DefaultAzureCredentialBuilder;
    import org.springframework.boot.jdbc.DataSourcePasswordProvider;
    import org.springframework.stereotype.Component;
    
    @Component
    public class AzureAdPostgresPasswordProvider implements DataSourcePasswordProvider {
        // 初始化单例认证客户端,SDK内部自动维护令牌缓存
        private final DefaultAzureCredential azureCredential = new DefaultAzureCredentialBuilder().build();
        // 匹配Azure PostgreSQL AD集成的目标资源ID,与原az命令中oss-rdbms资源类型等价
        private static final String POSTGRES_SCOPE = "https://ossrdbms-aad.database.windows.net/.default";
    
        @Override
        public String getPassword() {
            // 获取用于PostgreSQL连接的访问令牌
            return azureCredential.getToken(
                new com.azure.core.credential.TokenRequestContext()
                    .addScopes(POSTGRES_SCOPE)
            ).getToken();
        }
    }
    
  • Spring Data JPA本身不感知密码的生成逻辑,它只会从自动配置的Datasource中拿连接参数,上述Provider返回的令牌会作为连接密码被自动传入PostgreSQL JDBC驱动,和原有psql的连接逻辑完全一致。

3. 令牌缓存与过期刷新的处理

完全不需要自行从零实现令牌缓存、过期判断、刷新重试逻辑:

  • 上述实现中使用的DefaultAzureCredential是Azure SDK内置的认证客户端,本身就自带完整的令牌缓存与提前刷新机制:第一次获取令牌后,会按照Azure AD令牌的标准有效期(通常为1小时),在令牌过期前2-3分钟自动在后台请求新的有效令牌,不存在等令牌过期后再触发刷新导致连接失败的问题。
  • 不需要自行实现令牌的缓存存储逻辑:因为DefaultAzureCredential是单例对象,所有令牌获取请求都会走它的内置缓存,不会出现每次获取密码时都重新发起AD认证请求导致的限流问题。
  • 适配连接池场景:由于Spring会在每次新建数据库连接时调用DataSourcePasswordProvider获取最新的有效令牌,结合连接池本身的连接存活校验逻辑,完全可以适配令牌过期的场景,不需要额外修改连接池的配置参数。
  • 兼容性说明:DefaultAzureCredential会自动适配本地开发环境(比如读取本地az login生成的凭据)、生产部署环境(比如托管身份、服务主体认证),不需要修改代码就能在不同环境运行,和原有的本地开发流程完全兼容。

内容的提问来源于stack exchange,提问作者Matthias Güntert

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 21:06:05