Postman测试文件上传失败主因是form-data的Key与后端@RequestParam名不一致或手动设置Content-Type干扰boundary；Key必须完全匹配参数名，且Content-Type应由Postman自动生成。

Postman 测试文件上传接口失败，八成是 form-data 的 Key 没对上后端接收参数名，或者手动填了 Content-Type 干扰了 Postman 自动构造的 boundary。

Key 必须和后端 @RequestParam 或参数名完全一致

EasyExcel 导入接口通常写成类似 @RequestParam("file") MultipartFile file 或直接用 MultipartFile file（依赖 Spring 的参数名推断）。Postman 中的 Key 字段必须一字不差地匹配这个字符串：

• 后端是 @RequestParam("excelFile") → Postman Key 填 excelFile
• 后端方法签名是 upload(@RequestParam MultipartFile data) → Key 必须是 data，不是 file 也不是 uploadFile
• 多文件场景如 @RequestParam("files") List files → Key 是 files，且需点两次“Select Files”选多个，或拖入多个文件
• Key 类型选 “File”，不是 “Text”——选错会导致后端收到空对象，MultipartFile.isEmpty() 返回 true

别碰 Content-Type，让 Postman 自动生成 boundary

multipart/form-data 请求必须带 boundary，它是分隔字段的唯一标识符。Postman 在你选 form-data 后会自动设置 Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryxxx。手动填写会导致：

• 填错格式（比如漏掉 boundary= 或引号）→ 415 Unsupported Media Type
• 填了静态值（如 multipart/form-data; boundary=abc）→ 若请求体里实际用了别的 boundary → 服务端解析失败，EasyExcel 报 IllegalArgumentException: Stream is not an OLE2 stream（误判为损坏 Excel）
• Headers 标签页里删掉所有手动加的 Content-Type，只留 Authorization 和 Accept 等必要头

EasyExcel 场景下要特别注意文件后缀和 MIME 类型

EasyExcel 对 .xlsx 和 .xls 解析逻辑不同，且部分 Spring 配置会校验 Content-Type。Postman 选文件时会自动设 Content-Type，但可能不准：

Postman 12.27.7

Postman 12.27.7 Windows x64 官方安装包，适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力，以及接口规范标签管理改进，适合受限网络测试与规范资源组织场景。

下载

• 上传 .xlsx 却被识别为 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet → 正常
• 上传 .xlsx 却被识别为 application/octet-stream → 多数情况不影响 EasyExcel，但若后端有 MultipartFile.getContentType().startsWith("application/vnd") 校验就会拦截
• 上传 .xls 被识别为 application/vnd.ms-excel → 正常；若识别成 text/plain → EasyExcel 初始化失败，抛 ExcelDataConvertException
• 解决办法：用真实 Excel 文件测试，避免用文本编辑器另存为的“伪 Excel”；必要时在 Pre-request Script 里用 JS 临时改 MIME（不推荐，仅调试用）

上传大文件或批量导入时容易触发 Spring Boot 默认限制

Spring Boot 2.0+ 默认单文件上限 1MB、总请求体 10MB。上传 5MB 的 Excel 很可能卡在网关或直接 400：

• 错误现象：400 Bad Request + 日志出现 Maximum upload size exceeded
• 本地调试可在 application.properties 加两行：
  spring.servlet.multipart.max-file-size=50MB
spring.servlet.multipart.max-request-size=50MB
• 生产环境别硬调大，应配合 Nginx 的 client_max_body_size 一起改，否则请求根本到不了 Spring
• EasyExcel 本身无大小限制，但内存占用随文件行数线性增长；10 万行以上建议加 readSheet(0).headRowNumber(1) 显式指定表头行，避免反复扫描

真正卡住人的往往不是“怎么点”，而是 Key 名拼错半角/全角、复制粘贴带空格、或是以为改了 Headers 就万事大吉——boundary 一旦被手动干预，整个 multipart 结构就废了。测之前先 curl 看一眼原始请求体长什么样，比盲点十次更省时间。