如何在 Spring Boot 中正确提交包含多文件的嵌套对象列表

• 请求体未按 multipart/form-data 格式编码；
• Spring 的 MultipartResolver 无法识别为 multipart 请求；
• 控制器抛出 IllegalStateException: Current request is not a multipart request。

? 验证方式：检查浏览器开发者工具 Network 标签页，提交后查看请求头 —— 若 Content-Type 不是 multipart/form-data; boundary=...，而是 application/x-www-form-urlencoded 或缺失，则确认被 AJAX 拦截。

✅ 正确解决方案：移除 ajax-form，启用原生表单提交

只需修改 Thymeleaf 模板中的

<!-- ✅ 正确写法：禁用 AJAX，启用原生 multipart 提交 -->
<form id="floorForm" 
      th:action="@{/hotels/{hotelId}/edit(hotelId=${hotel.id})}" 
      th:object="${editForm}" 
      method="post" 
      enctype="multipart/form-data"> <!-- 必须存在！ -->
  <table>
    <tbody id="tableBody">
      <!-- 动态行将插入此处 -->
    </tbody>
  </table>
  <button type="button" onclick="addNewRow()">+ 添加楼层</button>
  <button type="button" onclick="submitImages()">提交所有图片</button>
</form>

此时你的 JavaScript 逻辑（submitImages() 中动态设置 name 属性）即可生效：

达奇AI论文写作

达奇AI论文辅助写作平台，在校学生、职场精英都在用的AI论文辅助写作平台

下载

• floorInput.setAttribute("name", "images[" + i + "].floorNumber");
• imageInput.setAttribute("name", "images[" + i + "].floorImage");

Spring 会自动将 images[0].floorImage, images[1].floorImage 等绑定到 List 中对应元素的 MultipartFile 字段。

⚠️ 关键注意事项

• enctype="multipart/form-data" 是强制要求：没有它，文件字段永远无法发送。Thymeleaf 不会自动添加此属性，必须手动声明。
• 不要混合 AJAX 与原生文件上传：若需异步体验，应改用 FormData + fetch/axios 手动构建请求（见下方示例），而非依赖 ajax-form。
• 服务端配置检查：确保 application.yml 中已配置 spring.servlet.multipart.*（如 max-file-size, max-request-size），避免大文件被拦截：

  spring:
    servlet:
      multipart:
        max-file-size: 10MB
        max-request-size: 10MB

• DTO 命名严格匹配：UploadData 中的字段名（floorImage, floorNumber）必须与 name 属性中的路径完全一致（大小写敏感），且 UploadFormDto 的 getter/setter 需为标准 JavaBean 规范。

? 进阶：如需 AJAX 提交（推荐方案）

若必须异步提交，应放弃 ajax-form，改用现代 JS 方式：

function submitImages() {
  const formData = new FormData();
  const rows = document.querySelectorAll('#tableBody tr');

  rows.forEach((row, index) => {
    const floorInput = row.querySelector('.floorNumber');
    const imageInput = row.querySelector('.imageData');

    if (floorInput && imageInput && imageInput.files.length > 0) {
      formData.append(`images[${index}].floorNumber`, floorInput.value);
      formData.append(`images[${index}].floorImage`, imageInput.files[0]); // 注意：files[0]
    }
  });

  fetch(`/hotels/${hotelId}/edit`, {
    method: 'POST',
    body: formData, // 自动设置 multipart Content-Type
  })
  .then(response => response.text())
  .then(html => {
    // 更新页面或跳转
  });
}

✅ 总结

只要确保表单是原生提交、enctype 正确、name 属性符合嵌套索引格式，Spring 就能完美绑定 List。记住：文件上传与 AJAX 天然不兼容，除非你亲手用 FormData 构造请求。