Spring Boot Config Server响应客户端请求时未加载Vault配置的求助

问题现象 #

客户端以应用名silent、profile dev调用Config Server时，仅返回Git仓库中的配置，Vault中的对应配置未被加载。已确认Vault密钥存在、token有效，单独测试Vault连接正常，Config Server直接连接Vault也能加载配置。

配置文件 #

pom.xml #

<project>
  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.4.2</version>
  </parent>

  <groupId>pl.silent</groupId>
  <artifactId>config-server</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>jar</packaging>

  <name>config-server</name>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <dependencies>
    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-config-server</artifactId>
    </dependency>
  </dependencies>

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

application.yml #

server:
  port: 6611

spring:
  application:
    name: config-server
  profiles:
    active: git, vault
  cloud:
    config:
      server:
        vault:
          host: 127.0.0.1
          port: 8200
          authentication: token
          token: test
          order: 1
        git:
          uri: file://${user.home}/application-configuration
          search-paths: '{application}'
          default-label: master
          username: test
          password: test
          order: 2

排查与解决方案 #

1. 验证Vault路径匹配 #

Spring Cloud Config Server默认从以下路径读取Vault配置：

• secret/{application}/{profile}
• secret/{application}

确认Vault中存在secret/silent/dev或secret/silent路径的密钥。如果使用自定义Vault后端，需配置spring.cloud.config.server.vault.backend指定后端名称。

2. 适配Vault KV版本 #

若使用Vault KV v2引擎，必须添加KV版本配置，否则会按v1逻辑查询导致路径不匹配：

spring:
  cloud:
    config:
      server:
        vault:
          kv-version: 2

3. 调整配置合并策略 #

即使Vault优先级设为order:1，若Git配置覆盖了Vault配置，需调整合并规则确保远程配置生效：

spring:
  cloud:
    config:
      server:
        override-none: false
        override-system-properties: false

4. 启用调试日志追踪请求 #

添加日志配置，查看Config Server是否发起Vault请求及是否有错误：

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

启动服务后，检查日志中是否有Vault相关请求记录，例如Fetching config from Vault at secret/silent/dev，若没有则说明路径匹配或配置存在问题；若有错误日志，根据提示修复。

5. 确认客户端请求端点 #

确保客户端调用的端点为http://{config-server-ip}:6611/silent/dev，正确传递应用名和profile参数，错误的端点会导致Config Server无法触发对应Vault路径的查询。

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