SpringBoot应用无法从Vault注入密钥问题排查求助

SpringBoot应用已配置HashiCorp Vault集成，采用AppRole认证方式，环境变量均正确设置。通过API调用https://vault.my.org/v1/kv-dev/data/couchbase-dev可正常获取包含username和password的密钥，但应用启动时抛出错误：

Caused by: java.lang.IllegalArgumentException: Could not resolve placeholder 'username' in value "${username}"

日志显示Vault相关类已完成自动配置，预期Vault中的密钥能注入到Spring配置中，求排查遗漏点。

相关配置文件 #

application.yml #

spring:
  application:
    name: MyService

  profiles:
    active: dev

  cloud:
    vault:
      enabled: true
      namespace: ${VAULT_NAMESPACE}
      uri: https://vault.my.org
      authentication: APPROLE
      app-role:
        role-id: ${VAULT_APPROLE_ROLE_ID}
        secret-id: ${VAULT_APPROLE_SECRET_ID}
      kv:
        enabled: true
        backend: kv-dev
        default-context: couchbase-dev
        application-name: ${spring.application.name}
        version: 2
        profiles: ${spring.profiles.active}

    config:
      import: vault://
    couchbase:
      username: ${username}
      password: ${password}
      connection-string: ${COUCHBASE_CONNECTION}
      bucket:
        name: ${COUCHBASE_BUCKET_NAME}
      auto-index: true

pom.xml #

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-couchbase</artifactId>
</dependency>

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-vault-config</artifactId>
    <version>4.1.2</version>
</dependency>

<dependency>
    <groupId>org.springframework.vault</groupId>
    <artifactId>spring-vault-core</artifactId>
    <version>3.1.2</version>
</dependency>

Vault API响应 #

{
  "request_id": "f7c177ec-7291-6872-4f03-d2453d9d4ed6",
  "lease_id": "",
  "renewable": false,
  "lease_duration": 0,
  "data": {
    "data": {
      "password": "dgdrg",
      "username": "dgdfhfdh"
    },
    "metadata": {
      "created_time": "2024-12-18T08:22:08.908747692Z",
      "custom_metadata": null,
      "deletion_time": "",
      "destroyed": false,
      "version": 3
    }
  },
  "wrap_info": null,
  "warnings": null,
  "auth": null,
  "mount_type": "kv"
}

1. 修正Couchbase配置节点位置 #

当前spring.cloud.couchbase的配置节点错误，Spring Boot的Couchbase配置应直接放在spring节点下，而非spring.cloud下。错误的节点位置会导致配置绑定逻辑异常，提前触发占位符解析：
修改后的application.yml关键部分：

spring:
  application:
    name: MyService
  profiles:
    active: dev
  # 将couchbase配置移到此处，与application、profiles同级
  couchbase:
    username: ${username}
    password: ${password}
    connection-string: ${COUCHBASE_CONNECTION}
    bucket:
      name: ${COUCHBASE_BUCKET_NAME}
    auto-index: true
  cloud:
    config:
      import: vault://
    vault:
      # 保留原Vault配置

2. 调整Vault配置加载优先级 #

将spring.cloud.config.import: vault://移到spring.cloud节点的最顶层，确保Vault配置优先于其他配置加载，避免占位符解析时Vault密钥尚未注入：

spring:
  cloud:
    config:
      import: vault:// # 放在cloud节点最前面
    vault:
      # Vault配置内容

3. 验证KV路径匹配逻辑 #

Spring Cloud Vault会按以下顺序加载KV密钥（基于你的配置）：

• kv-dev/data/couchbase-dev
• kv-dev/data/couchbase-dev,dev
• kv-dev/data/MyService
• kv-dev/data/MyService,dev
  虽然API能获取kv-dev/data/couchbase-dev，但可通过开启调试日志确认Spring是否正确读取该路径的密钥。

4. 开启Vault调试日志 #

添加日志配置，查看Vault密钥加载的详细过程，确认是否成功将密钥注入Spring环境：

logging:
  level:
    org.springframework.cloud.vault: DEBUG
    org.springframework.vault: DEBUG

启动后检查日志中是否有Vault请求记录，以及返回的username、password是否被正确解析。

5. 检查版本兼容性 #

确认spring-cloud-starter-vault-config（4.1.2）、spring-vault-core（3.1.2）与Spring Boot版本的兼容性。例如Spring Boot 3.2.x对应Spring Cloud 2023.0.x版本，版本不匹配可能导致配置加载异常。

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