【Java报错已解决】org.springframework.web.HttpMediaTypeNotAcceptableException

    💝💝💝很高兴能够在这里和您见面！希望您在这里可以感受到一份轻松愉快的氛围，不仅可以获得有趣的内容和知识，也可以畅所欲言、分享您的想法和见解。

非常期待和您一起在这个小小的网络世界里共同探索、学习和成长。💝💝💝

✨✨ 欢迎订阅本专栏 ✨✨

目录

引言

一、问题描述

1.1 报错示例

1.2 报错分析

1.3 解决思路

二、解决方法

2.1 方法一：放宽服务器端的响应类型

2.2 方法二：客户端请求头调整

2.3 方法三：自定义消息转换器

2.4 方法四：全局异常处理

三、其他解决方法

四、总结

---

引言

在Java开发的世界里，报错就像隐藏在暗处的陷阱，让开发者们防不胜防。其中，org.springframework.web.HttpMediaTypeNotAcceptableException这个异常常常让开发人员感到困惑。当遇到这个异常时，它会阻碍程序的正常运行，影响用户体验。那么，如何才能拨开迷雾，快速有效地解决这个问题呢？这篇文章将带你深入探索。

一、问题描述

1.1 报错示例

以下是一个简单的Spring MVC代码示例，可能会触发HttpMediaTypeNotAcceptableException异常：

import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class MyController {
    @GetMapping(value = "/example", produces = MediaType.APPLICATION_JSON_VALUE)
    public ResponseEntity exampleEndpoint() {
        return ResponseEntity.ok("Hello, World!");
    }
}

假设在请求这个端点时，客户端设置了一个不被服务器支持的 Accept 头，比如"application/xml"，并且服务器没有合适的消息转换器来处理这种情况，就可能会抛出HttpMediaTypeNotAcceptableException异常。

1.2 报错分析

在上述代码中，@GetMapping注解的produces属性指定了该端点只产生APPLICATION_JSON_VALUE类型的响应。当客户端发送请求时，它通过Accept请求头告诉服务器它期望接收的媒体类型。如果服务器无法提供客户端期望的媒体类型，Spring框架就会抛出HttpMediaTypeNotAcceptableException。这是因为Spring的内容协商机制试图匹配客户端的需求和服务器能够生成的内容类型，但在这种不匹配的情况下无法完成协商。

1.3 解决思路

解决这个问题的思路主要是确保服务器和客户端在媒体类型上的一致性。可以通过调整服务器端的响应类型设置，或者处理客户端的请求头，使其与服务器的能力相匹配。另外，也可以考虑添加更多的消息转换器来支持更多的媒体类型。

二、解决方法

2.1 方法一：放宽服务器端的响应类型

可以修改@GetMapping注解的produces属性，使其支持更多的媒体类型。例如：

@GetMapping(value = "/example", produces = {MediaType.APPLICATION_JSON_VALUE, MediaType.APPLICATION_XML_VALUE})
public ResponseEntity exampleEndpoint() {
    return ResponseEntity.ok("Hello, World!");
}

这样，服务器就可以根据客户端的Accept请求头，在application/json和application/xml之间选择合适的类型进行响应，减少了因为类型不匹配而导致的异常。

2.2 方法二：客户端请求头调整

如果客户端是自己可控的，可以修改客户端代码，使其发送的Accept请求头与服务器支持的类型相匹配。例如，在使用RestTemplate进行请求的Java客户端代码中：

import org.springframework.http.HttpEntity;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.http.ResponseEntity;
import org.springframework.web.client.RestTemplate;
public class MyClient {
    public static void main(String[] args) {
        HttpHeaders headers = new HttpHeaders();
        headers.setAccept(java.util.Collections.singletonList(MediaType.APPLICATION_JSON));
        HttpEntity entity = new HttpEntity<>("parameters", headers);
        RestTemplate restTemplate = new RestTemplate();
        ResponseEntity response = restTemplate.getForEntity("http://localhost:8080/example", String.class);
        System.out.println(response.getBody());
    }
}

通过设置合适的Accept头，确保与服务器的produces类型一致。

2.3 方法三：自定义消息转换器

如果需要支持一些特定的媒体类型，可以创建自定义的消息转换器。例如，假设要支持一种自定义的text/custom - type媒体类型：

import org.springframework.http.HttpInputMessage;
import org.springframework.http.HttpOutputMessage;
import org.springframework.http.MediaType;
import org.springframework.http.converter.AbstractHttpMessageConverter;
import org.springframework.http.converter.HttpMessageNotReadableException;
import org.springframework.http.converter.HttpMessageNotWritableException;
import java.io.IOException;
import java.nio.charset.Charset;
public class CustomMessageConverter extends AbstractHttpMessageConverter {
    public CustomMessageConverter() {
        super(new MediaType("text", "custom - type", Charset.forName("UTF - 8")));
    }
    @Override
    protected boolean supports(Class clazz) {
        return String.class.isAssignableFrom(clazz);
    }
    @Override
    protected String readInternal(Class clazz, HttpInputMessage inputMessage) throws HttpMessageNotReadableException, IOException {
        // 这里实现从输入流读取自定义类型数据的逻辑
        return "";
    }
    @Override
    protected void writeInternal(String s, HttpOutputMessage outputMessage) throws HttpMessageNotWritableException, IOException {
        // 这里实现将数据写入输出流作为自定义类型的逻辑
    }
}

然后在Spring配置中注册这个消息转换器：

import org.springframework.context.annotation.Configuration;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import java.util.List;
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void configureMessageConverters(List> converters) {
        converters.add(new CustomMessageConverter());
    }
}

这样，服务器就可以处理这种新的媒体类型，减少的发生。HttpMediaTypeNotAcceptableException

2.4 方法四：全局异常处理

可以在Spring中设置全局异常处理来处理HttpMediaTypeNotAcceptableException异常。例如：

import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.context.request.WebRequest;
import org.springframework.web.servlet.mvc.method.annotation.ResponseEntityExceptionHandler;
@ControllerAdvice
public class GlobalExceptionHandler extends ResponseEntityExceptionHandler {
    @ExceptionHandler(HttpMediaTypeNotAcceptableException.class)
    protected ResponseEntity