Spring MVC表单提交时出现ClassCastException问题

这个坑我之前踩过！核心原因是Spring MVC在处理GET请求的表单参数绑定时，默认没法根据你的type字段自动实例化对应的Traveller子类（Passenger/Vehicle），它会直接用父类Traveller创建实例，后续你强转成子类时自然就抛出ClassCastException了。

下面给你两种最实用的解决方法，优先推荐第一种，简单直接：

方法一：在FormObject的setType方法中初始化子类实例 #

这是最省心的方案，利用Spring绑定参数的顺序（先绑定type字段，再绑定traveller的属性），在setType里直接创建对应子类的实例：

public class FormObject {
    private String type;
    private Traveller traveller;

    // 关键：设置type时自动初始化对应的Traveller子类
    public void setType(String type) {
        this.type = type;
        if ("Passenger".equals(type)) {
            this.traveller = new Passenger();
        } else if ("Vehicle".equals(type)) {
            this.traveller = new Vehicle();
        }
        // 可以加个else分支处理非法type，避免null
    }

    // 其他getter/setter省略
}

这样当Spring处理GET请求参数时，会先调用setType创建正确的子类实例，后续绑定traveller的属性（比如passenger.name或vehicle.plateNumber）时，就会直接操作对应的子类对象，完全不会有类型转换问题。

方法二：自定义PropertyEditor/Converter（适合复杂场景） #

如果你的业务逻辑不允许在FormObject里耦合子类实例化逻辑，可以在Controller中注册自定义的属性编辑器，告诉Spring如何根据type创建子类：

步骤1：编写自定义PropertyEditor #

public class TravellerPropertyEditor extends PropertyEditorSupport {
    @Override
    public void setAsText(String type) throws IllegalArgumentException {
        switch (type) {
            case "Passenger":
                setValue(new Passenger());
                break;
            case "Vehicle":
                setValue(new Vehicle());
                break;
            default:
                throw new IllegalArgumentException("Invalid Traveller type: " + type);
        }
    }
}

步骤2：在Controller中注册编辑器 #

@Controller
public class TravellerFormController {

    @InitBinder
    public void initBinder(WebDataBinder binder) {
        // 给Traveller类型注册自定义编辑器
        binder.registerCustomEditor(Traveller.class, new TravellerPropertyEditor());
    }

    @GetMapping("/submit-travellers")
    public String handleSubmit(@ModelAttribute WrapperBean wrapperBean) {
        // 现在每个FormObject的traveller都是正确的子类实例，放心强转
        for (FormObject formObj : wrapperBean.getFormObjects()) {
            if ("Passenger".equals(formObj.getType())) {
                Passenger passenger = (Passenger) formObj.getTraveller();
                // 处理乘客逻辑
            } else {
                Vehicle vehicle = (Vehicle) formObj.getTraveller();
                // 处理车辆逻辑
            }
        }
        return "success-page";
    }
}

额外注意事项 #

• 确保GET请求的参数格式正确，列表形式的参数要带索引，比如：

  wrapperBean.formObjects[0].type=Passenger
  wrapperBean.formObjects[0].traveller.name=张三
  wrapperBean.formObjects[1].type=Vehicle
  wrapperBean.formObjects[1].traveller.plateNumber=京A12345
  

• 如果是用HTML表单提交，输入框的name属性要严格对应上述格式，比如第一个FormObject的type输入框name="formObjects[0].type"，乘客姓名输入框name="formObjects[0].traveller.name"。

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