1. 确保客户端请求的 Accept 头正确

客户端请求应包含正确的 Accept 头部，确保服务器能够提供该类型的响应。例如：

Accept: application/json

2. 修改 Controller 方法的 produces 参数

在 Controller 方法中，明确指定可接受的响应媒体类型：

@RequestMapping(value = "/example", method = RequestMethod.GET, produces = "application/json")
public ResponseEntity<Example> getExample() {
    // 处理逻辑
    return ResponseEntity.ok(new Example());
}

3. 配置合适的消息转换器

如果使用自定义媒体类型或有特定格式要求，需要在 Spring 中添加合适的 HttpMessageConverter。例如，确保 JSON 格式能够被正确转换：

@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
    converters.add(new MappingJackson2HttpMessageConverter());
}

4. 检查 Spring 配置中的媒体类型

确认是否有全局配置未启用合适的媒体类型支持。可以通过以下配置全局处理 JSON 响应：

@Bean
public HttpMessageConverter<Object> createMappingJackson2HttpMessageConverter() {
    return new MappingJackson2HttpMessageConverter();
}

5. 其他解决方案

• 全局异常处理：使用 @ExceptionHandler 捕获 HttpMediaTypeNotAcceptableException，并返回友好的提示信息。

@ExceptionHandler(HttpMediaTypeNotAcceptableException.class)
public ResponseEntity<String> handleHttpMediaTypeNotAcceptableException() {
    return ResponseEntity.status(HttpStatus.NOT_ACCEPTABLE).body("不可接受的媒体类型");
}