Jackson多态反序列化生成的子类实例如何正确执行参数校验

Bean Validation（Jakarta Validation）规范默认仅校验属性声明的静态类型上的约束注解，你声明的是POIPage抽象父类类型，因此校验框架只会扫描POIPage类上定义的校验规则，不会自动识别运行时的实际子类类型，也不会加载子类上的约束注解。Jackson的@JsonTypeInfo、@JsonSubTypes注解仅负责反序列化阶段的类型识别，不参与校验逻辑，和当前问题无关。

提供两种可直接落地的实现方案：

方案1：自定义多态校验注解（通用方案，无框架依赖） #

不需要修改原有校验逻辑，仅新增自定义注解和对应校验器即可：

1. 定义多态校验注解@ValidPolymorphic

import jakarta.validation.*;
import java.lang.annotation.*;

@Target({ElementType.FIELD, ElementType.PARAMETER, ElementType.TYPE_USE})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = PolymorphicValidator.class)
public @interface ValidPolymorphic {
    String message() default "多态类型校验不通过";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

2. 实现对应校验器PolymorphicValidator

import jakarta.validation.*;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Component
public class PolymorphicValidator implements ConstraintValidator<ValidPolymorphic, Object> {
    @Autowired
    private Validator globalValidator;

    @Override
    public boolean isValid(Object value, ConstraintValidatorContext context) {
        if (value == null) {
            return true;
        }
        // 针对实际运行时类型触发全量校验
        Set<ConstraintViolation<Object>> violations = globalValidator.validate(value);
        if (violations.isEmpty()) {
            return true;
        }
        // 回写子类校验的错误信息到上下文
        context.disableDefaultConstraintViolation();
        for (ConstraintViolation<Object> violation : violations) {
            context.buildConstraintViolationWithTemplate(violation.getMessage())
                    .addPropertyNode(violation.getPropertyPath().toString())
                    .addConstraintViolation();
        }
        return false;
    }
}

3. 替换原有校验注解
   将PresentationPage类中的List<@Valid POIPage> poiPages修改为List<@ValidPolymorphic POIPage> poiPages即可生效。

方案2：Hibernate Validator 配置开启（适用于使用Hibernate Validator作为校验实现的场景） #

Hibernate Validator 6.1+ 提供了专用配置参数，开启后可自动识别参数化类型的运行时实际类型，加载对应类的约束注解，无需修改业务代码：

• Spring Boot 项目直接在application.properties中添加配置：

spring.jpa.properties.jakarta.persistence.validation.allow_parameterized_type_constraint_lookup=true

• 独立使用Hibernate Validator的场景，初始化时添加配置：

ValidatorFactory validatorFactory = Validation.byDefaultProvider()
        .configure()
        .addProperty("hibernate.validator.allow_parameterized_type_constraint_lookup", "true")
        .buildValidatorFactory();

• 方案1中注入的Validator必须是Spring容器初始化的全局单例，不要手动创建实例，避免重复初始化校验上下文导致性能损耗
• 需确保Jackson反序列化后的对象实际类型正确，没有出现多态类型丢失的问题，否则子类校验仍然不会触发

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