Spring Boot从application.yaml导入Bean Map值时出现空指针异常

当前实现的核心问题 #

• 类名拼写不匹配：@EnableConfigurationProperties中指定的是EmployeeMap.class，实际定义的配置类是EmployeesMap，Spring 无法找到对应注册类，配置注入全流程失效，这是空指针的核心诱因。
• YAML 语法不合法：配置中Map的键使用了带空格的裸值name surname，且重复定义了两次相同键，既不符合YAML语法规范，也没法被正确解析成Map结构。
• Bean注册方式冲突：配置类上同时加了@Component，又在外部通过@EnableConfigurationProperties指定类注册，两种注册方式混用容易导致Bean加载异常。
• 空指针触发逻辑：toString()方法中未做空判断，直接调用data.toString()，一旦data因为前面的绑定失败为null，就会直接抛出空指针。
• 测试方法逻辑错误：代码中调用的employeesMap.getEmployees()在EmployeesMap类里根本没有对应方法，本身就存在编译错误。

正确实现步骤 #

1. 修正合法的 application.yaml 配置 #

带空格的键必须用双引号包裹，不能出现重复键：

employees:
  data:
    "员工甲": "部门A"
    "员工乙": "部门B"

注：如果是无特殊字符的普通键，直接按照YAML缩进规则写就行，Spring Boot会自动把同层级下的键值对解析为Map结构。

2. 修正配置属性Bean类 #

二选一选择Bean注册方式，避免冲突，同时给属性加初始值、加判空逻辑：

// 方式一：直接加@Component注册，不需要额外写@EnableConfigurationProperties
@Component
@ConfigurationProperties(prefix = "employees")
public class EmployeesMap {
    // 给Map加默认初始化，避免无配置时直接为null
    private Map<String, String> data = new HashMap<>();

    public Map<String, String> getData() {
        return data;
    }

    public void setData(Map<String, String> data) {
        this.data = data;
    }

    @Override
    public String toString() {
        // 加判空，避免空指针
        return data == null ? "{}" : data.toString();
    }
}

3. 修正配置启用逻辑 #

如果选择用@EnableConfigurationProperties的方式注册配置类，就去掉类上的@Component，保证类名完全匹配：

// 类名要和实际定义的完全一致，不能少s、拼写错误
@EnableConfigurationProperties(EmployeesMap.class)
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

4. 修正测试读取方法 #

保证注入的Bean类型和定义一致，不要调用类里不存在的方法：

@RestController
public class ConfigTestController {
    @Autowired
    private EmployeesMap employeesMap;

    @GetMapping("/read-config")
    public ResponseEntity<Void> readConfig() {
        System.out.println("绑定的配置内容：" + employeesMap.toString());
        return ResponseEntity.accepted().build();
    }
}

绑定Map的注意事项 #

• 当Map的键包含空格、特殊符号、点号等特殊内容时，必须用双引号将整个键包裹，否则YAML解析会直接报错，配置无法加载。
• 不管用哪种注册方式，配置类的类名、前缀值、Bean类型一定要和实际定义完全匹配，差一个字母都会导致Spring找不到对应Bean，注入为null。
• 不要在重写的toString等方法里直接对可能为null的属性调用方法，简单的判空就能避免绝大多数运行时空指针。

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