Postman上传大文件超时需同步调整三项设置:将Connection timeout设为30000ms、Response timeout设为60000ms以上;在General中修改Response size limit(如200MB=209715200字节);并正确配置Working Directory路径,确保上传文件位于该目录内。

Postman上传大文件超时,八成不是后端卡住,而是你没调对客户端超时和响应限制。
Connection timeout 和 Response timeout 必须手动改
Postman默认的 Connection timeout 是 10000ms(10秒),Response timeout 也是 10000ms —— 这对普通接口够用,但传一个 50MB 的 Excel 或 ZIP,光建立连接+等待服务端读取+生成响应就可能超时。
- 打开 Settings → General → Server 区域
- 把
Connection timeout改成30000(30秒),确保 TCP 握手不被中途砍断 - 把
Response timeout改成60000(60秒)或更高,给后端留出完整处理时间 - 注意:
Connection timeout必须 > 0,设为 0 不代表“无限”,而是会触发 Electron 底层异常
“Error: Maximum response size reached” 是 Postman 自己截的
你看到 Error: Maximum response size reached,别急着查 Nginx 或 Spring Boot 日志。这是 Postman 客户端硬性限制,默认只收 50MB 响应体 —— 即使后端成功返回了 80MB 的导出流,Postman 也会在内存缓冲区满时直接丢弃剩余数据并报错。
- 这个限制与网络、代理、SSL 全无关系,改服务器配置无效
- 解决方法:Settings → General → 下拉到 “Response size limit (bytes)” 输入框,填入更大值,比如
209715200(200MB) - 填数字时单位是字节,不是 MB;填错成
200就真只剩 200 字节可收 - Mac/Linux 用户注意:该设置重启 Postman 后才生效,不是热更新
文件路径错误导致“file not in working directory”
Postman 提示 The file above is not in your working directory,本质是它找不到你拖进 form-data 的那个文件路径 —— 它不会自动把本地任意路径塞进请求,而是依赖你预设的 Working Directory。
Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。
- 进 Settings → General → Working Directory → Choose,选一个固定目录(比如
/Users/you/postman-files) - 所有要上传的文件必须先复制进去,再在 form-data 中点击 “Select Files” 从该目录下选取
- 不要用 Finder 拖拽到 Postman 窗口里,这种操作在某些 macOS 版本上会丢失路径上下文
- Windows 用户若用 OneDrive 同步目录,注意检查文件是否处于“仅在线”状态(Postman 无法读取云文件)
Spring Boot 后端报 MaxUploadSizeExceededException 怎么办
前端 Postman 已调好,但后端仍抛 MaxUploadSizeExceededException,说明限制在服务端也存在。Spring Boot 默认单文件上限 1MB,总请求上限 10MB,远不够传压缩包或高清图。
- 在
application.properties中加两行: spring.servlet.multipart.max-file-size=50MBspring.servlet.multipart.max-request-size=500MB- 注意:这两个值必须同时设,只改一个会触发校验失败
- 如果你用的是 Spring Boot 3.x(基于 Jakarta EE),配置前缀是
spring.web.multipart,不是spring.servlet
真正容易被忽略的是:Postman 的 Response size limit 和后端的 max-request-size 是两道独立关卡,一个拦接收,一个拦解析;而 Working Directory 设置错误会导致请求根本发不出 —— 这三处不全调对,大文件上传就是“看起来能点 Send,实际上没走通”。










