Spring通过@PropertySource可加载外部properties文件到Environment，支持classpath/file协议及占位符，需置于@Configuration类中且不支持YAML；常见问题包括路径错误、中文乱码（需指定UTF-8编码），推荐用spring.config.location或配置中心替代。
Spring 通过 @PropertySource 可以将自定义的外部属性文件（如 application-dev.properties、config/db.properties 等）加载进 Spring 的 Environment，从而让 @Value、@ConfigurationProperties 等注解能读取到这些配置。关键在于路径写法、加载时机和优先级控制。
指定外部文件路径的几种写法
路径支持 classpath、file 协议，也支持占位符动态解析：
-
classpath:custom.properties—— 从 classpath 根目录加载（如src/main/resources） -
file:/opt/config/app.properties—— 绝对路径，读取服务器本地文件 -
file:${CONFIG_HOME}/app.properties—— 使用系统属性或环境变量动态拼接路径 -
classpath:config/${profile}.properties—— 结合 profile 动态加载（需确保${profile}已定义）
在配置类中正确声明 @PropertySource
必须放在被 @Configuration 注解标记的类上，且不能用于普通 Bean 类；推荐配合 @Profile 或条件注解使用：
@Configuration
@PropertySource("file:/etc/myapp/app.properties")
@Profile("prod")
public class ProdConfig {
// ...
}
注意：@PropertySource 不支持 YAML 文件，只识别 .properties 和 .xml（后者极少用）；若要用 YAML，需借助 YamlPropertySourceFactory 自定义实现。
立即学习“Java免费学习笔记（深入）”；
解决找不到文件或乱码问题
常见报错如 IOException: Could not open class path resource 或中文乱码，可按以下方式处理：
- 确认文件真实存在且路径拼写正确（Linux 区分大小写，Windows 注意反斜杠转义）
- 若文件含中文，显式指定编码：
@PropertySource(value = "file:/path/app.properties", encoding = "UTF-8") - 避免在
@SpringBootApplication主类上直接加@PropertySource，因为主类可能早于 PropertySource 加载器初始化，建议单独建配置类 - 多个
@PropertySource存在时，后声明的覆盖同名 key（即“后加载者优先”），但不推荐依赖此行为，应统一管理配置来源
替代方案：更灵活的外部化配置方式
对于生产环境，@PropertySource 适合少量固定扩展配置；大规模或动态场景建议用更健壮的方式：
- 启动参数：
--spring.config.location=file:/etc/myapp/，直接接管整个配置加载链 - 环境变量：
SPRING_CONFIG_LOCATION=file:/etc/myapp/ - 使用
ConfigurableEnvironment编程式添加：environment.getPropertySources().addLast(new ResourcePropertySource(...)) - 集成 Spring Cloud Config 或 Nacos 等配置中心，实现远程、动态、版本化管理
