實戰揭秘！Spring Boot 3.4 多 @RequestBody 處理技巧，輕松應對復雜入參
作者：編程疏影
在實際開發中，你可以根據項目需求選擇合適的方案，從而更高效地處理復雜的 JSON 請求體解析。希望本指南能幫助你輕松應對 Spring Boot 3.4 的多 @RequestBody 解析問題！?
在 Spring Boot 3.4 開發過程中，@RequestBody 注解是解析 HTTP 請求體 JSON 數據的常見方式，能夠自動將數據綁定到 Java 對象中。然而，當 API 需要同時接收多個對象時，直接使用多個 @RequestBody 會導致 HttpMessageNotReadableException 異常。究其原因，這是由于 HttpServletRequest 的輸入流只能被讀取一次，第二個 @RequestBody 無法再次獲取數據。
本文將深入剖析這一問題的本質，并提供兩種不同的解決方案：
- 使用 DTO 進行封裝（適用于前端可以調整數據格式的場景）。
- 自定義 HttpServletRequestWrapper（適用于無法修改前端請求結構的情況）。
通過這些方法，你可以在 Spring Boot 3.4 項目中靈活應對復雜的 JSON 請求體解析問題。
解決方案
方法 1：使用 DTO 進行封裝
我們可以創建一個 RequestDTO 類，將 User 和 Person 統一封裝。
package com.icoderoad.dto;
public class RequestDTO {
private User user;
private Person person;
// getter 和 setter
}然后修改 Controller 方法：
package com.icoderoad.controller;
import com.icoderoad.dto.RequestDTO;
import org.springframework.web.bind.annotation.*;
@RestController
@RequestMapping("/api")
public class MultiRequestBodyController {
@PostMapping("/multi")
public String handleMultiple(@RequestBody RequestDTO dto) {
return "Received: " + dto.getUser().getName() + " and " + dto.getPerson().getName();
}
}這種方式雖然簡單，但要求前端調整 JSON 數據格式。
方法 2：自定義 HttpServletRequestWrapper 允許多次讀取請求體
如果前端無法調整請求格式，我們可以使用 HttpServletRequestWrapper 解決 InputStream只能讀取一次的問題。
自定義 CachedBodyHttpServletRequest
package com.icoderoad.wrapper;
import jakarta.servlet.ReadListener;
import jakarta.servlet.ServletInputStream;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletRequestWrapper;
import org.springframework.util.StreamUtils;
import java.io.*;
public class CachedBodyHttpServletRequest extends HttpServletRequestWrapper {
private final byte[] cachedBody;
public CachedBodyHttpServletRequest(HttpServletRequest request) throws IOException {
super(request);
InputStream requestInputStream = request.getInputStream();
this.cachedBody = StreamUtils.copyToByteArray(requestInputStream);
}
@Override
public ServletInputStream getInputStream() {
ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(cachedBody);
return new ServletInputStream() {
@Override
public boolean isFinished() {
return false;
}
@Override
public boolean isReady() {
return false;
}
@Override
public void setReadListener(ReadListener listener) {}
@Override
public int read() {
return byteArrayInputStream.read();
}
};
}
}創建過濾器攔截請求
package com.icoderoad.filter;
import com.icoderoad.wrapper.CachedBodyHttpServletRequest;
import jakarta.servlet.*;
import jakarta.servlet.http.HttpServletRequest;
import org.springframework.stereotype.Component;
import java.io.IOException;
@Component
public class CachedBodyFilter implements Filter {
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
if (request instanceof HttpServletRequest) {
CachedBodyHttpServletRequest wrappedRequest = new CachedBodyHttpServletRequest((HttpServletRequest) request);
chain.doFilter(wrappedRequest, response);
} else {
chain.doFilter(request, response);
}
}
}配置過濾器
package com.icoderoad.config;
import com.icoderoad.filter.CachedBodyFilter;
import jakarta.servlet.Filter;
import org.springframework.boot.web.servlet.FilterRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.util.List;
@Configuration
public class FilterConfig {
@Bean
public FilterRegistrationBean<Filter> cachedBodyFilter() {
FilterRegistrationBean<Filter> registrationBean = new FilterRegistrationBean<>();
registrationBean.setFilter(new CachedBodyFilter());
registrationBean.setUrlPatterns(List.of("/*"));
return registrationBean;
}
}結論
在 Spring Boot 3.4 版本中，同時解析多個 @RequestBody 參數是一項常見但容易踩坑的挑戰。本文提供了兩種解決方案：
- DTO 封裝方式適用于可以修改前端請求格式的場景，簡單易用，但需要前端配合調整 JSON 結構。
- HttpServletRequestWrapper 方案適用于無法修改前端數據格式的情況，能夠確保多個 @RequestBody 參數的正常解析。
在實際開發中，你可以根據項目需求選擇合適的方案，從而更高效地處理復雜的 JSON 請求體解析。希望本指南能幫助你輕松應對 Spring Boot 3.4 的多 @RequestBody 解析問題！
責任編輯：武曉燕
來源：
路條編程
