如何让Jackson忽略特定类型的数组/集合属性？

针对你遇到的无法忽略MultipartFile[]这类数组/集合属性的问题，这里提供几种实用的解决方案，无需修改原始DTO定义：

方法1：自定义序列化器，针对目标类型的数组和集合 #

为MultipartFile数组、集合分别编写序列化器，序列化时直接跳过或返回null，避免触发序列化异常。

编写序列化器 #

import com.fasterxml.jackson.core.JsonGenerator;
import com.fasterxml.jackson.databind.JsonSerializer;
import com.fasterxml.jackson.databind.SerializerProvider;
import org.springframework.web.multipart.MultipartFile;
import java.io.IOException;
import java.util.List;

// 处理MultipartFile数组
public class MultipartFileArraySerializer extends JsonSerializer<MultipartFile[]> {
    @Override
    public void serialize(MultipartFile[] value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        gen.writeNull();
    }
}

// 处理MultipartFile集合（如List<MultipartFile>）
public class MultipartFileCollectionSerializer extends JsonSerializer<List<MultipartFile>> {
    @Override
    public void serialize(List<MultipartFile> value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        gen.writeNull();
    }
}

注册序列化器到ObjectMapper #

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.module.SimpleModule;

ObjectMapper objectMapper = new ObjectMapper();
SimpleModule module = new SimpleModule();
module.addSerializer(MultipartFile[].class, new MultipartFileArraySerializer());
module.addSerializer(List.class, new MultipartFileCollectionSerializer());
objectMapper.registerModule(module);

// 克隆DTO
YourDto clonedDto = objectMapper.readValue(objectMapper.writeValueAsString(originalDto), YourDto.class);

方法2：全局过滤指定类型的属性（推荐） #

使用BeanSerializerModifier实现全局过滤，自动识别并跳过所有MultipartFile类型的单个属性、数组、集合，无需针对每种类型单独写序列化器。

自定义SerializerModifier #

import com.fasterxml.jackson.databind.BeanDescription;
import com.fasterxml.jackson.databind.SerializationConfig;
import com.fasterxml.jackson.databind.ser.BeanPropertyWriter;
import com.fasterxml.jackson.databind.ser.BeanSerializerModifier;
import org.springframework.web.multipart.MultipartFile;
import java.util.ArrayList;
import java.util.List;

public class IgnoreTargetTypeModifier extends BeanSerializerModifier {
    private final Class<?> targetType;

    public IgnoreTargetTypeModifier(Class<?> targetType) {
        this.targetType = targetType;
    }

    @Override
    public List<BeanPropertyWriter> changeProperties(SerializationConfig config, BeanDescription beanDesc, List<BeanPropertyWriter> beanProperties) {
        List<BeanPropertyWriter> filteredProps = new ArrayList<>();
        for (BeanPropertyWriter writer : beanProperties) {
            Class<?> propRawType = writer.getType().getRawClass();
            // 检查是否是目标类型的数组
            boolean isTargetArray = propRawType.isArray() && targetType.isAssignableFrom(propRawType.getComponentType());
            // 检查是否是包含目标类型的集合
            boolean isTargetCollection = Iterable.class.isAssignableFrom(propRawType)
                    && targetType.isAssignableFrom(writer.getType().getContentType().getRawClass());
            
            // 仅保留非目标类型的属性
            if (!isTargetArray && !isTargetCollection) {
                filteredProps.add(writer);
            }
        }
        return filteredProps;
    }
}

注册到ObjectMapper #

ObjectMapper objectMapper = new ObjectMapper();
SimpleModule module = new SimpleModule();
module.setSerializerModifier(new IgnoreTargetTypeModifier(MultipartFile.class));
objectMapper.registerModule(module);

// 执行克隆
YourDto clonedDto = objectMapper.readValue(objectMapper.writeValueAsString(originalDto), YourDto.class);

这种方式最灵活，不管DTO里有多少个MultipartFile相关的字段，都能自动过滤，完全无需修改原始DTO。

方法3：MixIn结合字段级忽略（适用于已知字段名的场景） #

如果你明确知道DTO中MultipartFile数组/集合的字段名，可以通过MixIn给这些字段添加@JsonIgnore注解：

定义MixIn接口 #

import com.fasterxml.jackson.annotation.JsonIgnore;
import org.springframework.web.multipart.MultipartFile;
import java.util.List;

public interface YourDtoMixIn {
    @JsonIgnore
    MultipartFile[] getFileArray();
    
    @JsonIgnore
    void setFileArray(MultipartFile[] fileArray);

    @JsonIgnore
    List<MultipartFile> getFileList();
    
    @JsonIgnore
    void setFileList(List<MultipartFile> fileList);
}

绑定MixIn到DTO #

ObjectMapper objectMapper = new ObjectMapper();
objectMapper.addMixIn(YourDto.class, YourDtoMixIn.class);

// 克隆操作
YourDto clonedDto = objectMapper.readValue(objectMapper.writeValueAsString(originalDto), YourDto.class);

这种方式需要明确字段名，适合字段固定的场景。

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