如何配置Spring Config Server搜索路径以从自定义目录拉取配置

问题本质 #

你的Git仓库采用项目/客户/客户-环境.yml的层级结构，但Spring Cloud Config默认的搜索逻辑和URL参数映射不匹配这种结构，导致请求找不到配置文件，必须通过searchPaths结合路径模式配置来解决。

关键配置调整 #

1. 配置路径模式（patterns）：自定义URL路径参数的含义，让请求中的projectA对应项目、customerx对应客户、dev对应环境。
2. 配置搜索路径（searchPaths）：使用占位符指定Config Server去对应项目和客户的目录下搜索配置文件。

完整的Config Server配置如下：

spring:
  cloud:
    config:
      server:
        git:
          uri: git@repo.com/myconfigrepo.git
          # 指定搜索路径：项目目录下的客户目录
          searchPaths: '{project}/{customer}'
        # 自定义URL路径模式，映射路径参数为project、customer、profile
        patterns:
          - '{project}/{customer}/{profile}'

请求验证 #

配置完成后，原请求 curl http://localhost:8080/projectA/customerx/dev 就能正确找到projectA/customerx/customerx-dev.yml配置文件。

补充说明 #

• 配置文件命名必须符合{customer}-{profile}.yml格式（比如customerx-dev.yml对应customer=customerx、profile=dev），这样Config Server才能正确匹配。
• 如果Git仓库有多个分支，可以在请求末尾加上分支名，比如curl http://localhost:8080/projectA/customerx/dev/master。

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