Java 实现 HTTP 断点续传：原理解析、实现步骤与实战代码示例

1. 原理解析

1.1 HTTP 断点续传的核心机制

在 HTTP 断点续传 的场景中，客户端需要从上次下载的位置继续获取数据，服务器需要支持按字节范围的传输。Range 请求头是实现的关键，允许客户端指定下载的字节区间，例如 Range: bytes=1000-。此时服务器应返回 206 Partial Content，并在响应头中包含 Content-Range 来表明实际传输的字节区间。若服务器不支持 Range，通常会返回 200 OK，此时需重新下载整份内容。Accept-Ranges 头用于指示服务器是否支持字节范围请求。

在实现端，除了读取 Content-Length 得知总大小，还需要判断服务器是否支持 Accept-Ranges: bytes。结合 Content-Range 的信息，可以判断当前数据是否已经下载，是否需要继续下载，以及当前下载的起始点。通过这些信息，客户端能够实现真正的断点续传，而不必每次都重新从头开始。

客户端设计的关键点包括：维护已下载的字节数、在写入阶段使用随机访问写入、处理流的边界以及在网络波动时的重试策略，从而确保下载过程的鲁棒性。

1.2 断点续传的状态与响应码

当服务器对 Range 请求做出响应时，最常见的状态码是 206 Partial Content，并且响应头中会包含 Content-Range，如 Content-Range: bytes 1000-1999/5000。这表示当前返回的数据位于总大小中的这一个区间。对于断点续传而言，这是一种明确的状态，表明服务器成功按指定范围返回数据。

如果服务器不支持 Range，服务器可能返回 200 OK，这时客户端若已存在部分内容就需要谨慎处理，因为这可能意味着需要重新下载整份内容。还有极少数情况，服务器会返回 416 Range Not Satisfiable，表示请求的范围超出了资源的大小。了解这些响应码有助于实现正确的下载策略与回退逻辑。

在 Java 实现中，读者通常还会关注 Etag、Last-Modified 等缓存标识，用于在并发场景下实现 If-Range 的校验，以避免把已经改动的文件错当成可续传的版本继续下载。

1.3 实现要点

实现 HTTP 断点续传，核心要点是：在客户端维护已下载的字节数，使用 Range: bytes=已下载- 发起继续下载的请求；服务器返回 206 Partial Content 时，将新数据追加到已有文件末尾，通常使用 RandomAccessFile 实现随机写入。正确处理输入流和输出流，避免内存占用过高或数据错位。还需要处理边界情况，如服务器不支持 Range、网络中断后的重试，以及文件名冲突与写入权限等。

2. 实现步骤

2.1 需求分析与接口设计

在实现 Java 实现 HTTP 断点续传前，需要明确以下接口要点：下载源 URL、目标文件路径、是否开启断点续传、以及对失败的重试策略。将下载的核心逻辑与外部调用分离，确保可测试性与可维护性。

数据结构层面，需关注以下字段：URL、目标路径、已下载长度、总长度、ETag。这些字段帮助在不同阶段判断进度与版本一致性，确保续传的正确性。

2.2 构造 Range 请求与断点处下载

在正式下载前，先通过 HEAD 请求获得资源的总长度和对 Range 的支持情况，以及必要的缓存标识。随后在需要续传时，向服务器发送 Range: bytes=已下载- 的请求头。若服务器返回 206，说明续传成功，可以将新数据追加到本地已经下载的部分。若返回 200，意味着 Range 不被支持，需按整文件覆盖下载。

这里的关键是要正确计算起始偏移量，并确保写入时使用正确的文件指针位置。对大文件下载，合理的缓冲区大小和 I/O 流管理也是影响性能的重要因素。

2.3 处理响应与文件写入

当响应码为 206 Partial Content 时，Content-Range 提供了当前返回字节的区间信息，客户端需要将读取到的字节写入到已经下载的文件末尾位置。实现中通常使用 RandomAccessFile，通过 raf.seek(existing) 将文件指针定位到已下载长度处。

数据写入时应使用一个合适的缓冲区，例如 32KB 的块大小，以实现平衡的 I/O 带宽和内存占用。读取输入流时，应在遇到异常时进行清理，避免资源泄漏。

2.4 断点续传的健壮性与边界情况

在实际网络环境中，可能发生连接中断、服务器端变更、或者 Range 支持被关闭等情况。需要实现以下策略：在范围不被支持时回退为整文件下载、遇到中断时可断点重试、以及在多线程下载场景下确保数据一致性。对于需要跨会话续传的场景，可以通过 ETag 或 If-Range 的条件请求来保护版本一致性。

3. 实战代码示例

3.1 Java 实现：Range 下载器核心逻辑

以下代码演示了一个简化的 range 下载实现，核心包括获取总长度、判断已下载长度、构造 Range 请求，以及使用 RandomAccessFile 写入续传数据。关键点在于对 206 Partial Content 响应的处理以及对非 Range 场景的回退处理。

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;

public class HttpRangeDownloader {
    private static final int BUFFER_SIZE = 32 * 1024;

    public void download(String fileURL, String destPath) throws IOException {
        URL url = new URL(fileURL);
        long total = getContentLength(url);
        File dest = new File(destPath);
        long existing = dest.exists() ? dest.length() : 0;

        if (total > 0 && existing >= total) {
            System.out.println("File already downloaded.");
            return;
        }

        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        // 如果已有下载部分，尝试从已下载位置继续
        if (existing > 0) {
            conn.setRequestProperty("Range", "bytes=" + existing + "-");
        }
        conn.setRequestMethod("GET");
        conn.connect();

        int code = conn.getResponseCode();
        if (code == HttpURLConnection.HTTP_PARTIAL || (code == HttpURLConnection.HTTP_OK && existing == 0)) {
            try (InputStream in = conn.getInputStream();
                 RandomAccessFile raf = new RandomAccessFile(dest, "rw")) {
                raf.seek(existing);
                byte[] buffer = new byte[BUFFER_SIZE];
                int len;
                while ((len = in.read(buffer)) != -1) {
                    raf.write(buffer, 0, len);
                    existing += len;
                }
            }
        } else {
            // 回退策略：如果服务器不支持 Range，则重新下载整个文件
            try (InputStream in = conn.getInputStream();
                 FileOutputStream out = new FileOutputStream(dest)) {
                byte[] buffer = new byte[BUFFER_SIZE];
                int len;
                while ((len = in.read(buffer)) != -1) {
                    out.write(buffer, 0, len);
                }
            }
        }
    }

    private long getContentLength(URL url) throws IOException {
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("HEAD");
        conn.connect();
        long length = conn.getContentLengthLong();
        String acceptRanges = conn.getHeaderField("Accept-Ranges");
        // 这里可以记录 Accept-Ranges 的状态，便于调试
        return length;
    }
}

3.2 调用示例

在实际使用中，将真实的下载地址与目标路径替换即可。该示例强调服务器对 206 Partial Content 的支持，以及续传逻辑的文件写入路径。

public class Demo {
    public static void main(String[] args) {
        String fileURL = "https://example.com/largefile.zip";
        String dest = "C:/downloads/largefile.zip";

        HttpRangeDownloader downloader = new HttpRangeDownloader();
        try {
            downloader.download(fileURL, dest);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}