Spring Boot中@Value注入失败，无法创建Bean问题求助

配置文件内容 #

src/main/resources/application.properties 内容如下：

overall.score=80
name.score=91
address.score=30

关于 PropertySourcesPlaceholderConfigurer 的说明 #

先看你写的配置类代码：

@Configuration
@PropertySource("classpath:application.properties")
public class PropertiesConfiguration {

  @Value("${overall.score}")
  private String overallScore;

  @Bean
  public String overallScore() {
   return overallScore;
  }

  @Bean
  public static PropertySourcesPlaceholderConfigurer propertySourcesPlaceholderConfigurer() {
   return new PropertySourcesPlaceholderConfigurer();
  }
}

• 作用：这是Spring的配置后置处理器，负责把@Value里的${...}占位符替换成配置文件里的实际值。
• 必要性：Spring Boot 1.5及之后版本已经自动注册了这个Bean，完全不需要手动定义，手动加反而可能引发配置加载顺序冲突。

问题1：NoSuchBeanDefinitionException 异常 #

你写的MatchThresholds组件抛出了这个异常：

@Component
public class MatchThresholds {

  @Autowired
  private String overallScore;

}

异常原因 #

你在配置类里用@Bean定义了名为overallScore的String类型Bean，但存在两个问题：

1. @Value注入overallScore字段的时机晚于overallScore()方法的执行，导致这个Bean返回的是null，Spring可能无法正常识别并注册这个有效Bean；
2. 即便Bean能注册，Spring容器中如果有多个String类型Bean，注入时需要明确指定Bean名称或用@Qualifier标注，否则Spring不知道该注入哪个。

问题2：直接在@Component中用@Value返回null #

你尝试的代码如下：

@Component
@PropertySource("classpath:application.properties")
public class MatchThresholds {

  @Value("${overall.score}")
  private String overallScore;

  @Bean
  public String overallScore() {
   return overallScore;
  }
}

问题原因 #

1. @PropertySource一般用于@Configuration类，虽然能放在@Component上，但Spring对组件类上的@PropertySource处理时机靠后，导致解析@Value时配置文件还没加载，所以变量为null；
2. 同样存在@Bean方法执行过早的问题：overallScore()方法执行时，@Value还没完成注入，返回的自然是null。

正确解决方案 #

方案1：最简方式——直接在组件中用@Value #

Spring Boot默认会自动加载application.properties，完全不需要额外配置类，直接在组件里用@Value即可：

@Component
public class MatchThresholds {

  @Value("${overall.score}")
  private String overallScore;

  // 可以添加getter方法或直接使用该变量
}

方案2：更优雅的批量绑定——@ConfigurationProperties #

如果有多个配置项，推荐用这个注解批量绑定，结构更清晰：

1. 定义配置类：

@Configuration
@ConfigurationProperties(prefix = "overall")
public class OverallProperties {
  private int score; // 对应配置文件中的overall.score

  // 必须添加getter/setter
  public int getScore() {
    return score;
  }

  public void setScore(int score) {
    this.score = score;
  }
}

2. 在组件中注入（推荐构造方法注入，更符合Spring规范）：

@Component
public class MatchThresholds {

  private final OverallProperties overallProperties;

  public MatchThresholds(OverallProperties overallProperties) {
    this.overallProperties = overallProperties;
  }

  // 使用时调用overallProperties.getScore()即可拿到配置值
}

方案3：修复原配置类（不推荐，过于繁琐） #

如果一定要通过@Bean暴露配置值，调整代码确保注入时机正确：

@Configuration
@PropertySource("classpath:application.properties")
public class PropertiesConfiguration {

  @Bean
  public String overallScore(@Value("${overall.score}") String overallScore) {
    return overallScore;
  }
}

然后在组件中明确指定Bean名称：

@Component
public class MatchThresholds {

  @Autowired
  @Qualifier("overallScore")
  private String overallScore;
}

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