SpringBoot含多态实体Map的RequestBody序列化异常排查

你遇到的问题核心是OpenAPI的注解只负责生成API文档，不会自动配置Jackson的多态反序列化规则。你配置的anyOf和discriminatorProperty只是告诉Swagger/OpenAPI文档系统有哪些子类、用哪个字段区分，但Jackson本身不知道要根据parrotType字段去实例化具体的Parrot子类，所以还是会尝试构造抽象类Parrot的实例，直接抛出异常。

必须同时配置Jackson的多态序列化注解，配合OpenAPI的注解才能同时满足文档生成和反序列化的需求，具体步骤如下：

1. 给抽象类Parrot添加Jackson多态注解 #

在抽象类上通过Jackson注解指定类型识别规则，让Jackson知道如何根据parrotType字段选择具体子类：

import com.fasterxml.jackson.annotation.JsonSubTypes;
import com.fasterxml.jackson.annotation.JsonTypeInfo;
import io.swagger.v3.oas.annotations.media.Schema;

@Schema(
    discriminatorProperty = "parrotType",
    anyOf = {PolarParrot.class, NorwegianParrot.class}
)
// Jackson多态核心配置
@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME, // 用名称匹配子类
    include = JsonTypeInfo.As.PROPERTY, // 将类型字段作为请求体的一个属性
    property = "parrotType" // 对应OpenAPI配置的discriminatorProperty
)
@JsonSubTypes({
    @JsonSubTypes.Type(value = PolarParrot.class, name = "POLAR"), // 对应请求中parrotType的值
    @JsonSubTypes.Type(value = NorwegianParrot.class, name = "NORWEGIAN")
})
public abstract class Parrot {
    private String parrotType;
    // 其他公共字段、getter/setter
}

2. 子类配置（可选，补充OpenAPI描述） #

如果需要给子类添加更详细的API文档描述，可以在子类上添加@Schema注解：

@Schema(name = "POLAR", description = "极地鹦鹉")
public class PolarParrot extends Parrot {
    private Integer coldResistance;
    // getter/setter
}

@Schema(name = "NORWEGIAN", description = "挪威鹦鹉")
public class NorwegianParrot extends Parrot {
    private String favoriteFish;
    // getter/setter
}

3. Controller层的请求处理 #

如果你的RequestBody是包含多态Parrot的Map，直接声明Map类型即可，Jackson会根据配置自动解析：

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ParrotController {

    @PostMapping("/parrots")
    public String saveParrots(@RequestBody Map<String, Parrot> parrotsMap) {
        // 处理业务逻辑
        return "success";
    }
}

4. 测试请求示例 #

发送POST请求时，确保请求体中每个Parrot对象都包含parrotType字段，比如：

{
    "parrot1": {
        "parrotType": "POLAR",
        "coldResistance": 100
    },
    "parrot2": {
        "parrotType": "NORWEGIAN",
        "favoriteFish": "salmon"
    }
}

关键注意点 #

• Jackson的@JsonTypeInfo中的property必须和OpenAPI的discriminatorProperty完全一致，确保文档和实际反序列化规则统一。
• 如果你的parrotType字段值和子类名称不一致，一定要在@JsonSubTypes.Type的name属性中指定对应的值，不能省略。
• 若遇到泛型Map的反序列化问题，可以检查Jackson的版本（SpringBoot默认的Jackson版本一般都支持泛型多态解析，若版本过低可能需要升级）。

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