Spring Boot中@ConfigurationProperties类内Bean调用字段报NPE问题求助

核心原因 #

你的代码出现NPE是因为**@Configuration类中的@Bean方法执行时机早于@ConfigurationProperties的属性绑定**：Spring会先执行@Configuration类里的@Bean方法创建Bean，之后才会完成配置属性的注入，所以此时users变量还未被赋值，仍是null。

正确实现方案 #

步骤1：修正UserData类的注解

移除冗余注解，只保留必要的配置属性绑定相关注解，确保Spring能正确完成属性注入：

@Data
@NoArgsConstructor
@Component // 让Spring将此类作为Bean管理
@ConfigurationProperties(prefix = "") // 因users是application.yml中的顶级属性，前缀设为空
public class UserData {
    private Map<String, Integer> users;
}

步骤2：将getOldestUser Bean移至独立配置类

创建单独的@Configuration类，通过参数注入已完成属性绑定的UserData实例，这样Spring会确保UserData初始化完成后再执行Bean方法：

@Configuration
public class UserConfig {

    @Bean
    public String getOldestUser(UserData userData) {
        Map<String, Integer> users = userData.getUsers();
        // 先处理空值情况，避免NPE
        if (users == null || users.isEmpty()) {
            return null;
        }
        // 用Stream简化最大年龄用户的查找逻辑
        return users.entrySet()
                .stream()
                .max(Map.Entry.comparingByValue())
                .map(Map.Entry::getKey)
                .orElse(null);
    }
}

可选方案（若无需单独Bean） #

如果只是需要在UserData类内部获取最老用户，而非作为独立Bean注入其他组件，可以使用@PostConstruct注解，在属性绑定完成后执行初始化逻辑：

@Data
@NoArgsConstructor
@Component
@ConfigurationProperties(prefix = "")
public class UserData {
    private Map<String, Integer> users;
    private String oldestUser;

    @PostConstruct
    public void initOldestUser() {
        if (users != null && !users.isEmpty()) {
            oldestUser = users.entrySet()
                    .stream()
                    .max(Map.Entry.comparingByValue())
                    .map(Map.Entry::getKey)
                    .orElse(null);
        }
    }
}

额外注意事项 #

• 确保Lombok的@Data注解生效，已自动生成getter/setter方法（配置属性绑定依赖setter）；
• @EnableConfigurationProperties无需加在UserData类上，若未使用@Component，可在主启动类添加该注解并指定UserData.class，例如：@SpringBootApplication @EnableConfigurationProperties(UserData.class)。

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