如何排查Spring中属性占位符'datasource.driver'的配置文件来源？

错误信息 #

Caused by: java.lang.IllegalArgumentException: Could not resolve placeholder 'datasource.driver' in value "${datasource.driver}"
    at org.springframework.util.PropertyPlaceholderHelper.parseStringValue(PropertyPlaceholderHelper.java:178)
    at org.springframework.util.PropertyPlaceholderHelper.replacePlaceholders(PropertyPlaceholderHelper.java:124)
    at org.springframework.beans.factory.config.PropertyPlaceholderConfigurer$PlaceholderResolvingStringValueResolver.resolveStringValue(PropertyPlaceholderConfigurer.java:230)
    at org.springframework.beans.factory.config.BeanDefinitionVisitor.resolveStringValue(BeanDefinitionVisitor.java:296)
    at org.springframework.beans.factory.config.BeanDefinitionVisitor.resolveValue(BeanDefinitionVisitor.java:217)
    at org.springframework.beans.factory.config.BeanDefinitionVisitor.visitPropertyValues(BeanDefinitionVisitor.java:147)
    at org.springframework.beans.factory.config.BeanDefinitionVisitor.visitBeanDefinition(BeanDefinitionVisitor.java:85)
    at org.springframework.beans.factory.config.PlaceholderConfigurerSupport.doProcessProperties(PlaceholderConfigurerSupport.java:225)

定位目标配置文件的方法 #

1. 查找占位符配置器的显式配置 #

找到项目中PropertyPlaceholderConfigurer或PropertySourcesPlaceholderConfigurer的配置（XML或Java配置类），这些组件的配置会明确指定Spring要加载的配置文件路径：

• XML配置示例：

  <bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
      <property name="locations">
          <list>
              <value>classpath:db.properties</value>
              <value>file:/conf/app.properties</value>
          </list>
      </property>
  </bean>
  

• Java配置类示例：

  @Bean
  public PropertySourcesPlaceholderConfigurer propertySourcesPlaceholderConfigurer() {
      PropertySourcesPlaceholderConfigurer configurer = new PropertySourcesPlaceholderConfigurer();
      configurer.setLocations(new ClassPathResource("db.properties"), new FileSystemResource("/conf/app.properties"));
      return configurer;
  }
  

locations字段中的路径就是Spring查找属性的目标文件。

2. 开启Spring调试日志定位加载文件 #

在JVM启动参数中添加-Dorg.springframework.logging.level=DEBUG，启动应用后查看日志，搜索Loading properties file或Loaded Environment关键词，日志会显示Spring实际加载的所有配置文件路径，例如：

DEBUG org.springframework.context.support.PropertySourcesPlaceholderConfigurer - Loading properties file from class path resource [db.properties]

3. 临时测试验证配置来源 #

在启动参数中添加-Ddatasource.driver=com.mysql.cj.jdbc.Driver临时指定属性值，如果错误消失，说明原配置文件中缺少该属性，或者Spring未加载到正确的配置文件。

4. 排查Spring Boot自动配置（若为Spring Boot项目） #

• 检查默认配置文件：application.properties/application.yml，以及激活的环境profile对应的配置文件（如application-dev.properties），Spring Boot默认会加载这些文件。
• 查看配置类上的@PropertySource注解，该注解会指定额外加载的配置文件，示例：

  @Configuration
  @PropertySource("classpath:custom-db.properties")
  public class DataSourceConfig { }
  

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