如何基于x-www-form-urlencoded实现抽象类的子类反序列化？

问题根源 #

Jackson的@JsonTypeInfo和@JsonSubTypes仅对JSON格式请求生效，因为x-www-form-urlencoded请求的解析由Spring的FormHttpMessageConverter（而非Jackson的JSON转换器）处理。Spring默认无法自动确定抽象类对应的具体实现类，因此尝试实例化抽象类时抛出InstantiationException。

前置修正 #

首先确保你的实现类继承抽象类（你的示例中ConcreteClazz未继承AbstractClazz，这是基础错误）：

public class ConcreteClazz extends AbstractClazz {
    private String value;
    // getter、setter
}

实现方案：自定义参数解析器 #

通过实现Spring MVC的HandlerMethodArgumentResolver，手动根据discriminator参数确定具体实现类，再完成请求参数绑定。

1. 自定义参数解析器类

public class AbstractClazzArgumentResolver implements HandlerMethodArgumentResolver {

    // 自动读取抽象类上的@JsonSubTypes注解生成映射，避免硬编码
    private static final Map<String, Class<? extends AbstractClazz>> DISCRIMINATOR_CLASS_MAP = new HashMap<>();

    static {
        JsonSubTypes subTypes = AbstractClazz.class.getAnnotation(JsonSubTypes.class);
        if (subTypes != null) {
            for (JsonSubTypes.Type type : subTypes.value()) {
                DISCRIMINATOR_CLASS_MAP.put(type.name(), (Class<? extends AbstractClazz>) type.value());
            }
        }
    }

    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        // 仅处理AbstractClazz及其子类类型的参数
        return AbstractClazz.class.isAssignableFrom(parameter.getParameterType());
    }

    @Override
    public Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer,
                                  NativeWebRequest webRequest, WebDataBinderFactory binderFactory) throws Exception {
        // 从请求中获取鉴别器参数
        String discriminator = webRequest.getParameter("discriminator");
        if (discriminator == null || !DISCRIMINATOR_CLASS_MAP.containsKey(discriminator)) {
            throw new IllegalArgumentException("无效的discriminator值：" + discriminator);
        }

        // 实例化对应的具体子类
        Class<? extends AbstractClazz> targetClass = DISCRIMINATOR_CLASS_MAP.get(discriminator);
        AbstractClazz instance = targetClass.getDeclaredConstructor().newInstance();

        // 使用Spring的DataBinder绑定所有请求参数到实例
        WebDataBinder binder = binderFactory.createBinder(webRequest, instance, parameter.getParameterName());
        binder.bind(new MutablePropertyValues(webRequest.getParameterMap()));

        // 处理参数绑定错误
        if (binder.getBindingResult().hasErrors()) {
            throw new BindException(binder.getBindingResult());
        }

        return instance;
    }
}

2. 注册参数解析器

在Spring Boot中，实现WebMvcConfigurer接口注册自定义解析器：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
        resolvers.add(new AbstractClazzArgumentResolver());
    }
}

原理说明 #

1. 自定义解析器首先判断当前请求参数是否为AbstractClazz类型，若是则进入处理流程。
2. 从请求参数中提取discriminator，匹配对应的具体实现类。
3. 实例化具体类后，利用Spring的DataBinder自动绑定所有请求参数到实例对象，保持和Spring默认参数绑定一致的行为。
4. 自动读取@JsonSubTypes注解的配置，无需重复维护鉴别器与类的映射关系。

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