Java 中异常处理怎么在文件下载中断时捕获异常并断点续传

秋芳姑娘_4962

秋芳姑娘_4962

2026-09-01

130人浏览

原创

java异常处理不直接触发断点续传,而是通过捕获网络超时、连接失败、http响应异常等中断场景保障状态持久化;进度必须在数据写入磁盘后立即保存,启动时以文件实际长度为准恢复offset。

java 中异常处理怎么在文件下载中断时捕获异常并断点续传

Java 中异常处理本身不直接触发断点续传,它的作用是保障断点续传逻辑的可靠性:当下载中断(如网络超时、连接断开、IO失败)时,异常捕获能防止程序崩溃,并确保已写入的数据和当前进度不丢失,为下次恢复提供依据。

关键在于:断点续传靠的是状态持久化,不是靠“捕获异常才开始续传”。异常处理只是兜底机制。

下面从实际协作角度说明怎么配合使用:

Alibabacloud Sdk Client Initialization For Java
Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

异常捕获要覆盖三类典型中断场景

  • 网络超时
    HttpURLConnectionHttpClient 设置合理超时后,抛出 SocketTimeoutExceptionjava.net.SocketTimeoutException
    → 记录当前 offset,休眠后重试,不更新进度文件

  • 连接失败
    如 DNS 解析失败、目标服务器拒绝连接,抛出 UnknownHostExceptionConnectException
    → 暂停几秒(如 2–5 秒),再尝试建立连接,offset 不变

  • HTTP 响应异常

    • 返回 416 Requested Range Not Satisfiable:说明文件已下完,可清理 .progress 文件并退出
    • 返回 5xx 或非 200/206 状态码:记录错误,等待后重试
    • InputStream.read() 返回 -1 或抛出 IOException:说明数据流提前结束,需校验文件大小是否匹配预期

状态保存必须独立于异常发生时机

  • 每次成功写入一块数据(例如用 RandomAccessFile.write()FileOutputStream.write() 写完 buffer)后,立刻把当前总字节数写入 .progress 文件
  • 推荐做法:
    try (RandomAccessFile raf = new RandomAccessFile(file, "rw")) {
        raf.seek(offset);
        raf.write(chunk);
        // ✅ 数据落盘后立即更新进度
        updateProgressFile(offset + chunk.length);
    }
  • 绝对不要在发请求前、或收到响应头后就更新进度——此时数据还没真正写进磁盘,进程崩溃就会丢进度

下载启动时先恢复状态

  • 每次开始下载前,先读取 .progress 文件获取 startOffset
  • 同时调用 file.length() 获取本地文件实际大小
  • 若两者不一致(常见于异常中断后未及时更新 .progress),file.length() 为准(更可信)
  • 构造 Range: bytes=<startoffset>-</startoffset> 请求头,打开文件始终用 "rw""rwd" 模式(保证写入同步)

一个轻量但可靠的重试+恢复结构示意

long offset = loadProgress(); // 从 .progress 或 file.length() 获取
while (offset  0) {
                    raf.write(buffer, 0, n);
                    offset += n;
                    saveProgress(offset); // ✅ 成功写入后立刻落盘
                }
            }
        } else if (conn.getResponseCode() == 416) {
            break; // 已完成
        }
    } catch (SocketTimeoutException | ConnectException e) {
        log.warn("网络异常,暂停3秒后重试,当前 offset: {}", offset);
        Thread.sleep(3000);
        // offset 不变,继续循环
    } catch (IOException e) {
        log.error("IO 错误", e);
        Thread.sleep(1000);
    }
}

不复杂但容易忽略

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

8777

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

6002

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

5372

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

964

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

808

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1156

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2329

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

19671

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1055

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习