Spring Boot无法读取Hashicorp Vault密钥问题求助

以下是针对你遇到的PlaceholderResolutionException: Could not resolve placeholder 'login'错误的排查步骤：

1. 确保Bootstrap配置加载生效 #

Spring Boot 3.x默认关闭了Spring Cloud的bootstrap阶段加载，而Spring Cloud Vault Config依赖此阶段读取Vault配置。需要添加bootstrap依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

2. 适配KV版本（重点排查） #

Hashicorp Vault dev模式默认启用KV v2，而旧教程可能基于KV v1，两者路径结构不同：

• KV v1的路径是secret/application
• KV v2的路径是secret/data/application（数据包裹在data字段下）

验证方式： #

用curl调用Vault API确认密钥位置：

curl -H "X-Vault-Token: YOUR_ROOT_TOKEN" http://localhost:8200/v1/secret/data/application

如果返回404，说明你在UI中存储的路径是KV v1格式，需要调整：

• 在Vault UI中创建密钥时，选择secret引擎，路径填application，确保数据以KV v2格式存储（UI会自动处理data字段包裹）
• 在application.properties中明确指定KV版本：

  spring.cloud.vault.kv.version=2
  

3. 修正依赖版本匹配 #

Spring Boot 3.4.x对应Spring Cloud 2023.0.3版本，用BOM统一管理版本避免冲突，同时移除多余的spring-vault-core依赖（spring-cloud-starter-vault-config已包含该依赖）：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2023.0.3</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-vault-config</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-bootstrap</artifactId>
    </dependency>
</dependencies>

4. 确认Vault配置正确性 #

• 检查spring.cloud.vault.uri是否和Vault实际端口一致（你提到UI地址是8020，但vault server -dev默认端口是8200，可能是笔误）
• 确保根令牌正确，用curl验证令牌权限：

  curl -H "X-Vault-Token: YOUR_ROOT_TOKEN" http://localhost:8200/v1/auth/token/lookup-self
  

5. 日志分析 #

查看启动日志中的Vault相关trace信息：

• 确认是否有Successfully connected to Vault的日志
• 确认是否有Loading config from Vault at: secret/application（或secret/data/application）的记录
• 检查是否有权限拒绝（403 Forbidden）的错误信息

6. 尝试@ConfigurationProperties替代@Value #

改用@ConfigurationProperties绑定属性，可能更稳定：

@Configuration
@ConfigurationProperties(prefix = "")
@Data
public class VaultConfiguration {
    private String login;
    private String password;
}

在Spring Boot主类添加：

@EnableConfigurationProperties(VaultConfiguration.class)

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