Spring Boot接入Azure Key Vault获取Secret，Bean初始化失败问题

我正在搭建Spring Boot应用连接Azure Key Vault获取密钥，参考官方配置后启动报错，Spring Bean无法通过@Value注入AKV中的密钥，提示无法解析占位符。环境是Spring Boot 2.7.3，Azure Key Vault Starter版本4.2.0。

配置与代码片段 #

application.yml

spring:
  cloud:
    azure:
      keyvault:
        secret:
          enabled: true
          endpoint: https://uri/
          credential:
            client-certificate-path: <pem文件路径>
            client-id: <客户端ID>
          profile:
            tenant-id: <租户ID>

build.gradle

implementation 'com.azure.spring:spring-cloud-azure-starter-keyvault-secrets:4.2.0'

Spring配置类

@Configuration
@Getter
@Setter
public class AKVProperties {
 
  @Value("${MYAPP-DB-LOGIN-PASSWORD}")
  private String dbPassword1;
  // 其他属性...
}

启动异常

Error creating bean with name 'AKVProperties': Injection of autowired dependencies failed; nested exception is java.lang.IllegalArgumentException: Could not resolve placeholder 'MYAPP-DB-LOGIN-PASSWORD' in value "${MYAPP-DB-LOGIN-PASSWORD}"

排查与解决步骤 #

• 确认密钥名称完全匹配：检查Azure Key Vault中的密钥名称是否和@Value中的占位符完全一致，大小写、连字符等细节不能出错，Spring Cloud Azure默认直接按密钥名称映射为配置属性。
• 验证客户端证书有效性：确保pem文件路径正确且应用有读取权限；检查Azure AD应用注册是否被分配了Key Vault Secrets User角色，具备密钥读取权限；可临时改用客户端密钥（client-secret）测试，排除证书认证问题。
• 强制依赖AKV配置源：在AKVProperties类上添加@DependsOn("azureKeyVaultPropertySource")，确保AKV配置源在Bean初始化前完成加载。
• 配置密钥名称转换规则（可选）：如果需要更符合Spring规范的属性名，可配置前缀和转换规则，示例：

  spring:
    cloud:
      azure:
        keyvault:
          secret:
            property-sources:
              - name: my-akv-source
                prefix: myapp.db.
                secret-name-pattern: MYAPP-DB-*
                property-name-pattern: MYAPP-DB-{name}
  

  之后可通过@Value("${myapp.db.login.password}")注入密钥。
• 启用调试日志排查：添加日志配置查看AKV连接和密钥加载细节：

  logging:
    level:
      com.azure.spring.cloud: DEBUG
      com.azure.security.keyvault.secrets: DEBUG
  

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