Spring Boot中MultipartFile场景禁用Jackson FAIL_ON_EMPTY_BEANS无效的解决方法

DevOps 小满

2026-6-15

解决方法

1. 全局配置Jackson禁用FAIL_ON_EMPTY_BEANS

方法内临时调用objectMapper.disable(...)不生效的核心原因是：Spring管理的RestTemplate可能使用独立的Jackson实例，或是你的配置未被应用到处理Multipart请求的消息转换器中。

编写全局配置类，确保所有用到的ObjectMapper都禁用该特性：

@Configuration
public class JacksonAndRestTemplateConfig {

    @Bean
    public ObjectMapper customObjectMapper() {
        ObjectMapper objectMapper = new ObjectMapper();
        // 禁用空Bean序列化失败的特性
        objectMapper.disable(SerializationFeature.FAIL_ON_EMPTY_BEANS);
        return objectMapper;
    }

    @Bean
    public RestTemplate restTemplate(ObjectMapper customObjectMapper) {
        RestTemplate restTemplate = new RestTemplate();
        
        // 替换RestTemplate中Jackson转换器的ObjectMapper为自定义实例
        for (HttpMessageConverter<?> converter : restTemplate.getMessageConverters()) {
            if (converter instanceof MappingJackson2HttpMessageConverter) {
                ((MappingJackson2HttpMessageConverter) converter).setObjectMapper(customObjectMapper);
            }
        }
        
        // 确保MultipartFormHttpMessageConverter存在（Spring Boot默认自动配置，显式添加更稳妥）
        restTemplate.getMessageConverters().add(new MultipartFormHttpMessageConverter());
        
        return restTemplate;
    }
}

2. 确保Multipart请求由正确的消息转换器处理

Multipart类型请求不需要Jackson序列化，而是由MultipartFormHttpMessageConverter负责处理。上述配置已显式添加该转换器，它会正确处理MultiValueMap<String, MultipartFile>类型的请求体，避免Jackson尝试序列化ByteArrayInputStream（MultipartFile的输入流对象）。