JSON反序列化适配问题：处理响应中company字段时而为对象时而为独立字段的场景

我之前也碰到过这种需要兼容不同JSON结构的头疼场景，你的问题核心在于company字段在两种JSON格式里分别是对象和字符串（companyName），类型不匹配导致反序列化失败——@JsonAlias只能解决字段名别名问题，没法处理类型差异，给你两个实用的解决方案：

方案一：自定义反序列化器（推荐，更灵活） #

你可以为Company类写一个自定义反序列化器，让它同时兼容对象和字符串两种格式：

1. 编写CompanyDeserializer类：

public class CompanyDeserializer extends JsonDeserializer<Person.Company> {
    @Override
    public Person.Company deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        JsonNode node = p.getCodec().readTree(p);
        Person.Company company = new Person.Company();
        
        if (node.isObject()) {
            // 处理对象格式的company，提取name字段
            company.setName(node.get("name").asText());
        } else if (node.isTextual()) {
            // 处理字符串格式的companyName，直接把字符串作为company的name值
            company.setName(node.asText());
        }
        return company;
    }
}

2. 修改Person类，注意两个关键点：
   • 给company字段添加@JsonAlias("companyName")，让它能识别第二种JSON里的companyName字段；
   • 把内部类Company改成static——非静态内部类反序列化时需要外部Person实例，会直接报错！

@Getter
@Setter
@JsonIgnoreProperties(ignoreUnknown = true)
public class Person {
    @JsonProperty
    private String name;
    @JsonProperty
    private String email;
    
    @JsonProperty("company")
    @JsonAlias("companyName")
    @JsonDeserialize(using = CompanyDeserializer.class)
    private Company company;

    @Getter
    @Setter
    @JsonIgnoreProperties(ignoreUnknown = true)
    public static class Company {
        @JsonProperty
        private String name;
    }
}

这样修改后，两种JSON格式都能正常反序列化：

• 第一种JSON的company对象会被解析成Company实例，提取name字段；
• 第二种JSON的companyName字符串会直接赋值给Company的name属性。

方案二：使用@JsonAnySetter捕获额外字段 #

如果不想写自定义反序列化器，可以用@JsonAnySetter来捕获companyName这个未被映射的字段，手动赋值给company：

修改Person类，添加@JsonAnySetter方法：

@Getter
@Setter
@JsonIgnoreProperties(ignoreUnknown = true)
public class Person {
    @JsonProperty
    private String name;
    @JsonProperty
    private String email;
    @JsonProperty
    private Company company;

    @JsonAnySetter
    public void handleUnknownFields(String fieldName, Object value) {
        // 捕获到companyName字段时，初始化Company并设置name
        if ("companyName".equals(fieldName)) {
            if (company == null) {
                company = new Company();
            }
            company.setName((String) value);
        }
        // 其他未知字段可以直接忽略，或者按需处理
    }

    @Getter
    @Setter
    @JsonIgnoreProperties(ignoreUnknown = true)
    public static class Company { // 同样要改成static类
        @JsonProperty
        private String name;
    }
}

这个方法的原理是：Jackson会把所有未被显式映射的字段（比如第二种JSON里的companyName）传给handleUnknownFields方法，我们在方法里判断字段名，手动完成赋值逻辑。

为什么@JsonAlias和@JsonCreator没起作用？ #

• @JsonAlias只是给字段起别名，比如让company字段接受company或companyName作为字段名，但它解决不了字段类型不匹配的问题（一个是对象，一个是字符串）；
• @JsonCreator通常用于自定义构造方法，但如果没有添加类型判断的逻辑，依然无法兼容两种不同的字段类型。

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