如何解决Thymeleaf提交Spring Boot时抽象类实例化异常？

问题原因 #

提交表单时Spring抛出InstantiationException，是因为Spring MVC在将表单数据绑定到Garage对象时，需要初始化vehicules列表中的Vehicule实例，但Vehicule是抽象类，无法直接通过反射实例化。

修正步骤与解决方案 #

第一步：修复Thymeleaf表单的错误绑定 #

原表单存在两处逻辑错误，先修正：

1. 车轮循环应遍历当前车辆的wheels集合，而非车库的wheels（原代码中${garage.getWheels()}是错误的）
2. 复选框应绑定每个车轮的damaged布尔属性，而非整个wheels列表

修正后的表单代码：

<form id="garage"
      th:action="@{/save}"
      th:object="${garage}"
      method="post">
    <div th:each="vehicule, i : ${garage.vehicules}">
        <!-- 可选：如果用类型识别方案，添加隐藏字段标记车辆类型 -->
        <input type="hidden" 
               th:field="*{vehicules[__${i.index}__].type}" 
               th:value="${vehicule.getClass().getSimpleName().toLowerCase()}" />
        
        <ul>
            <li th:each="wheel, j : ${vehicule.wheels}">
                <input type="checkbox" 
                       th:field="*{vehicules[__${i.index}__].wheels[__${j.index}__].damaged}" />
                <label th:for="${#ids.prev('damaged')}" 
                       th:text="|车轮 ${j.index + 1}|">Label</label>
            </li>
        </ul>
    </div>
    <input type="submit" value="提交" /> 
    <input type="reset" value="重置" />
</form>

第二步：选择适合的抽象类实例化方案 #

方案1：提前在控制器中初始化具体子类实例

在渲染表单时，手动给Garage的vehicules列表填充具体的Car/Bike实例，避免Spring尝试实例化抽象类：

@Controller
public class GarageController {

    @GetMapping("/edit")
    public String showGarageForm(Model model) {
        Garage garage = new Garage();
        
        // 直接添加具体子类实例，而非抽象类
        Car car = new Car();
        // 给汽车初始化4个车轮
        car.setWheels(Arrays.asList(new Wheel(), new Wheel(), new Wheel(), new Wheel()));
        
        Bike bike = new Bike();
        // 给自行车初始化2个车轮
        bike.setWheels(Arrays.asList(new Wheel(), new Wheel()));
        
        garage.getVehicules().add(car);
        garage.getVehicules().add(bike);
        
        model.addAttribute("garage", garage);
        return "garage-form";
    }

    @PostMapping("/save")
    public String saveGarage(@ModelAttribute Garage garage) {
        // 处理车库数据的保存逻辑
        return "redirect:/success";
    }
}

方案2：使用Jackson类型注解自动识别子类

如果需要支持动态添加不同类型的车辆，可通过Jackson注解让Spring自动识别并实例化具体子类：

1. 在抽象类Vehicule上添加类型识别注解：

import com.fasterxml.jackson.annotation.JsonTypeInfo;
import com.fasterxml.jackson.annotation.JsonSubTypes;

@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    include = JsonTypeInfo.As.PROPERTY,
    property = "type" // 对应表单中隐藏字段的name
)
@JsonSubTypes({
    @JsonSubTypes.Type(value = Car.class, name = "car"),
    @JsonSubTypes.Type(value = Bike.class, name = "bike")
})
public abstract class Vehicule {
    private List<Wheel> wheels;
    // getter、setter方法
}

2. 确保Car和Bike类有默认无参构造器（Spring绑定需要）
3. 表单中已添加的type隐藏字段会传递车辆类型，Spring会根据注解自动实例化对应子类

方案3：自定义属性编辑器

通过自定义PropertyEditor告诉Spring如何将表单数据转换为具体的Vehicule子类：

1. 实现属性编辑器：

import org.springframework.beans.propertyeditors.PropertyEditorSupport;

public class VehiculeTypeEditor extends PropertyEditorSupport {
    @Override
    public void setAsText(String type) throws IllegalArgumentException {
        switch(type.toLowerCase()) {
            case "car":
                setValue(new Car());
                break;
            case "bike":
                setValue(new Bike());
                break;
            default:
                throw new IllegalArgumentException("未知车辆类型：" + type);
        }
    }
}

2. 在控制器中注册编辑器：

@Controller
public class GarageController {

    @InitBinder
    public void initVehiculeEditor(WebDataBinder binder) {
        binder.registerCustomEditor(Vehicule.class, new VehiculeTypeEditor());
    }

    // 其余控制器方法同方案1，表单需传递type字段
}

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