Spring Boot实现含大文本与文件上传的表单API遇阻求助

问题背景 #

需要实现一个支持用户提交的表单API，包含以下内容：

• 基础信息小字段（如姓名、日期）
• 大文本输入框（5000字符以上）
• 文件上传

原有仅含小字段与文件的接口可正常运行，但添加大文本字段后出现请求头过大错误；改用@RequestBody接收实体类时，又触发媒体类型不支持错误。目前有将大文本转为文件的替代方案，但并非最佳实践，寻求合理技术方案。

错误原因分析 #

1. 请求头过大错误：使用@RequestParam接收所有字段时，multipart/form-data格式下的普通字段默认会被放入请求头中，大文本内容超过了服务器配置的请求头大小限制（如Tomcat的max-http-header-size）。
2. 媒体类型不支持错误：@RequestBody注解默认用于解析application/json、application/x-www-form-urlencoded等单一格式的请求体，无法直接处理多部分的multipart/form-data请求。

最佳解决方案 #

方案一：使用@ModelAttribute接收实体类（推荐） #

创建包含所有字段的实体类，通过@ModelAttribute注解绑定请求参数，大文本字段会被自动解析到请求体部分，不会占用请求头空间。

实体类定义

public class Submission {
    private String firstName;
    private String lastName;
    private String explanation; // 大文本字段
    @DateTimeFormat(iso = DateTimeFormat.ISO.DATE)
    private LocalDate submitDate;
    private MultipartFile file;

    // 生成getter、setter方法
}

接口代码

@PutMapping(value = "/submit", consumes = MediaType.MULTIPART_FORM_DATA_VALUE, produces = MediaType.APPLICATION_JSON_VALUE)
public ResponseEntity<FormData> submit(@ModelAttribute Submission submission) throws IOException {
    // 处理业务逻辑：获取submission中的字段和文件
    String explanation = submission.getExplanation(); // 直接读取大文本
    MultipartFile file = submission.getFile();
    // ...其他处理

    return ResponseEntity.ok(new FormData());
}

方案二：手动解析MultipartHttpServletRequest #

直接注入MultipartHttpServletRequest对象，手动提取各个字段和文件，适合需要灵活处理请求参数的场景。

接口代码

@PutMapping(value = "/submit", consumes = MediaType.MULTIPART_FORM_DATA_VALUE, produces = MediaType.APPLICATION_JSON_VALUE)
public ResponseEntity<FormData> submit(MultipartHttpServletRequest request) throws IOException {
    // 提取普通字段
    String firstName = request.getParameter("firstName");
    String lastName = request.getParameter("lastName");
    String explanation = request.getParameter("explanation"); // 大文本从请求体读取
    LocalDate submitDate = LocalDate.parse(request.getParameter("submitDate"));
    
    // 提取文件
    MultipartFile file = request.getFile("file");

    // 业务处理逻辑
    return ResponseEntity.ok(new FormData());
}

不推荐的临时方案：调整请求头大小限制 #

可以通过修改服务器配置（如Spring Boot的server.max-http-header-size或Tomcat的maxHttpHeaderSize）来扩大请求头容量，但大文本放在请求头中不符合HTTP规范，且存在潜在的安全风险，不建议采用。

内容的提问来源于stack exchange，提问作者iCodeLikeImDrunk