使用multipart/form-data时getString()读取表单字段异常排查

开发者阿泽

2026-8-9

问题排查与解决

核心问题：同名字段冲突+后端处理逻辑有误

你遇到的问题本质是多行表单的同名字段在multipart请求中未被正确解析，加上后端处理逻辑没跟上，导致后续行的字段值被错误合并。

具体原因分析

前端表单name重复：用<c:forEach>生成多行时，如果每行的fruit、passphrase输入框的name属性完全一样，在multipart/form-data请求里，这些同名字段会被封装成多个FileItem，但如果后端没遍历所有条目，而是直接取第一个后就默认处理，就会把后续同名字段的内容错误拼接到一起，出现你看到的组合值。
前端渲染错误：有可能是<c:forEach>循环时，某个输入框的value属性被错误赋值成了包含多个字段的JSON字符串（比如不小心把对象直接丢进value里），导致提交时该字段值本身就是组合内容。

排查修复步骤

1. 修正前端表单的name属性

给每行的字段加上唯一标识，比如结合varStatus的下标，避免同名字段冲突：

<c:forEach items="${fruitList}" var="fruit" varStatus="status">
  <input type="text" name="fruit_${status.index}" value="${fruit.name}">
  <input type="text" name="passphrase_${status.index}" value="${fruit.passphrase}">
  <!-- 文件上传控件同理，比如name="file_${status.index}" -->
</c:forEach>

2. 修正后端ServletFileUpload处理逻辑

遍历所有FileItem，按字段名分类取值，不要直接取单个字段：

List<FileItem> items = new ServletFileUpload(new DiskFileItemFactory()).parseRequest(request);
// 用Map存储所有字段，键是带下标的字段名，值是对应内容
Map<String, String> formFields = new HashMap<>();

for (FileItem item : items) {
    if (item.isFormField()) {
        // 处理普通表单字段
        String fieldName = item.getFieldName();
        // 指定编码避免乱码
        String fieldValue = item.getString("UTF-8");
        formFields.put(fieldName, fieldValue);
    } else {
        // 处理文件上传，根据需要保存文件
        String fileName = item.getName();
        item.write(new File("/upload/" + fileName));
    }
}

// 按下标获取每行的字段值，比如第一行是fruit_0、passphrase_0
String firstFruit = formFields.get("fruit_0");
String firstPassphrase = formFields.get("passphrase_0");

3. 验证请求内容

用浏览器F12的Network面板查看POST请求的Form Data，确认每个字段的取值是否正确：

如果某个字段的值本身就是{"fruitname":"apple", "passphrase":"123"}，说明是前端渲染时把对象直接塞进了input的value里，需要修正<c:forEach>中的赋值逻辑，确保只赋值单个属性（比如${fruit.name}而不是${fruit}）。

4. （可选）批量处理同名字段

如果想保留同名字段（比如name="fruit"）批量提交，后端要收集所有同名字段的值：

List<String> fruits = new ArrayList<>();
List<String> passphrases = new ArrayList<>();

for (FileItem item : items) {
    if (item.isFormField()) {
        String value = item.getString("UTF-8");
        switch (item.getFieldName()) {
            case "fruit":
                fruits.add(value);
                break;
            case "passphrase":
                passphrases.add(value);
                break;
        }
    }
}
// 此时fruits和passphrases的下标对应每行的字段，比如fruits.get(1)是第二行的fruit值

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