Java实现文件上传下载系统教程

本文深入解析了Java中实现文件上传下载系统的核心要点与实战陷阱，强调Java本身不内置HTTP文件传输能力，必须依托Spring Boot等Web框架或HttpURLConnection等底层API；重点揭示了Spring Boot中安全处理MultipartFile的四大关键——空文件校验、路径穿越防护、大小限制配置及临时文件管理，以及下载时响应头设置（尤其中文文件名编码）、流式传输避免内存溢出等易错细节；同时剖析了脱离框架时手动构造multipart请求的复杂性与字节级注意事项，并一针见血指出：真正决定系统稳定性的并非基础功能实现，而是中断恢复、并发控制、磁盘容灾、安全扫描等生产级边界问题——这些才是开发者从Demo走向上线必须跨越的鸿沟。

Java 本身不内置 HTTP 文件上传下载服务，必须依赖 Web 框架（如 Spring Boot）或底层网络 API（如 HttpURLConnection、Socket）来实现。纯 Java SE 无法直接处理浏览器表单提交的 multipart/form-data，也缺乏开箱即用的文件流代理能力。

Spring Boot + RestController 实现上传（支持多文件）

这是最常用、生产就绪的方式。关键点不是“怎么写一个方法”，而是如何正确解析 MultipartFile 并规避临时文件残留、内存溢出、路径遍历等风险。

• @RequestParam("file") MultipartFile file 只能接收单个文件；多文件需用 @RequestParam("files") List files
• 务必校验 file.isEmpty()，否则空提交会触发 NullPointerException 或静默失败
• 不要直接拼接 file.getOriginalFilename() 构造本地路径——它可能含 ../，导致路径穿越；应使用 FilenameUtils.getName()（Apache Commons IO）或白名单后缀过滤
• 建议设置上传限制：spring.servlet.multipart.max-file-size=10MB 和 max-request-size=10MB，否则大文件可能卡住 Tomcat 线程

用 ResponseEntity 下载文件（避免中文名乱码）

下载的核心不是返回文件内容，而是正确设置响应头。常见错误是只设 Content-Type，却忽略 Content-Disposition 中的编码逻辑。

• 对英文文件名：直接用 response.setHeader("Content-Disposition", "attachment; filename=\"" + fileName + "\"");
• 对中文文件名：必须用 URLEncoder.encode(fileName, "UTF-8")，并加 filename*=UTF-8'' 格式（RFC 5987），例如：attachment; filename="abc.pdf"; filename*=UTF-8''%E4%BD%A0%E5%A5%BD.pdf
• 不要用 new FileSystemResource(filePath) 直接返回大文件——会全量加载进内存；应改用 UrlResource(Paths.get(filePath))，配合 response.getOutputStream() 流式传输
• 务必检查文件是否存在且可读，否则抛 ResponseStatusException(HttpStatus.NOT_FOUND) 而非让框架返回 500

不用 Web 框架时，如何用 HttpURLConnection 发起上传请求

适用于客户端调用（比如后台服务向另一个系统上传），不推荐用于浏览器端交互。难点在于手动构造符合 RFC 7578 的 multipart body。

• 必须设置 connection.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary)，且 boundary 需随机生成（如 "----" + System.currentTimeMillis()）
• 每个 part 之间要用 --boundary 分隔，结尾用 --boundary--；文本字段和文件字段的格式不同，文件字段还需额外写入 Content-Disposition: form-data; name="file"; filename="a.txt" 和 Content-Type: text/plain
• 不能用 PrintWriter 写二进制文件内容——会破坏字节；必须用 OutputStream 原始写入
• 上传完成后需调用 connection.getResponseCode() 才真正发送请求，否则只是“准备好了”

真正难的从来不是“怎么把字节发过去”，而是边界情况：上传中断时的清理、并发写同一目录的锁竞争、磁盘满时的降级策略、病毒扫描集成、断点续传支持……这些在简单示例里根本不会出现，但上线第一天就会撞上。

本篇关于《Java实现文件上传下载系统教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！