原理与核心机制
在HTTP传输中，断点续传的核心机制依赖于 Range 请求与服务器对分段传输的支持，当客户端需要从已下载的位置继续时，可以通过发送 Range: bytes=start-end 的请求来获取未下载的内容区段。
当服务器能够处理分段请求时，通常会返回 206 Partial Content 状态码以及 Content-Range 响应头，标明本次返回数据所处的字节区间，这也是实现断点续传的关键信号。
为了实现健壮的断点续传，客户端通常需要维护一个本地状态，记录已下载的字节数、总大小以及下载的进度信息，确保应用在崩溃或网络波动后还能从上次停止的地方继续。
在设计实现时，本地随机写入能力和对 Range 请求的高效处理是关键点，在Java环境中通常借助 RandomAccessFile 与 HttpClient 等工具实现无缝续传。
服务端对断点续传的支持与实现要点
要实现断点续传，服务端需对 Range 请求进行正确解析，并且在响应中提供可续传的能力。
服务器应返回 Accept-Ranges: bytes，表示对范围请求的支持，并在响应中包含 Content-Range 来指明当前传输的字节区间，从而让客户端明确已下载的范围。
当客户端发起范围请求时，206 Partial Content 表示服务器按请求返回了指定区间；如果服务器仅返回完整内容或不支持 Range，将需要重新从头开始下载，这就影响续传策略的设计。
对于大文件传输，服务器端还需要关注 并发下载的幂等性与幂等性，确保多次请求不导致数据错位，同时尽量保持对已有数据的保护，以避免重复写入。
在Java中实现HTTP断点续传的设计原则
在Java实现中，优先选用自带的 HttpClient（Java 11+）来发起网络请求，并结合 RandomAccessFile 实现本地文件的随机写入。
设计时应包含对 服务端是否支持 Range 的探测，以及对 Content-Length 的读取，以确定总大小并计算断点位置。
为了提升鲁棒性，推荐实现 断点记录与恢复机制，包括保存已下载长度、任务ID、校验信息等，以应对应用重启和网络波动。
错误处理方面应覆盖 网络超时、分段请求失败、部分写入异常 等场景，并实现重试策略与回退处理，确保数据尽量完整。
实战示例：基于HttpClient的断点续传下载
实现思路
核心思路是：先通过 HEAD 请求获取服务器对 Range 的支持以及目标文件的总长度；若支持范围请求，则从已下载长度开始进行分段下载，通过在本地使用 RandomAccessFile 的 seek 功能实现断点续传；若不支持 Range，则直接从头开始下载并覆盖本地文件。
在实现中，应该持续记录已写入的字节数，并在每次成功写入后更新进度，以便再次启动时能够从正确的位置继续。
此外，需关注并发策略与资源清理，例如在读取流结束后正确关闭流、释放网络连接，以及在程序退出前完成对本地状态的持久化。
下面的代码示例展示了一个可运行的简单实现，涵盖了检测 Range 支持、获取内容长度以及断点续传的核心逻辑，便于直接在项目中进行改造与扩展。
完整代码示例
import java.io.File;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.io.RandomAccessFile;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;public class HttpResumeDownloader {private final HttpClient httpClient = HttpClient.newHttpClient();// 检测服务器是否支持 Range 请求private boolean supportsRange(URI uri) throws IOException, InterruptedException {HttpRequest head = HttpRequest.newBuilder(uri).method("HEAD", HttpRequest.BodyPublishers.noBody()).build();HttpResponse resp = httpClient.send(head, HttpResponse.BodyHandlers.discarding());String acRanges = resp.headers().firstValue("Accept-Ranges").orElse("none");return acRanges.equalsIgnoreCase("bytes");}// 获取目标资源的总长度private long getContentLength(URI uri) throws IOException, InterruptedException {HttpRequest head = HttpRequest.newBuilder(uri).method("HEAD", HttpRequest.BodyPublishers.noBody()).build();HttpResponse resp = httpClient.send(head, HttpResponse.BodyHandlers.discarding());String cl = resp.headers().firstValue("Content-Length").orElse("-1");try {return Long.parseLong(cl);} catch (NumberFormatException e) {return -1;}}// 下载实现：支持断点续传public void download(String url, Path target) throws Exception {URI uri = URI.create(url);long existing = 0;// 如果目标文件已存在，尝试读取已下载的长度if (Files.exists(target)) {existing = Files.size(target);} else {// 确保父目录存在File parent = target.toFile().getParentFile();if (parent != null && !parent.exists()) {parent.mkdirs();}Files.createFile(target);}boolean rangeSupported = supportsRange(uri);long total = getContentLength(uri);try (RandomAccessFile out = new RandomAccessFile(target.toFile(), "rw")) {// 断点续传路径if (rangeSupported && total > 0 && existing < total) {long start = existing;while (start < total) {String rangeHeader = "bytes=" + start + "-";HttpRequest req = HttpRequest.newBuilder(uri).header("Range", rangeHeader).GET().build();HttpResponse resp = httpClient.send(req, HttpResponse.BodyHandlers.ofInputStream());int code = resp.statusCode();if (code == 206) { // Partial Contenttry (InputStream in = resp.body()) {out.seek(start);byte[] buffer = new byte[8192];int read;while ((read = in.read(buffer)) != -1) {out.write(buffer, 0, read);start += read;}}// 已下载字节数更新完毕，跳出循环即可break;} else if (code == 200) {// 服务器未按 Range 返回，需要重新从头下载start = 0;out.seek(0);HttpRequest fullReq = HttpRequest.newBuilder(uri).GET().build();HttpResponse fullResp = httpClient.send(fullReq, HttpResponse.BodyHandlers.ofInputStream());try (InputStream in = fullResp.body()) {byte[] buffer = new byte[8192];int read;out.seek(0);while ((read = in.read(buffer)) != -1) {out.write(buffer, 0, read);start += read;}}break;} else {// 其他状态码，尝试重试或退出System.err.println("Unexpected response code: " + code);break;}}} else {// 不支持 Range 或总大小未知，从头下载覆盖写入HttpRequest req = HttpRequest.newBuilder(uri).GET().build();HttpResponse resp = httpClient.send(req, HttpResponse.BodyHandlers.ofInputStream());try (InputStream in = resp.body()) {out.seek(0);byte[] buffer = new byte[8192];int read;while ((read = in.read(buffer)) != -1) {out.write(buffer, 0, read);}}}}}public static void main(String[] args) throws Exception {HttpResumeDownloader downloader = new HttpResumeDownloader();String url = "https://example.com/large-file.zip";Path dest = Paths.get("downloads/large-file.zip");downloader.download(url, dest);System.out.println("下载完成: " + dest.toAbsolutePath());}
}
