Spring Boot WebClient超类字段反序列化为子类问题求助

要解决WebClient将AnimalData中的animalSpec字段反序列化为具体子类（Cat/Dog）的问题，核心是让Jackson识别子类类型，并确保WebClient正确使用配置好的ObjectMapper。以下是两种可行方案：

方案一：使用Jackson类型注解（推荐，需API返回类型标识字段） #

如果API返回的animalSpec包含类型标识字段（比如type，值为cat/dog），可以通过Jackson的注解直接配置类型映射：

1. 修改父类Animal，添加类型注解：

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

@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    include = JsonTypeInfo.As.PROPERTY,
    property = "type" // 与API返回的类型字段名保持一致
)
@JsonSubTypes({
    @JsonSubTypes.Type(value = Cat.class, name = "cat"), // 映射类型值到子类
    @JsonSubTypes.Type(value = Dog.class, name = "dog")
})
public class Animal {
    protected String sound;

    public Animal() {}

    public String getSound() { return sound; }
    public void setSound(String sound) { this.sound = sound; }
}

2. 配置WebClient使用Spring容器中的ObjectMapper：
   确保WebClient的编码器/解码器使用正确的ObjectMapper，避免默认实例覆盖配置：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.codec.json.Jackson2JsonDecoder;
import org.springframework.http.codec.json.Jackson2JsonEncoder;
import org.springframework.web.reactive.function.client.WebClient;

@Configuration
public class WebClientConfig {

    @Bean
    public WebClient webClient(ObjectMapper objectMapper) {
        return WebClient.builder()
                .codecs(configurer -> {
                    configurer.defaultCodecs().jackson2JsonEncoder(new Jackson2JsonEncoder(objectMapper));
                    configurer.defaultCodecs().jackson2JsonDecoder(new Jackson2JsonDecoder(objectMapper));
                })
                .build();
    }
}

方案二：自定义反序列化器（无类型标识字段时使用） #

如果API返回的animalSpec没有明确类型字段，可以通过子类独有的字段（比如Cat的catHouseNumber、Dog的dogDesc）来判断类型：

1. 编写自定义反序列化器：

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.JsonDeserializer;
import com.fasterxml.jackson.databind.JsonNode;

import java.io.IOException;

public class AnimalDeserializer extends JsonDeserializer<Animal> {

    @Override
    public Animal deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        JsonNode node = p.getCodec().readTree(p);
        // 根据独有的字段判断子类类型
        if (node.has("catHouseNumber")) {
            return p.getCodec().treeToValue(node, Cat.class);
        } else if (node.has("dogDesc")) {
            return p.getCodec().treeToValue(node, Dog.class);
        }
        // 无匹配时返回父类或抛出异常
        return p.getCodec().treeToValue(node, Animal.class);
    }
}

2. 在父类Animal上指定反序列化器：

import com.fasterxml.jackson.databind.annotation.JsonDeserialize;

@JsonDeserialize(using = AnimalDeserializer.class)
public class Animal {
    protected String sound;

    public Animal() {}

    public String getSound() { return sound; }
    public void setSound(String sound) { this.sound = sound; }
}

3. 同样配置WebClient使用该ObjectMapper（同方案一的WebClientConfig）。

注意事项 #

• 检查AnimalData类中的name字段：当前定义为int类型，如果API返回的name是字符串，会导致反序列化失败，建议修正为String name。
• 确保自定义的ObjectMapper被Spring容器管理，且WebClient明确引用该实例，避免使用默认的独立ObjectMapper。

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