Spring Boot属性文件加载约定
spring boot设计了一套灵活且强大的外部配置机制，其中应用程序属性文件（application.properties或application.yml）的加载是其核心。spring boot在启动时，会按照特定的顺序和位置查找这些配置文件，并将其内容添加到spring environment中。对于application.properties文件，spring boot默认会从以下位置查找：
- 当前目录下的/config子目录。
- 当前目录。
- classpath下的/config包。
- classpath根目录。
这些位置的查找顺序决定了配置的优先级，后加载的配置会覆盖先加载的同名属性。对于特定环境的配置文件，例如application-dev.properties或application-prod.properties，Spring Boot也会在上述相同的默认位置进行查找。
自定义路径的常见误区
许多开发者在组织项目时，可能会尝试将不同环境的配置文件（如application-dev.properties、application-prod.properties）放置在自定义的子目录中，例如src/main/resources/properties。然而，正如Spring Boot文档所明确指出的，其默认的属性文件查找机制并不会自动扫描任意的自定义子目录。
当您在src/main/resources/application.properties中设置spring.profiles.active=dev，但将application-dev.properties放在src/main/resources/properties目录下时，Spring Boot将无法找到并加载该配置文件。即使尝试通过自定义@Configuration类和PropertySourcesPlaceholderConfigurer来手动指定资源路径，也往往难以解决此问题，因为PropertySourcesPlaceholderConfigurer主要用于加载额外的、非Spring Boot核心配置机制管理的属性文件，而非改变Spring Boot识别application-{profile}.properties的默认行为。
解决方案一：遵循约定（推荐）
最简单、最推荐的解决方案是遵循Spring Boot的约定，将application-{profile}.properties文件放置在Spring Boot默认查找的位置。对于Maven或Gradle项目，这意味着将它们直接放在src/main/resources目录下，使其位于classpath的根目录。
项目结构示例：
src/main/java/
└── com/example/myapp/
└── MyApplication.java
src/main/resources/
├── application.properties # 基础配置，可设置默认profile
├── application-dev.properties # 开发环境配置
├── application-prod.properties # 生产环境配置
└── static/
└── templates/application.properties内容示例：
# 可以在此处设置一个默认的激活profile，如果未通过其他方式指定 # spring.profiles.active=dev server.port=8080
application-dev.properties内容示例：
server.port=8081 spring.datasource.url=jdbc:mysql://localhost:3306/dev_db spring.datasource.username=devuser spring.datasource.password=devpass
application-prod.properties内容示例：
server.port=8080 spring.datasource.url=jdbc:mysql://prod-db-host:3306/prod_db spring.datasource.username=produser spring.datasource.password=prodpass
激活特定环境配置：
您可以通过以下几种方式激活特定环境的配置：
-
在application.properties中设置：
spring.profiles.active=dev
-
通过命令行参数：
java -jar your-app.jar --spring.profiles.active=dev
-
通过环境变量：
export SPRING_PROFILES_ACTIVE=dev java -jar your-app.jar
解决方案二：通过 spring.config.location 指定额外路径
如果由于特定原因，您确实需要将配置文件放置在非默认的自定义位置，可以使用spring.config.location属性来指定额外的配置目录或文件。这个属性允许您添加一个逗号分隔的目录或文件路径列表，Spring Boot会从这些位置加载配置。
示例场景： 假设您的配置文件位于src/main/resources/properties目录下。
项目结构：
src/main/resources/
├── application.properties
└── properties/
├── application-dev.properties
└── application-prod.propertiesapplication.properties配置：
为了让Spring Boot知道去properties/目录查找，您需要在application.properties中或通过其他外部方式（如命令行、环境变量）指定spring.config.location。
# application.properties (在src/main/resources/) # 可以在此处设置默认profile # spring.profiles.active=dev # 指定额外的配置位置。classpath:properties/ 表示查找classpath下的properties目录 spring.config.location=classpath:/properties/,classpath:/
这里classpath:/是必要的，因为它确保Spring Boot仍然会加载src/main/resources下的application.properties本身。classpath:/properties/则指示Spring Boot去properties子目录中查找其他配置文件。
注意事项：
- spring.config.location可以接受文件路径（如file:/opt/config/app.properties）和目录路径（如file:/opt/config/）。
- 当指定目录时，Spring Boot会在该目录下查找application.properties及其profile特定版本。
- 使用spring.config.location时，默认的查找位置仍然有效。新指定的位置会作为额外的查找点，并根据其在列表中的顺序或配置优先级进行加载。
- 最佳实践是尽量保持spring.config.location的简洁性，避免过度复杂的路径配置，这会增加理解和维护的难度。
总结
Spring Boot的外部配置机制强大而灵活，但其核心在于“约定优于配置”。对于大多数场景，将application-{profile}.properties文件直接放置在src/main/resources目录下是最佳实践，它利用了Spring Boot的默认查找机制，简化了配置管理。如果确实存在需要自定义配置路径的特殊需求，spring.config.location提供了一个标准且有效的方法来扩展Spring Boot的配置查找范围。理解这些机制有助于避免常见的配置问题，并构建健壮、易于维护的Spring Boot应用程序。
