SpringBoot中PropertySourcesPlaceholderConfigurer为何忽略属性文件值？

这个问题我之前在项目里也踩过坑，PropertySourcesPlaceholderConfigurer忽略属性值通常是由几个常见原因导致的，咱们一步步来排查：

1. 未正确声明PropertySourcesPlaceholderConfigurer Bean #

Spring需要你显式定义这个Bean才能让它加载并解析自定义属性文件，而且这个Bean的方法必须是static的——因为Spring在处理@Value注解之前，需要先初始化这个占位符配置器。

你可以在MysqlConfig类里添加这个Bean定义：

@Bean
public static PropertySourcesPlaceholderConfigurer propertySourcesPlaceholderConfigurer() {
    PropertySourcesPlaceholderConfigurer configurer = new PropertySourcesPlaceholderConfigurer();
    // 指定你的属性文件路径
    configurer.setLocations(new ClassPathResource("mysql.properties"));
    return configurer;
}

2. 自定义属性文件未被加载到Spring环境 #

如果没有告诉Spring要加载你的mysql.properties，它根本不知道这个文件的存在。你需要在MysqlConfig类上添加@PropertySource注解来指定属性文件位置：

@Configuration
@PropertySource("classpath:mysql.properties") // 加载自定义属性文件
public class MysqlConfig {
    // 你的其他配置代码...
}

3. Spring Boot自动配置的优先级冲突 #

Spring Boot默认会自动配置数据源（依赖spring-boot-starter-jdbc或spring-boot-starter-data-jpa时），它会优先读取application.properties/application.yml里的属性，甚至可能直接覆盖你自定义的数据源配置。

如果想完全用自己的MysqlConfig配置数据源，需要在启动类上排除自动配置的数据源类：

@SpringBootApplication(exclude = DataSourceAutoConfiguration.class)
public class MusicApplication {
    public static void main(String[] args) {
        SpringApplication.run(MusicApplication.class, args);
    }
}

4. @Value注解的使用或属性名冲突问题 #

• 检查你在MysqlConfig里的@Value占位符是否和属性文件里的键完全匹配，比如属性文件里是username = prospring5，那@Value应该写成@Value("${username}")。
• 注意username是系统内置属性，可能会被系统环境变量覆盖，建议给自定义属性加前缀，比如把属性文件改成：

  db.driverClassName = com.mysql.jdbc.Driver
  db.url = jdbc:mysql://localhost:3306/musicdb?useSSL=true
  db.username = prospring5
  db.password = prospring5
  

  然后@Value用@Value("${db.username}")这种形式，避免冲突。

5. 属性文件格式问题 #

虽然概率较低，但还是检查下mysql.properties里的键值对是否有格式错误：比如等号两边的空格是允许的，但如果有特殊字符、编码问题或者拼写错误，也会导致属性无法被读取。

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