Spring Boot中@ConfigurationProperties结合Java Record多构造函数引发的初始化失败及构造函数指定问题

你好！这个问题其实是Spring Boot配置属性绑定机制在面对Record多构造函数时的构造函数歧义导致的，我来帮你一步步分析解决：

问题原因分析 #

在你没有手动添加单参数构造函数之前，Java Record会自动生成一个和所有组件（name、age）匹配的全参构造函数。Spring Boot的@ConfigurationProperties绑定机制会自动识别这个默认构造，因为它的参数完全对应配置属性的键，所以可以正常初始化。

但当你手动添加了另一个单参数构造后，Record就存在两个构造函数了：此时Spring Boot无法自动判断应该用哪个构造来绑定配置，它会尝试 fallback 到无参构造函数——但Java Record本身是不生成无参构造的（因为Record设计为不可变类型，必须初始化所有组件），于是就抛出了NoSuchMethodException找不到无参构造的错误。

解决方案：用@ConstructorBinding标注目标构造函数 #

你提到@ConstructorBinding不能加在Record类上，没错，但它可以直接标注在Record的构造函数上！这正是解决构造函数歧义的关键——显式告诉Spring Boot：我要你用这个构造函数来初始化Record实例。

修改后的User Record代码如下：

@ConfigurationProperties("user")
record User(String name, int age) {
    // 给你想要用于配置绑定的全参构造函数添加@ConstructorBinding
    @ConstructorBinding
    public User(String name, int age) {
        this.name = name;
        this.age = age;
    }

    // 你的自定义单参数构造函数不受影响
    public User(String name) {
        this(name, 0);
    }
}

代码说明 #

1. 显式写出Record的全参构造函数：因为你加了自定义构造后，虽然默认全参构造依然存在，但需要显式标注@ConstructorBinding来指定它作为配置绑定的构造
2. 在全参构造上添加@ConstructorBinding：明确告诉Spring Boot，绑定配置属性时请使用这个构造函数
3. 自定义单参数构造函数可以正常保留：在其他业务代码场景中依然可以自由使用这个构造

修改后启动Spring Boot，就会正常读取application.properties中的user.name和user.age值，通过标注的全参构造初始化User实例，不会再出现无参构造找不到的错误。

额外注意事项 #

• 你的Spring Boot版本（3.4.2）完全支持这个用法：@ConstructorBinding在Spring Boot 2.2+就已引入，3.x版本对Record的支持更完善，完全兼容构造函数标注的方式
• 确保项目中已经配置了@EnableConfigurationProperties(DemoApplication.User.class)：这是让Spring扫描到这个配置类的必要条件

备注：内容来源于stack exchange，提问作者Sergiy