Spring boot status":415，“error”：“不支持的介质

基础概念

HTTP状态码415（Unsupported Media Type）：这是一个标准的HTTP响应状态码，表示服务器拒绝服务请求，因为请求的实体格式不被请求的资源支持。通常，这意味着客户端尝试发送的数据类型（如JSON、XML等）与服务器端期望的数据类型不匹配。

类型与应用场景

类型：

请求体格式错误：客户端发送的数据格式（如Content-Type头指定的类型）与服务器端期望的不一致。
缺少必要的数据：请求体中缺少服务器端必需的某些字段或数据。

应用场景：

API接口开发：在构建RESTful API时，如果客户端发送的数据格式不正确，服务器会返回415状态码。
文件上传：当尝试上传文件但文件的MIME类型不被服务器支持时。

可能的原因及解决方法

原因：

Content-Type头设置错误：客户端发送请求时设置的Content-Type与服务器端期望的不匹配。
请求体数据格式不正确：即使Content-Type正确，请求体的实际数据格式也可能有误。
服务器端配置问题：服务器可能未正确配置以处理特定的Content-Type。

解决方法：

检查Content-Type头：确保客户端发送请求时设置了正确的Content-Type。例如，发送JSON数据时应设置为application/json。
检查Content-Type头：确保客户端发送请求时设置了正确的Content-Type。例如，发送JSON数据时应设置为application/json。
验证请求体数据：在服务器端添加数据验证逻辑，确保接收到的数据格式正确。
验证请求体数据：在服务器端添加数据验证逻辑，确保接收到的数据格式正确。
配置服务器端支持：确保Spring Boot应用正确配置了支持的媒体类型。
配置服务器端支持：确保Spring Boot应用正确配置了支持的媒体类型。

示例代码

假设我们有一个简单的Spring Boot应用，处理POST请求并期望接收JSON数据：

Controller：

@RestController
@RequestMapping("/api")
public class ExampleController {

    @PostMapping(value = "/example", consumes = MediaType.APPLICATION_JSON_VALUE)
    public ResponseEntity<?> example(@RequestBody ExampleRequest request) {
        if (request.isValid()) {
            // 处理请求
            return ResponseEntity.ok().build();
        } else {
            return ResponseEntity.status(HttpStatus.UNSUPPORTED_MEDIA_TYPE).build();
        }
    }
}

Request DTO：

public class ExampleRequest {
    private String field1;
    private int field2;

    // Getters and setters

    public boolean isValid() {
        return field1 != null && !field1.isEmpty() && field2 > 0;
    }
}

通过上述配置和代码，可以有效避免和处理HTTP 415错误。