Spring RestAPI如何让@RequestBody兼容单个对象与List集合？

问题本质是Jackson默认仅将JSON数组反序列化为Java集合类型，当请求体中传入单个对象而非数组时，会因类型不匹配抛出解析异常。以下是两种无需修改请求JSON的Java代码调整方案：

方案一：全局配置Jackson，批量兼容所有List字段 #

通过开启Jackson的ACCEPT_SINGLE_VALUE_AS_ARRAY特性，让所有集合类型字段都支持将单个JSON对象自动包装为集合。在Spring Boot项目中，可通过配置类实现：

import com.fasterxml.jackson.databind.DeserializationFeature;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.json.Jackson2ObjectMapperBuilderCustomizer;

@Configuration
public class JacksonGlobalConfig {
    @Bean
    public Jackson2ObjectMapperBuilderCustomizer jacksonCustomizer() {
        return builder -> builder.featuresToEnable(DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY);
    }
}

优点：配置一次即可全局生效，无需修改现有DTO类；缺点：对所有集合类型字段生效，若部分字段不需要该兼容逻辑，需额外排除。

方案二：字段级精准配置，仅兼容目标字段 #

使用Jackson 2.9及以上版本提供的@JsonProperty(acceptSingleValueAsArray = true)注解，仅对指定List字段开启单个对象转集合的兼容：

import com.fasterxml.jackson.annotation.JsonProperty;
import java.util.List;

public class UserRequestDTO {
    @JsonProperty(acceptSingleValueAsArray = true)
    private List<Email> email;

    // getter、setter方法
}

public class Email {
    private String address;

    // getter、setter方法
}

优点：仅影响目标字段，不会干扰其他业务逻辑；缺点：需逐个修改需要兼容的字段，适合仅少数字段需要兼容的场景。

原理说明 #

两种方案本质都是让Jackson在反序列化时，当检测到目标类型为集合但传入的是单个JSON对象时，自动将该对象包装为包含单个元素的集合，从而完成正常解析，无需修改请求JSON格式。

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