Spring Boot中YAML配置文件无法读取问题求助

Hey Vlad，我帮你梳理了代码和配置，找到了两个导致设备数据无法正确加载的关键问题：

1. 属性绑定的Getter/Setter名称不匹配 #

你的DeviceYml类中定义的集合属性是private List<DevicesList> list，但对应的Getter是getDevices()、Setter是setDevices()。Spring Boot的@ConfigurationProperties是通过JavaBean的标准属性名来绑定配置的，配置里的路径是devices.list，所以必须对应属性list的标准Getter/Setter方法：getList()和setList()，而不是getDevices()/setDevices()。这个错误会直接导致Spring无法识别配置中的devices.list节点，自然无法注入数据。

2. 字段类型不匹配 #

观察YAML配置里的value字段，每个设备的value都是单个字符串值（比如boolean、Double、SmartBulbValue），但你在DevicesList内部类中将value定义成了List<String>类型。Spring无法把单个字符串值注入到List类型的字段中，这也是数据加载失败的重要原因。

修正后的代码示例 #

DeviceYml类

@Component
@ConfigurationProperties("devices")
public class DeviceYml {
    private List<DevicesList> list = new ArrayList<>();
    
    // 修正Getter/Setter，匹配属性名list
    public List<DevicesList> getList() {
        return list;
    }
    
    public void setList(List<DevicesList> list) {
        this.list = list;
    }
    
    public static class DevicesList {
        private String id;
        private String type;
        // 将value类型改为String，匹配YAML中的单个值
        private String value;
        private String name;
        
        // 标准的Getter/Setter方法
        public String getId() {
            return id;
        }

        public void setId(String id) {
            this.id = id;
        }

        public String getType() {
            return type;
        }

        public void setType(String type) {
            this.type = type;
        }

        public String getValue() {
            return value;
        }

        public void setValue(String value) {
            this.value = value;
        }

        public String getName() {
            return name;
        }

        public void setName(String name) {
            this.name = name;
        }

        @Override
        public String toString() {
            return "DevicesList{" +
                    "id='" + id + '\'' +
                    ", type='" + type + '\'' +
                    ", value='" + value + '\'' +
                    ", name='" + name + '\'' +
                    '}';
        }
    }

    @Override
    public String toString() {
        return "DeviceYml{" +
                "list=" + list +
                '}';
    }
}

额外验证与注意事项 #

• 确保配置处理器依赖（可选但推荐）：如果使用Spring Boot 2.2及以上版本，建议添加spring-boot-configuration-processor依赖，它能在IDE中提供配置提示，避免属性名拼写错误：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-configuration-processor</artifactId>
    <optional>true</optional>
</dependency>

• 验证配置加载结果：可以在启动类中注入DeviceYml并打印，确认数据是否正确加载：

@SpringBootApplication
public class YourApp implements CommandLineRunner {

    @Autowired
    private DeviceYml deviceYml;

    public static void main(String[] args) {
        SpringApplication.run(YourApp.class, args);
    }

    @Override
    public void run(String... args) {
        System.out.println("已加载的设备数据：" + deviceYml);
    }
}

• YAML格式检查：你的YAML配置中冒号后加空格的写法是合法的，但要确保层级缩进使用2个空格（不要用Tab键），否则会导致配置解析错误。

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