spring容器解析${key}占位符的核心是propertysourcesplaceholderconfigurer，spring boot默认自动配置，传统spring需手动注册；@propertysource仅注入属性源，不替代占位符解析。

Spring 容器加载外部属性占位符（如 ${key}）的核心是注册并启用 PropertySourcesPlaceholderConfigurer —— 它负责解析占位符、合并多源属性、处理默认值和类型转换。Spring Boot 默认已自动配置该类，但 Spring Framework（XML 或纯 Java 配置）需手动引入。

Spring Boot 项目：默认已生效，无需额外配置

只要把 application.properties 或 application.yml 放在 src/main/resources 下，@Value("${xxx}") 就能直接使用。Spring Boot 启动时会自动注册 PropertySourcesPlaceholderConfigurer（实际是其增强版 ConfigurationPropertySourcesPostProcessor），并加载所有标准配置源。

• 支持默认值写法：@Value("${db.port:3306}")
• 支持嵌套表达式：@Value("${profile.active:${spring.profiles.active:dev}}")
• 未定义且无默认值时，启动报错（IllegalArgumentException）

传统 Spring（非 Boot）：需显式注册 Bean

在基于 XML 或 Java Config 的老项目中，必须手动声明 PropertySourcesPlaceholderConfigurer Bean，否则 @Value 中的 ${} 不会被解析。

deep-java-review

Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...

下载

• XML 方式（推荐）：
  
  这行等价于注册一个 PropertySourcesPlaceholderConfigurer，自动支持通配符（classpath*:）和多个文件
• Java Config 方式：
  @Bean
  public static PropertySourcesPlaceholderConfigurer placeholderConfigurer() {
    PropertySourcesPlaceholderConfigurer configurer = new PropertySourcesPlaceholderConfigurer();
    configurer.setLocations(
      new ClassPathResource("db.properties"),
      new ClassPathResource("redis.properties")
    );
    configurer.setIgnoreUnresolvablePlaceholders(true);
    return configurer;
  }

加载自定义 properties 文件：@PropertySource 是补充，不是替代

@PropertySource 的作用是将指定文件内容“注入”到 Spring 的 Environment 属性源中，但它本身不触发占位符解析 —— 解析仍依赖 PropertySourcesPlaceholderConfigurer。

• 必须搭配 @Value 或 Environment.getProperty() 使用
• 常见写法：
  @Configuration
  @PropertySource("classpath:weixin.properties")
  public class WeixinConfig {
    @Value("${appid}") private String appid;
  }
• 若文件路径错误且 ignoreResourceNotFound = false（默认），启动失败；设为 true 可静默忽略
• 支持 UTF-8 编码防乱码：
  @PropertySource(value = "classpath:conf_zh.properties", encoding = "UTF-8")

高级控制：优先级、编码与容错

PropertySourcesPlaceholderConfigurer 提供细粒度控制，适用于复杂部署场景：

• 属性优先级：多个同名 key 出现在不同文件时，后注册的 source 覆盖先注册的（可通过 setOrder() 显式排序）
• 字符编码：中文属性易乱码，务必设置 fileEncoding = "UTF-8"（XML 中用 file-encoding 属性）
• 容错开关：ignoreUnresolvablePlaceholders = true 允许存在未定义的占位符（不推荐生产环境开启）
• 本地属性覆盖：可调用 setLocalProperties() 注入硬编码 Properties，配合 setLocalOverride(true) 让本地值优先于外部文件

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南