SpringBoot 3.1.2中TagVO数组参数绑定报错：无唯一构造函数

问题根源 #

错误java.lang.IllegalStateException: No primary or single unique constructor found for class [Ldsawmain.entity.vo.TagVO;本质是Spring无法实例化TagVO数组/集合，核心原因要么是单个TagVO类缺少合法构造函数，要么是接口参数的绑定方式错误。

具体解决步骤 #

1. 修正接口参数的绑定注解 #

@ModelAttribute仅适用于表单参数绑定，若你要接收JSON格式的数组，必须改用@RequestBody：

// 错误写法（无注解或误用@ModelAttribute）
public String addTranslation(TagVO[] tags) { ... }

// 正确写法（推荐用List更灵活）
public String addTranslation(@RequestBody List<TagVO> tags) { ... }
// 或数组形式
public String addTranslation(@RequestBody TagVO[] tags) { ... }

2. 确保TagVO类有合法构造函数 #

Spring实例化VO类时，必须能通过无参构造或唯一带参构造创建对象：

• 手动添加无参构造：

public class TagVO {
    private String tagName;
    // 必须保留无参构造
    public TagVO() {}
    // 可选：带参构造
    public TagVO(String tagName) {
        this.tagName = tagName;
    }
    // 必须提供getter/setter
    public String getTagName() { return tagName; }
    public void setTagName(String tagName) { this.tagName = tagName; }
}

• 用Lombok简化（需先引入Lombok依赖）：

import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@NoArgsConstructor
public class TagVO {
    private String tagName;
}

3. 检查Postman请求格式 #

• 请求头必须设置Content-Type: application/json
• 请求体需为标准JSON数组格式：

[
    {"tagName": "Java"},
    {"tagName": "SpringBoot"}
]

4. 处理构造函数歧义（若存在） #

如果TagVO有多个带参构造函数，Spring会因无法确定使用哪个而报错，此时可以：

• 删除多余的带参构造，只保留一个；
• 用@ConstructorProperties注解指定主构造函数：

public class TagVO {
    private String tagName;

    @ConstructorProperties({"tagName"})
    public TagVO(String tagName) {
        this.tagName = tagName;
    }

    public TagVO() {}
}

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