SpringBoot 2.7.1无法绑定application.yml对象列表属性问题排查

一共两处代码错误，和Spring Boot 2.7.1、Java 8的运行环境无关：

• 属性访问器命名不匹配：类中定义的字段是mappings，但get/set方法写的是getServers()、setServers()。Spring Boot做属性绑定默认遵循JavaBean规范，这组方法对应的属性名是servers，和配置文件里的mappings节点完全不对应，自然读不到配置值。
• 内部类缺少static修饰：Mapping是MappingProperties的非静态内部类，这类类默认隐式持有外部类实例的引用，没有公开的无参构造，Spring绑定属性时无法直接实例化Mapping对象，会导致列表元素注入失败。

只需要修改MappingProperties.java即可，配置文件、启动类的写法都是正确的：

1. 把mappings字段对应的get/set方法名修正为getMappings()、setMappings()，和配置节点名匹配
2. 给内部类Mapping加上static修饰，让Spring可以正常实例化
3. 可选：给两个类都补上toString()方法，方便直接打印查看注入结果，否则输出的是对象内存地址，容易误以为绑定失败

修正后的完整代码：

@ConfigurationProperties(prefix = "application")
public class MappingProperties {
    private List<Mapping> mappings;

    public List<Mapping> getMappings() {
        return mappings;
    }

    public void setMappings(List<Mapping> mappings) {
        this.mappings = mappings;
    }

    public static class Mapping {
        private String oldname;
        private String newname;

        public String getOldname() {
            return oldname;
        }

        public void setOldname(String oldname) {
            this.oldname = oldname;
        }

        public String getNewname() {
            return newname;
        }

        public void setNewname(String newname) {
            this.newname = newname;
        }

        @Override
        public String toString() {
            return "Mapping{" +
                    "oldname='" + oldname + '\'' +
                    ", newname='" + newname + '\'' +
                    '}';
        }
    }

    @Override
    public String toString() {
        return "MappingProperties{" +
                "mappings=" + mappings +
                '}';
    }
}

修改后重启项目，控制台就能正常打印出读取到的两组映射配置值。

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