一、核心概念与技术全景
在Java Web开发中,java获取post请求的请求体是处理JSON、表单数据、文件上传等场景的基础能力。HTTP POST请求体(Request Body)承载客户端提交的原始数据流,其内容类型由Content-Type头指定,如application/json、application/x-www-form-urlencoded、multipart/form-data等。
不同框架对请求体的封装机制差异显著:
- Servlet规范:通过
HttpServletRequest的getInputStream()或getReader()直接获取原始字节/字符流,需手动解析; - Spring MVC:提供
@RequestBody注解自动反序列化为Java对象,底层依赖HttpMessageConverter; - Spring Boot:默认集成Jackson,对JSON支持开箱即用,同时支持自定义消息转换器。
值得注意的是,java获取post请求的请求体存在关键限制:InputStream/Reader只能读取一次!这导致多个组件(如过滤器、拦截器、Controller)共享请求体时易引发“Stream closed”异常,需通过ContentCachingRequestWrapper等方案缓存内容。
ServletInputStream抽象层屏蔽底层协议细节,但不提供重复读能力。
1.1 请求体内容类型详解
不同Content-Type对应不同的解析策略:
| 类型 | 格式示例 | 适用场景 | java获取post请求的请求体方式 |
|---|---|---|---|
| application/json | {"name":"张三","age":28} | RESTful API、前后端分离 | InputStream → JSON反序列化 |
| application/x-www-form-urlencoded | username=admin&password=123456 | 传统HTML表单提交 | request.getParameterMap() |
| multipart/form-data | 分段二进制流(含文件) | 文件上传、混合数据 | request.getParts() 或 CommonsMultipartResolver |
| text/plain | 纯文本(无结构) | 调试、日志提交 | 直接读取流 |
1.2 请求体大小限制与配置
生产环境必须配置合理上限,避免内存溢出攻击:
- Servlet 3.0+:通过
@MultipartConfig(maxFileSize=10485760L, maxRequestSize=52428800L)注解或web.xml配置; - Tomcat:
maxPostSize参数(Tomcat 8.5+改为maxSwallowSize); - Spring Boot:
spring.servlet.multipart.max-file-size与spring.servlet.multipart.max-request-size; - Nginx:
client_max_body_size(建议与后端配置对齐)。
实测案例:某系统未配置maxRequestSize导致攻击者提交100MB payload触发OOM,日志显示java.lang.OutOfMemoryError: Java heap space。
二、Servlet原生方式深度解析
在无框架依赖场景(如轻量级应用、遗留系统改造)中,java获取post请求的请求体需直接操作底层流。核心方法有二:
2.1 基于getInputStream()的二进制流读取
适用于所有类型(尤其非文本数据),需注意字符编码处理:
示例:Servlet读取JSON请求体protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 关键:统一设置请求编码(需在读取前调用) request.setCharacterEncoding("UTF-8"); StringBuilder bodyBuilder = new StringBuilder(); try (BufferedReader reader = request.getReader()) { String line; while ((line = reader.readLine()) != null) { bodyBuilder.append(line); } } String requestBody = bodyBuilder.toString(); // 解析JSON(需引入Jackson依赖) ObjectMapper mapper = new ObjectMapper(); Mapdata = mapper.readValue(requestBody, Map.class); System.out.println("接收到数据:" + data); }
•
setCharacterEncoding("UTF-8")必须在getReader()或getInputStream()之前调用,否则默认ISO-8859-1导致中文乱码;• 若同时调用
getReader()和getInputStream()会抛出IllegalStateException;• 需手动处理Content-Type头,例如区分
application/x-www-form-urlencoded时应使用request.getParameter()而非读流。
2.2 基于getReader()的字符流读取
适用于文本类型(JSON/PLAIN),内部自动处理字符解码:
示例:处理纯文本请求体StringBuilder sb = new StringBuilder(); BufferedReader br = request.getReader(); String line; while ((line = br.readLine()) != null) { sb.append(line).append("\n"); } String textBody = sb.toString().trim(); // 验证是否为合法JSON(可选) if (textBody.startsWith("{") || textBody.startsWith("[")) { // 调用JSON解析器 }
2.3 多次读取解决方案
当需要在过滤器中记录日志、在Controller中解析业务数据时,需缓存请求体内容:
自定义可重复读取的RequestWrapperpublic class RepeatedlyReadableRequestWrapper extends HttpServletRequestWrapper { private byte[] cachedBytes; public RepeatedlyReadableRequestWrapper(HttpServletRequest request) { super(request); try { cachedBytes = StreamUtils.copyToByteArray(request.getInputStream()); } catch (IOException ex) { throw new RuntimeException("读取请求体失败", ex); } } @Override public ServletInputStream getInputStream() { return new CachedBodyServletInputStream(cachedBytes); } @Override public BufferedReader getReader() { return new BufferedReader(new InputStreamReader(getInputStream())); } // 内部类实现ServletInputStream private static class CachedBodyServletInputStream extends ServletInputStream { private final ByteArrayInputStream inputStream; public CachedBodyServletInputStream(byte[] cachedBytes) { this.inputStream = new ByteArrayInputStream(cachedBytes); } @Override public int read() { return inputStream.read(); } @Override public boolean isFinished() { return inputStream.available() == 0; } // 其他方法实现省略... } }
使用方式:在过滤器中包装原始请求:chain.doFilter(new RepeatedlyReadableRequestWrapper(request), response);
三、Spring MVC注解驱动方案
Spring MVC通过HttpMessageConverter体系自动完成请求体到Java对象的转换,极大简化开发。
3.1 @RequestBody核心机制
当Controller方法参数标注@RequestBody时,Spring按以下流程处理:
- 根据
Content-Type选择匹配的HttpMessageConverter(如JSON→MappingJackson2HttpMessageConverter); - 调用转换器的
read()方法,内部调用ObjectMapper反序列化; - 将结果对象注入参数。
① 自定义Converter → ② Jackson → ③ Gson → ④ Fastjson
可通过
WebMvcConfigurer#extendMessageConverters调整顺序。
3.2 实战示例:JSON请求体处理
Controller层直接映射对象@PostMapping("/api/user") public ResponseEntity
对应DTO类:
public class UserDTO {
private String username;
private Integer age;
private List tags;
// getter/setter...
}
3.3 处理特殊场景
① 空请求体处理
当客户端未传数据时,Spring默认抛出HttpMessageNotReadableException。可通过required = false规避:
@PostMapping("/api/data")
public String handleData(@RequestBody(required = false) String body) {
return body == null ? "无数据" : body;
}
② 自定义JSON解析器
当默认Jackson无法满足需求时(如需忽略大小写、自定义日期格式),可扩展ObjectMapper:
@Configuration
public class JacksonConfig {
@Bean
public Jackson2ObjectMapperBuilderCustomizer customizer() {
return builder -> {
builder.simpleDateFormat("yyyy-MM-dd HH:mm:ss");
builder.featuresToEnable(JsonReadFeature.ALLOW_UNQUOTED_FIELD_NAMES);
builder.featuresToDisable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
};
}
}
③ 处理multipart/form-data中的JSON部分
混合场景下(如上传JSON元数据+文件),需手动解析Part内容:
@PostMapping("/upload")
public String upload(@RequestPart("meta") UserMeta meta, @RequestPart("file") MultipartFile file) {
// meta自动解析为UserMeta对象
return "上传成功: " + meta.getName();
}
四、Spring Boot增强特性
Spring Boot在Spring MVC基础上提供更智能的默认配置与可配置项。
4.1 默认配置清单
| 配置项 | 默认值 | 说明 |
|---|---|---|
spring.jackson.date-format | 空 | 全局日期格式 |
spring.jackson.time-zone | 系统时区 | 时区设置 |
spring.servlet.multipart.enabled | true | 启用文件上传 |
spring.servlet.multipart.max-file-size | 1MB | 单文件大小限制 |
spring.servlet.multipart.max-request-size | 10MB | 总请求大小限制 |
4.2 全局异常处理
请求体解析失败时,Spring Boot抛出HttpMessageNotReadableException,需全局捕获:
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(HttpMessageNotReadableException.class)
public ResponseEntity
4.3 自定义RequestBodyAdvice
对所有@RequestBody参数统一添加处理逻辑(如解密、校验):
@ControllerAdvice
public class RequestBodyEncryptionAdvice implements RequestBodyAdvice {
@Override
public boolean supports(MethodParameter methodParameter, Type targetType, Class extends HttpMessageConverter>> converterType) {
return methodParameter.hasParameterAnnotation(RequestBody.class);
}
@Override
public HttpInputMessage beforeBodyRead(HttpInputMessage inputMessage, MethodParameter parameter, Type targetType, Class extends HttpMessageConverter>> converterType) {
return new DecryptedHttpInputMessage(inputMessage);
}
// 其他方法省略...
}
五、常见陷阱与解决方案
5.1 流读取一次问题
错误示例:在过滤器中读取请求体后,Controller抛出java.io.IOException: Stream closed
解决方案:java获取post请求的请求体时必须缓存流内容,推荐使用ContentCachingRequestWrapper:
public class CacheRequestFilter extends OncePerRequestFilter {
@Override
protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain chain) {
chain.doFilter(new ContentCachingRequestWrapper(request), response);
}
}
在Controller中读取缓存内容:
String body = new String(request.getContentAsByteArray(), StandardCharsets.UTF_8);
5.2 Content-Type不匹配
当请求头Content-Type: application/json但实际发送纯文本时,Jackson会抛出解析异常。
规避方案:在Controller中增加校验:
@PostMapping("/api/data")
public Result processData(@RequestBody String body) {
if (!body.startsWith("{") && !body.startsWith("[")) {
throw new IllegalArgumentException("仅支持JSON格式请求体");
}
// 继续处理...
}
5.3 中文乱码问题
常见于Tomcat默认编码ISO-8859-1:
- 全局配置:在
application.properties添加server.tomcat.uri-encoding=UTF-8; - 请求包装:使用
request.setCharacterEncoding("UTF-8"); - 响应编码:设置
response.setContentType("application/json;charset=UTF-8")。
六、安全风险与防护措施
6.1 请求体攻击类型
- JSON炸弹:嵌套对象无限递归导致栈溢出(如
{"a":{"a":{"a":...}}}); - XXE注入:XML请求体中嵌入外部实体(需禁用外部实体);
- DoS攻击:超大请求体耗尽服务器资源。
6.2 防护方案
- 限制请求体大小:配置
spring.servlet.multipart.max-file-size=5MB; - 禁用危险功能:
ObjectMapper mapper = new ObjectMapper(); mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, true); // 禁用外部实体(XML) XmlFactory f = new XmlFactory().setFeature(XMLConstants.FEATURE_SECURE_PROCESSING, true); - 输入校验:使用
@Valid注解结合JSR-380约束(如@Size、@NotNull)。
• 生产环境必须启用
spring.jackson.deserialization.FAIL_ON_UNKNOWN_PROPERTIES=true;• 对用户提交的JSON字段添加白名单校验;
• 通过Nginx层拦截超大请求(
client_max_body_size 10m)。
七、性能优化策略
7.1 大请求体处理
当请求体超过内存限制时,采用流式处理:
@PostMapping("/stream")
public void processStream(HttpServletRequest request) throws IOException {
try (InputStream is = request.getInputStream()) {
byte[] buffer = new byte[8192];
int len;
while ((len = is.read(buffer)) != -1) {
// 边读边处理,避免全量加载
processChunk(buffer, 0, len);
}
}
}
7.2 缓存策略
对高频访问的请求体内容启用二级缓存:
- 一级缓存:
ContentCachingRequestWrapper(单次请求内复用); - 二级缓存:Redis存储解析后的对象(需设计合理过期策略)。
7.3 异步处理
结合Servlet 3.0异步特性避免阻塞线程:
@GetMapping("/async")
public Callable asyncProcess(HttpServletRequest request) {
return () -> {
// 在新线程中处理
String body = new String(request.getContentAsByteArray(), StandardCharsets.UTF_8);
return "处理完成";
};
}
八、高频问题解答(网友最常搜索)
① 为什么getReader()读取为空?
常见原因及解决方案:
- 已读取过InputStream:确保请求体未被其他组件提前消费;
- Content-Length为0:检查客户端是否发送了空body;
- 编码问题:添加
request.setCharacterEncoding("UTF-8"); - 过滤器顺序:自定义过滤器需配置在Spring Security之前。
验证方法:在读取前打印request.getContentLength()和request.getContentType()。
② 如何获取原始请求体用于日志审计?
推荐方案:在过滤器中缓存请求体并记录:
@Component
public class RequestLoggingFilter extends OncePerRequestFilter {
@Override
protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain chain) {
ContentCachingRequestWrapper wrappedRequest = new ContentCachingRequestWrapper(request);
chain.doFilter(wrappedRequest, response);
// 记录原始请求体(注意敏感信息脱敏)
String body = new String(wrappedRequest.getContentAsByteArray(), StandardCharsets.UTF_8);
logger.info("请求体: {}", maskSensitiveData(body));
}
}
⚠️ 重要:日志中需对密码、银行卡号等字段进行脱敏(如替换为***)。
③ multipart/form-data能用@RequestBody吗?
不能直接使用!Spring对multipart/form-data有特殊处理:
- 文件部分需用
@RequestPart("file") MultipartFile file; - 非文件部分可用
@RequestParam或@RequestPart(当指定Content-Type: application/json时); - 混合场景需拆分处理:
@PostMapping("/upload")
public String upload(
@RequestPart("metadata") Map metadata,
@RequestPart("file") MultipartFile file) {
return "上传成功";
}
④ 如何处理Base64编码的请求体?
典型场景:前端将图片转Base64上传:
- Controller接收字符串:
@PostMapping("/upload/base64")
public String uploadBase64(@RequestBody Base64Request request) {
// request.getImageData 是Base64字符串
byte[] imageBytes = Base64.getDecoder().decode(request.getImageData());
// 后续处理...
}
- 自定义转换器(可选):
public class Base64MessageConverter extends AbstractHttpMessageConverter {
public Base64MessageConverter() {
super(MediaType.APPLICATION_JSON);
}
@Override
protected String readInternal(Class clazz, HttpInputMessage inputMessage) {
String json = StreamUtils.copyToString(inputMessage.getBody(), StandardCharsets.UTF_8);
return Base64.getEncoder().encodeToString(json.getBytes(StandardCharsets.UTF_8));
}
}