快捷導(dǎo)航

SpringBoot請(qǐng)求體缺失異常原因分析與處理方案

更新時(shí)間：2025年10月05日 10:57:37 作者：小猿、

這篇文章主要介紹了SpringBoot請(qǐng)求體缺失異常原因分析與處理方案,該異常是因?yàn)閁serController的edit方法缺失了預(yù)期的UserUpdatePwdDTO請(qǐng)求體,產(chǎn)生原因主要由前端未發(fā)送請(qǐng)求體、Content-Type設(shè)置錯(cuò)誤或后端缺少@RequestBody注解導(dǎo)致,需要的朋友可以參考下

問(wèn)題描述

在Spring Boot應(yīng)用運(yùn)行過(guò)程中，日志中出現(xiàn)如下錯(cuò)誤信息：

ERROR c.p.b.f.w.h.GlobalExceptionHandler : 系統(tǒng)內(nèi)部異常：Required request body is missing: public ... UserController#edit(UserUpdatePwdDTO)

該異常表明在調(diào)用UserController的edit方法時(shí)，系統(tǒng)期望接收到一個(gè)UserUpdatePwdDTO類(lèi)型的請(qǐng)求體，但實(shí)際請(qǐng)求中缺失了請(qǐng)求體內(nèi)容。

異常原因分析

1. 根本原因

此異常通常由以下情況引起：

前端未發(fā)送請(qǐng)求體：前端發(fā)起請(qǐng)求時(shí)沒(méi)有包含必要的JSON數(shù)據(jù)
Content-Type設(shè)置錯(cuò)誤：未正確設(shè)置application/json頭部
方法參數(shù)注解缺失：后端控制器方法缺少@RequestBody注解
空請(qǐng)求體：請(qǐng)求體存在但內(nèi)容為空

2. 技術(shù)背景

Spring MVC框架通過(guò)@RequestBody注解將HTTP請(qǐng)求體映射到方法參數(shù)。當(dāng)使用該注解時(shí)，Spring期望每個(gè)請(qǐng)求都必須包含非空的請(qǐng)求體。

解決方案

1. 前端修復(fù)方案

確保正確設(shè)置請(qǐng)求頭和請(qǐng)求體：

// 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. 后端修復(fù)方案

方案一：添加參數(shù)驗(yàn)證和默認(rèn)處理

@RestController
@RequestMapping("/api/user")
public class UserController {
    @PutMapping("/edit")
    public ResponseEntity<?> edit(@RequestBody(required = false) UserUpdatePwdDTO dto) {
        if (dto == null) {
            return ResponseEntity.badRequest().body("請(qǐng)求體不能為空");
        }
        // 業(yè)務(wù)邏輯處理
        userService.updatePassword(dto);
        return ResponseEntity.ok("密碼修改成功");
    }
}

方案二：使用全局異常處理增強(qiáng)

@ControllerAdvice
public class GlobalExceptionHandler {
    private static final Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);
    @ExceptionHandler(HttpMessageNotReadableException.class)
    public ResponseEntity<ErrorResponse> handleHttpMessageNotReadable(
            HttpMessageNotReadableException ex) {
        logger.error("請(qǐng)求體解析異常: {}", ex.getMessage());
        ErrorResponse errorResponse = new ErrorResponse();
        errorResponse.setCode("BAD_REQUEST");
        errorResponse.setMessage("請(qǐng)求參數(shù)格式錯(cuò)誤或請(qǐng)求體缺失");
        errorResponse.setTimestamp(LocalDateTime.now());
        return ResponseEntity.badRequest().body(errorResponse);
    }
    // 錯(cuò)誤響應(yīng)DTO
    @Data
    public static class ErrorResponse {
        private String code;
        private String message;
        private LocalDateTime timestamp;
    }
}

方案三：自定義驗(yàn)證注解

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface OptionalRequestBody {
    // 自定義注解用于可選請(qǐng)求體
}
// 對(duì)應(yīng)的解析器
public class OptionalRequestBodyResolver implements HandlerMethodArgumentResolver {
    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        return parameter.hasParameterAnnotation(OptionalRequestBody.class);
    }
    @Override
    public Object resolveArgument(MethodParameter parameter, 
                                 ModelAndViewContainer mavContainer,
                                 NativeWebRequest webRequest, 
                                 WebDataBinderFactory binderFactory) throws Exception {
        // 自定義解析邏輯
        return null; // 根據(jù)實(shí)際情況實(shí)現(xiàn)
    }
}

3. DTO類(lèi)優(yōu)化

添加合理的默認(rèn)值和驗(yàn)證規(guī)則：

@Data
public class UserUpdatePwdDTO {
    @NotBlank(message = "舊密碼不能為空")
    private String oldPassword;
    @NotBlank(message = "新密碼不能為空")
    @Size(min = 6, max = 20, message = "密碼長(zhǎng)度必須在6-20位之間")
    private String newPassword;
    // 默認(rèn)構(gòu)造函數(shù)
    public UserUpdatePwdDTO() {}
    // 全參構(gòu)造函數(shù)
    public UserUpdatePwdDTO(String oldPassword, String newPassword) {
        this.oldPassword = oldPassword;
        this.newPassword = newPassword;
    }
}

預(yù)防措施

1. 接口文檔規(guī)范

明確標(biāo)注需要請(qǐng)求體的接口
提供完整的請(qǐng)求示例
說(shuō)明Content-Type要求

2. 測(cè)試策略

@SpringBootTest
@AutoConfigureTestDatabase
class UserControllerTest {
    @Autowired
    private TestRestTemplate restTemplate;
    @Test
    void 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. 前端統(tǒng)一攔截器

// 請(qǐng)求攔截器
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;
});
// 響應(yīng)攔截器 - 統(tǒng)一處理400錯(cuò)誤
axios.interceptors.response.use(
  response => response,
  error => {
    if (error.response?.status === 400) {
      // 統(tǒng)一處理請(qǐng)求體缺失等錯(cuò)誤
      showErrorMessage('請(qǐng)求參數(shù)錯(cuò)誤，請(qǐng)檢查后重試');
    }
    return Promise.reject(error);
  }
);