如何使用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
相关产品推荐
相关产品推荐

