当前位置：首页 > news >正文

Spring Boot请求体缺失异常分析与解决方案

news 2025/9/24 15:28:32

问题描述

在Spring Boot应用运行过程中，日志中出现如下错误信息：

ERROR c.p.b.f.w.h.GlobalExceptionHandler : 系统内部异常：Required request body is missing: public ... UserController#edit(UserUpdatePwdDTO)

该异常表明在调用UserController的edit方法时，系统期望接收到一个UserUpdatePwdDTO类型的请求体，但实际请求中缺失了请求体内容。

异常原因分析

1. 根本原因

此异常通常由以下情况引起：

前端未发送请求体：前端发起请求时没有包含必要的JSON数据
Content-Type设置错误：未正确设置application/json头部
方法参数注解缺失：后端控制器方法缺少@RequestBody注解
空请求体：请求体存在但内容为空

2. 技术背景

Spring MVC框架通过@RequestBody注解将HTTP请求体映射到方法参数。当使用该注解时，Spring期望每个请求都必须包含非空的请求体。

解决方案

1. 前端修复方案

确保正确设置请求头和请求体：

// Axios示例
axios.put('/api/user/edit', {oldPassword: 'currentPassword123',newPassword: 'newPassword456'
}, {headers: {'Content-Type': 'application/json'}
})// Fetch API示例
fetch('/api/user/edit', {method: 'PUT',headers: {'Content-Type': 'application/json',},body: JSON.stringify({oldPassword: 'currentPassword123',newPassword: 'newPassword456'})
})

2. 后端修复方案

方案一：添加参数验证和默认处理

@RestController
@RequestMapping("/api/user")
public class UserController {@PutMapping("/edit")public ResponseEntity<?> edit(@RequestBody(required = false) UserUpdatePwdDTO dto) {if (dto == null) {return ResponseEntity.badRequest().body("请求体不能为空");}// 业务逻辑处理userService.updatePassword(dto);return ResponseEntity.ok("密码修改成功");}
}

方案二：使用全局异常处理增强

@ControllerAdvice
public class GlobalExceptionHandler {private static final Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);@ExceptionHandler(HttpMessageNotReadableException.class)public ResponseEntity<ErrorResponse> handleHttpMessageNotReadable(HttpMessageNotReadableException ex) {logger.error("请求体解析异常: {}", ex.getMessage());ErrorResponse errorResponse = new ErrorResponse();errorResponse.setCode("BAD_REQUEST");errorResponse.setMessage("请求参数格式错误或请求体缺失");errorResponse.setTimestamp(LocalDateTime.now());return ResponseEntity.badRequest().body(errorResponse);}// 错误响应DTO@Datapublic static class ErrorResponse {private String code;private String message;private LocalDateTime timestamp;}
}

方案三：自定义验证注解

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface OptionalRequestBody {// 自定义注解用于可选请求体
}// 对应的解析器
public class OptionalRequestBodyResolver implements HandlerMethodArgumentResolver {@Overridepublic boolean supportsParameter(MethodParameter parameter) {return parameter.hasParameterAnnotation(OptionalRequestBody.class);}@Overridepublic Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer,NativeWebRequest webRequest, WebDataBinderFactory binderFactory) throws Exception {// 自定义解析逻辑return null; // 根据实际情况实现}
}

3. DTO类优化

添加合理的默认值和验证规则：

@Data
public class UserUpdatePwdDTO {@NotBlank(message = "旧密码不能为空")private String oldPassword;@NotBlank(message = "新密码不能为空")@Size(min = 6, max = 20, message = "密码长度必须在6-20位之间")private String newPassword;// 默认构造函数public UserUpdatePwdDTO() {}// 全参构造函数public UserUpdatePwdDTO(String oldPassword, String newPassword) {this.oldPassword = oldPassword;this.newPassword = newPassword;}
}

预防措施

1. 接口文档规范

明确标注需要请求体的接口
提供完整的请求示例
说明Content-Type要求

2. 测试策略

@SpringBootTest
@AutoConfigureTestDatabase
class UserControllerTest {@Autowiredprivate TestRestTemplate restTemplate;@Testvoid shouldReturnBadRequestWhenBodyMissing() {HttpHeaders headers = new HttpHeaders();headers.setContentType(MediaType.APPLICATION_JSON);HttpEntity<String> request = new HttpEntity<>(null, headers);ResponseEntity<String> response = restTemplate.exchange("/api/user/edit", HttpMethod.PUT, request, String.class);assertEquals(HttpStatus.BAD_REQUEST, response.getStatusCode());}
}

3. 前端统一拦截器

// 请求拦截器
axios.interceptors.request.use(config => {if (['POST', 'PUT', 'PATCH'].includes(config.method.toUpperCase())) {if (!config.headers['Content-Type']) {config.headers['Content-Type'] = 'application/json';}}return config;
});// 响应拦截器 - 统一处理400错误
axios.interceptors.response.use(response => response,error => {if (error.response?.status === 400) {// 统一处理请求体缺失等错误showErrorMessage('请求参数错误，请检查后重试');}return Promise.reject(error);}
);