Spring Boot多租户多环境配置文件匹配异常排查

以下是你遇到问题的常见原因和对应解决方案：

1. Profile未同时激活 #

Spring Boot的组合配置文件（如application-country_xx-development.yaml）需要同时激活对应的两个Profile才会被加载。如果只激活country_xx或development中的一个，组合文件不会生效，甚至单个租户/环境的配置文件也可能因优先级问题未覆盖通用配置。

解决方法：

• 启动时通过参数同时激活两个Profile：

  java -jar your-app.jar --spring.profiles.active=country_uk,development
  

• 或在通用配置文件application.yaml中指定激活的Profile：

  spring:
    profiles:
      active: country_uk,development
  

2. 配置文件命名不符合规则 #

确保配置文件的命名严格匹配Profile名称，注意大小写敏感、符号一致（比如下划线_不能写成连字符-）：

• 租户通用配置：application-country_uk.yaml（对应Profile country_uk）
• 环境通用配置：application-development.yaml（对应Profile development）
• 组合配置：application-country_uk-development.yaml（需同时激活country_uk和development）

3. @ConfigurationProperties配置错误 #

前缀与配置项不匹配 #

确保配置类的prefix属性与配置文件中的属性层级完全一致：
示例配置类：

@ConfigurationProperties(prefix = "tenant")
@Component // 或通过@EnableConfigurationProperties启用
public class TenantConfig {
    private String url;

    // 必须提供getter/setter
    public String getUrl() { return url; }
    public void setUrl(String url) { this.url = url; }
}

对应配置文件内容：

tenant:
  url: https://uk-dev.example.com

未启用配置属性绑定 #

如果未在配置类上添加@Component/@Configuration，需要在主启动类或配置类中添加@EnableConfigurationProperties(TenantConfig.class)来启用绑定。

4. 配置文件路径错误 #

确认配置文件放在src/main/resources目录下，打包后能在Jar包的BOOT-INF/classes目录中找到。如果配置文件放在外部路径，需通过spring.config.location参数指定加载路径。

5. 验证配置加载情况 #

开启Spring Boot的配置调试日志，查看哪些配置文件被加载：

• 添加启动参数：

  --logging.level.org.springframework.boot.context.config=DEBUG
  

• 启动后查看日志，搜索Loaded config file关键字，确认目标配置文件是否被成功加载。

配置加载优先级（从高到低） #

1. 命令行参数
2. 外部路径的application-{profile}.yaml
3. 应用内部的application-{profile}.yaml
4. 外部路径的application.yaml
5. 应用内部的application.yaml

其中组合Profile的配置文件优先级高于单个Profile的配置文件，比如application-country_uk-development.yaml > application-country_uk.yaml > application-development.yaml > application.yaml。

内容的提问来源于stack exchange，提问作者usr-local-ΕΨΗΕΛΩΝ