Spring Boot集成Azure Key Vault配置属性注入问题排查

1. 配置文件占位符格式错误 #

你用{my-secret-db-url}的写法不符合Spring Boot规范，配置占位符必须用${}包裹。通过spring-cloud-azure-starter-keyvault-secrets自动注入密钥时，正确的配置写法应该是：

spring.datasource.url=${my-secret-db-url}
spring.datasource.password=${my-secret-db-password}

如果密钥带有版本号，需要写成${my-secret-db-url/你的版本号}。

2. 自定义SecretClient干扰自动配置 #

spring-cloud-azure-starter-keyvault-secrets本身会自动创建SecretClient实例，你自己编写的KeyVaultConfig生成的SecretClient并没有被Spring Cloud Azure的配置加载器（如AzureKeyValuePropertySource）识别使用，导致配置文件里的占位符无法被解析为实际密钥值——数据源初始化时拿到的还是占位符字符串，自然会抛出URL格式错误。

解决方式：

• 直接删除自定义的KeyVaultConfig，依赖starter的自动配置即可满足需求。
• 如果必须保留自定义SecretClient，需要在配置文件中添加spring.cloud.azure.keyvault.secrets.custom-client-enabled=true，同时确保你的SecretClient Bean的名称为secretClient（starter默认识别该名称的Bean）。

3. 缺失Key Vault核心配置 #

必须在application.properties/yaml中配置Key Vault的基础信息，否则starter无法自动连接密钥库：

spring.cloud.azure.keyvault.secrets.vault-url=https://你的密钥库名称.vault.azure.net/
spring.cloud.azure.keyvault.secrets.client-id=你的客户端ID
spring.cloud.azure.keyvault.secrets.client-secret=你的客户端密钥
spring.cloud.azure.keyvault.secrets.tenant-id=你的租户ID

如果使用Azure托管身份（如部署在Azure App Service），仅需配置vault-url和tenant-id；本地开发时可通过环境变量AZURE_CLIENT_ID、AZURE_CLIENT_SECRET、AZURE_TENANT_ID完成配置。

4. 调整配置加载优先级 #

Spring Boot 3.3.1的配置加载顺序中，Azure Key Vault的配置源需要优先于本地配置文件，否则数据源初始化时，占位符还未被解析就被读取。可添加以下配置让Key Vault配置优先级最高：

spring.cloud.azure.keyvault.secrets.property-source-order=0

5. 检查依赖版本兼容性 #

确保spring-cloud-azure-starter-keyvault-secrets的版本与Spring Boot 3.3.1兼容，例如使用2024.0.0版本（官方对应Spring Boot 3.3.x），版本不匹配会导致自动配置逻辑失效。

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