Spring Boot多环境配置：按目录拆分properties方案问询

我来帮你一步步实现这个配置拆分方案，完全适配你的Spring Boot项目需求：

1. 调整项目目录结构 #

首先按照你的要求重新组织src/main/resources目录，把通用配置、环境专属配置和资源文件分开存放，结构清晰维护更方便：

src/main/resources/
├── default/
│   ├── application.properties  # 所有环境共享的基础配置（始终加载）
│   ├── config.properties       # 通用配置模板（比如默认数据库连接、通用参数）
│   └── [可选] common-resource.jks  # 所有环境共用的证书（如果有）
├── local/
│   ├── application-local.properties  # Local环境专属配置，覆盖default中的同名属性
│   ├── config-local.properties       # Local环境的连接配置，覆盖default的config.properties
│   └── local-keystore.jks            # Local环境专属证书
├── dev/
│   ├── application-dev.properties
│   ├── config-dev.properties
│   └── dev-keystore.jks
├── test/
│   ├── application-test.properties
│   ├── config-test.properties
│   └── test-keystore.jks
└── prod/
    ├── application-prod.properties
    ├── config-prod.properties
    └── prod-keystore.jks

2. 配置Spring Boot的加载路径与优先级 #

要让default目录的配置始终加载，同时让激活的环境目录配置覆盖它，在default/application.properties中添加以下配置：

# 指定额外的配置加载目录：先加载default，再加载当前激活的环境目录（后面的目录优先级更高，会覆盖前面的）
spring.config.additional-location=classpath:/default/,classpath:/${spring.profiles.active}/

# 导入通用config.properties和当前环境的config-{profile}.properties
spring.config.import=classpath:/config.properties,classpath:/config-${spring.profiles.active}.properties

如果你的环境目录下的config文件直接叫config.properties（比如dev/config.properties），可以把spring.config.import改成：

spring.config.import=classpath:/config.properties,classpath:/${spring.profiles.active}/config.properties

这样Spring Boot会自动加载对应环境的config文件，并且环境专属的config会覆盖default中的通用config。

3. 激活对应环境的Profile #

你可以通过启动参数传递spring.profiles.active来指定要激活的环境，几种常见方式：

命令行启动 #

java -jar your-app.jar --spring.profiles.active=dev

IDE中运行 #

在VM options里添加：

-Dspring.profiles.active=local

Maven打包时指定（可选） #

如果用Maven插件打包，可以在pom.xml中配置默认激活的profile（不过建议还是通过启动参数灵活指定）：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <environmentVariables>
            <SPRING_PROFILES_ACTIVE>dev</SPRING_PROFILES_ACTIVE>
        </environmentVariables>
    </configuration>
</plugin>

4. 处理环境专属资源（如JKS文件） #

对于放在各环境目录下的JKS等资源文件，直接在对应环境的配置文件中用classpath路径引用即可。比如在local/application-local.properties中配置SSL证书：

server.ssl.key-store=classpath:/local/local-keystore.jks
server.ssl.key-store-password=your-local-ssl-password
server.ssl.key-alias=local-alias

当激活local profile时，Spring Boot会自动从classpath:/local/目录下找到这个JKS文件。

5. 属性绑定（@ConfigurationProperties & @Value） #

你的@ConfigurationProperties和@Value绑定逻辑完全不需要修改！因为Spring Boot已经把所有加载的配置属性合并成了一个统一的环境，绑定会自动获取到最终的覆盖后的值。

举个例子：

// 用@ConfigurationProperties绑定db前缀的属性
@ConfigurationProperties(prefix = "db")
public class DbProperties {
    private String url;
    private String username;
    private String password;

    // Getters & Setters
}

// 启用属性绑定
@Configuration
@EnableConfigurationProperties(DbProperties.class)
public class DatabaseConfig {
    @Autowired
    private DbProperties dbProperties;

    // 配置数据源等逻辑
}

或者用@Value直接注入：

@Service
public class UserService {
    @Value("${app.api.timeout}")
    private int apiTimeout;

    // 业务逻辑
}

6. 验证配置加载（可选） #

如果想确认配置是否正确加载、覆盖顺序是否符合预期，可以添加一个启动监听器来打印加载的配置源：

import org.springframework.boot.context.event.ApplicationEnvironmentPreparedEvent;
import org.springframework.context.ApplicationListener;
import org.springframework.core.env.ConfigurableEnvironment;
import org.springframework.core.env.MutablePropertySources;
import org.springframework.core.env.PropertySource;

public class ConfigLoadListener implements ApplicationListener<ApplicationEnvironmentPreparedEvent> {
    @Override
    public void onApplicationEvent(ApplicationEnvironmentPreparedEvent event) {
        ConfigurableEnvironment env = event.getEnvironment();
        System.out.println("=== 当前激活的Profile: " + String.join(", ", env.getActiveProfiles()) + " ===");
        MutablePropertySources sources = env.getPropertySources();
        System.out.println("=== 加载的配置源列表 ===");
        sources.forEach(source -> System.out.println("- " + source.getName()));
    }
}

然后在src/main/resources/META-INF/spring.factories中注册这个监听器：

org.springframework.context.ApplicationListener=com.yourpackage.ConfigLoadListener

启动项目时就能看到哪些配置文件被加载，确认覆盖逻辑是否正确。

• 配置优先级：环境专属目录的配置 > default目录的配置，所以只需要在环境目录中配置需要修改的属性，不需要重复所有通用配置。
• 缺失文件不报错：如果某个环境没有对应的配置文件（比如test环境不需要单独的config.properties），Spring Boot会自动忽略，不会抛出异常。
• 敏感信息：生产环境的密码、密钥等敏感信息建议用环境变量、Spring Cloud Config或者密钥管理工具存储，不要硬编码在配置文件中。

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