java nio断点续传关键在于filechannel精准定位写入、http range协议校验、进度双保险持久化及md5流式完整性校验。

Java 在 NIO 中实现安全可靠的断点续传,关键不在“用不用 NIO”,而在于如何用好 FileChannel、RandomAccessFile 和 HTTP Range 协议,并配合状态持久化与完整性校验。NIO 本身不直接提供“断点续传”能力,但它提供了线程安全、零拷贝、随机写入等底层支撑,让断点续传更高效、更健壮。
用 FileChannel + RandomAccessFile 精准写入断点位置
断点续传的核心是“能跳到已下载位置继续写”,不能覆盖、不能错位、不能丢字节。NIO 的 FileChannel 天然支持定位写入,比传统 FileOutputStream 更可靠:
-
避免使用
FileOutputStream追加模式(true):它无法保证写入位置精确,尤其多线程时易错位; -
必须用
RandomAccessFile("rw")获取getChannel():这样得到的FileChannel支持position(long)定位,并且是线程安全的; -
每次写入前调用
channel.position(offset),再用channel.write(buffer),确保数据落到指定字节偏移处; - 写完立即 flush() 或用 rws/rwd 模式打开,防止系统缓存导致断电/崩溃后丢失最后几 KB 数据。
用 Range 请求 + 服务端校验保障网络层可靠性
客户端能续传的前提是服务端真正支持字节范围请求。光发 Range: bytes=1024- 不够,还要验证响应是否合规:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 检查响应状态码必须是 206 Partial Content,不是 200;
-
读取
Content-Range响应头,确认起始偏移、当前块长度和文件总大小(如bytes 1024-2047/1048576); -
服务端必须支持
Accept-Ranges: bytes,否则所有 Range 请求会被忽略或返回 416; - 若服务端不支持 Range,断点续传自动退化为全量重下,程序需有 fallback 逻辑,不可静默失败。
用本地状态文件 + 内存原子变量双保险记录进度
断点信息一旦丢失,就真成“从头开始”。不能只靠内存变量,也不能只靠日志文本——要两者结合:
-
每次成功写入一段数据后,立刻更新一个轻量级进度文件(如 JSON 或 Properties 格式),内容至少包含:
fileId、totalSize、downloadedBytes、lastModified; -
用
AtomicLong在内存中维护实时已下载量,避免多线程竞争;更新进度文件时,以该值为准,防止因 IO 延迟造成状态滞后; -
启动下载前先读进度文件,再用
HEAD请求校验服务端文件大小是否一致(防服务端文件被替换);不一致则清空进度重来; -
进度文件建议放在与目标文件同目录,命名加
.progress后缀(如video.mp4.progress),便于清理和识别。
用 MD5/NIO 校验 + 流式合并确保最终完整性
下载完成≠文件正确。分片写入、网络乱序、磁盘错误都可能导致损坏:
- 下载前获取服务端提供的原始文件 MD5(通过自定义响应头或独立 API),不要依赖客户端计算;
-
合并完成后,用
Files.newInputStream()+DigestInputStream流式计算本地文件 MD5,避免全量加载大文件到内存; - 若校验失败,自动删除目标文件和进度文件,提示用户重试;不要留一个“看似完成实则损坏”的文件;
- 多线程分块下载场景下,每个分块也建议单独校验(如前端传 Content-MD5),早发现问题,减少无效合并开销。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










