MockMvc测试抛HttpMessageNotReadableException：无法将数组反序列化为对象

问题根源 #

你定义的全局CsvMapper Bean被Spring MVC自动接管，作为处理JSON请求的消息转换器使用。但CsvMapper是Jackson专门用于处理CSV格式的Mapper，它的默认配置和标准ObjectMapper存在差异，导致解析JSON请求时出现误判，把正常的JSON对象识别成了数组，从而抛出HttpMessageNotReadableException。

而你单独用new ObjectMapper()测试时，用的是标准Jackson JSON解析器，所以能正常解析。

解决方法 #

方法一：给CsvMapper添加限定符，避免被默认选用 #

给你的CsvMapper Bean加上@Qualifier注解，这样Spring MVC会自动使用默认的ObjectMapper处理JSON，而CsvMapper仅在你通过限定符注入时才会被使用：

@Bean
@Qualifier("csvMapper")
public CsvMapper csvMapper() {
    return new CsvMapper();
}

方法二：显式配置Spring MVC的JSON消息转换器 #

通过WebMvcConfigurer手动配置MappingJackson2HttpMessageConverter，指定使用标准ObjectMapper处理JSON请求，确保优先级高于其他转换器：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        MappingJackson2HttpMessageConverter jsonConverter = new MappingJackson2HttpMessageConverter();
        jsonConverter.setObjectMapper(new ObjectMapper());
        // 把JSON转换器放在最前面，确保优先使用
        converters.add(0, jsonConverter);
    }
}

方法三：在测试类中指定MockMvc使用的ObjectMapper #

如果不想修改全局配置，仅在测试中修复问题，可以在MockMvc初始化时手动指定消息转换器：

@Autowired
private ObjectMapper defaultObjectMapper;

@Autowired
private WebApplicationContext webApplicationContext;

private MockMvc mockMvc;

@BeforeEach
void setUp() {
    MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter(defaultObjectMapper);
    mockMvc = MockMvcBuilders.webAppContextSetup(webApplicationContext)
            .setMessageConverters(converter)
            .build();
}

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