1. 需求拆解:JSP项目里的文件夹断点续传到底难在哪
去年年底我还在维护一个基于Servlet + JSP的老系统,运营部突然提了个需求:网页里要能一次上传整个文件夹,而且网络断了之后重新选择文件夹,已经传过的文件不许再传一遍。听到“断点续传”“文件夹”这两个词同时出现在JSP项目里,我第一反应是这事没那么简单。JSP时代的上传方案大多数是单文件、整文件上传,一套成熟的组件往往依赖Spring Boot或者Vue这类新生态,想在老项目里直接套用并不容易。
这个需求的本质,是把“文件上传”拆成三层问题:第一,浏览器里如何拿到一个文件夹并遍历里面的所有文件;第二,文件体积大、数量多,如何把每个文件切成小块,传失败了只重传失败的小块;第三,整个上传中断之后,用户重新进入页面,已经传过的分片怎么跳过,而不是从头再来。这三个问题单独看都不算新技术,但组合在一起,并且要落在JSP/Servlet这套老技术栈上,就需要把原理吃透之后自己拼装。
如果你也在JSP项目里被这个需求卡住,或者正在给老系统做上传模块改造,这篇文章应该能帮上忙。我会把常见方案、前后端核心代码、分片记录表设计,以及我踩过的坑挨个讲清楚。都是可以直接复用的思路,不一定需要引入重型框架。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 方案选型:自研Servlet、第三方组件、云存储怎么选
先说结论:JSP网页实现文件夹断点续传,市面上大体有三条路可走。第一条是纯自研,前端用JavaScript切分文件,后端用Servlet接收分片,再自己写合并逻辑;第二条是前端集成现成的上传组件,比如WebUploader、Plupload、Resumable.js,后端仍然用Servlet或者单独写一个上传接口;第三条是如果项目有改造空间,直接上Spring Boot + Redis做分片记录,把文件落到MinIO或者云存储上。三条路没有绝对的优劣,关键是看你的项目现状。
老JSP项目强依赖Tomcat这类Servlet容器,部署环境往往也是内网老机器,升级Spring Boot的成本不只是改代码那么轻松。所以我的建议是:如果你的项目短期内不可能换框架,优先走自研或者第三方组件路线;如果项目刚好在重构,或者有网关、配置中心这类基础设施了,直接走Spring Boot + MinIO的方案会省心非常多。
2.1 自研Servlet方案:老项目成本最低的选择
自研方案的核心就是自己实现“分片上传 + 分片状态记录 + 合并文件”。前端拿到文件夹后遍历出所有文件,每个文件按固定大小切片,比如每片2MB,切完的文件逐片上传到Servlet接口。Servlet这边把接收到的分片先存在临时目录,等到所有分片收齐了,再按照分片序号依次读取并合并成完整文件。
这个方案最大的好处是依赖少,一个Servlet类加一张数据库表就能跑起来。缺点也很明显:你需要自己处理并发、乱序、重复分片、合并失败恢复这些边界问题。像“用户上传到一半关了浏览器,过了两小时重新打开,怎么跳过已传分片”这种需求,如果没有一张记录表,就只能靠前端每次上传前主动询问后端哪些分片已经存在。
所以做自研方案时,我强烈建议把分片记录表作为核心,而不是只写一个接收接口。表里记录文件标识、分片序号、分片状态,前端上传每个分片之前先查询一次,已存在的分片直接跳过,这样才能真正实现“断点续传”。
2.2 第三方组件方案:前端可能只需要半天接入
如果你不想手写整套路逻辑,可以试试前端组件。WebUploader是百度出的老牌上传组件,虽然已经停止维护,但用在老项目里依然稳定,很多人骂它文档不全,实际用下来核心功能都在。Plupload也有年头了,支持分片、拖拽、队列管理。Resumable.js更轻量,专注断点续传,后端只需要实现对应的接口即可。
我拿WebUploader举个例子:它自带分片、并发控制、进度条,你只需要在后端写一个接收接口。前端配置里设置chunked: true,组件会自动把大文件切成多片上传,每片上传时会带上chunk参数。后端接收后把这些分片保存到临时目录,前端全部传完后再调用一个合并接口。
这个方案的价值在于,前端的切分、断点跳过、进度展示这些繁琐工作组件都替你做了。缺点是老组件对现代浏览器的支持有天花板,WebUploader在Chrome最新版上偶尔有样式兼容问题,但功能不受影响。如果你对前端交互要求不高,只求快速交付,这个方案比完全自己写要快得多。
2.3 云存储与Spring Boot方案:新项目直接一步到位
如果项目允许改造,我强烈建议看Spring Boot + Redis + MinIO这套组合。MinIO本身是兼容S3协议的对象存储,它支持Multipart Upload分片上传,换句话说,MinIO天然支持将一个文件分成多个分片上传,然后合并。很多人在网上问“MinIO支持断点续传吗”,严格说MinIO提供的是分片上传能力,S3协议里每个上传任务会生成一个uploadId,你只要保存好这个uploadId,中断后就可以拿着它继续传剩余分片,这就是真正的断点续传能力。
Spring Boot实现断点续传秒传有两种常见方案。一种是基于Redis记录每个文件的分片上传状态,每次上传分片前先查Redis,已传过的分片直接返回成功;当所有分片都传完后,服务器端异步合并文件,并把合并后的文件信息写入数据库。另一种是不做分片,直接用RandomAccessFile按照文件偏移量写文件,前端通过js读取文件指定位置的数据,一次性拖到服务器对应位置,这种方式实现断点续传更直观,但对并发处理要求较高,因为多人同时写同一个文件会很危险。
3. 核心细节解析:前端如何遍历文件夹、切分文件、实现续传
聊完方案,我从最常用的自研Servlet方案开始拆解。这个方案分为前端和后端两部分,前端要解决三件事:获取文件夹、遍历目录树、切分文件并上传。
3.1 获取文件夹:webkitdirectory的基本用法
浏览器端想获取文件夹,靠的是input标签的webkitdirectory属性。这个属性最初是Chrome私有API,后来Firefox和Edge也支持了,但Safari的支持情况不稳定。老的IE肯定不支持,所以项目如果必须兼容IE,文件夹上传功能基本做不了,只能退化成手动多选文件。
html复制<input type="file" id="folderPicker" webkitdirectory multiple />
加了webkitdirectory之后,你在文件选择框里就能选整个文件夹,选中后input.files返回的是一个扁平的文件列表,而不是带目录树的结构。每个Fi
