WIFI OTA 断点续传

文章目录

1、断点续传原理简述
2、流程图
3、详细逻辑阐述
- [1. 传输前准备](#1. 传输前准备)
- [2. 续传请求构造](#2. 续传请求构造)
- [3. 数据块写入与断点更新 (64KB)](#3. 数据块写入与断点更新 (64KB))
4、网络中断与重连集成
5、完整性校验
6、异常与边界处理
7、技术实现要点
8、状态机视角
总结

在 Wi-Fi 弱网环境下，网络连接可能频繁中断，导致文件传输失败。断点续传技术能够在传输中断后，从已传输的位置继续传输，避免重复下载/上传，大幅提升用户体验和带宽利用率。

1、断点续传原理简述

1、客户端与服务端约定支持断点续传（如 HTTP 的 Range 头、FTP 的 REST 命令）。

2、记录断点：客户端将已成功传输的字节数持久化存储（本地数据库、文件或内存）。

3、续传请求：重连后，客户端携带断点位置发起续传请求。

4、数据块传输：服务端从断点位置开始发送数据，客户端追加写入。

5、完整性校验：传输完成后通过哈希或大小比对确保文件完整。

2、流程图

否
是
否
是
是
是
否
否
否
是
是
否
开始传输任务
文件是否存在且支持续传？
全新传输：创建文件，记录起始位置 0
读取本地断点记录

（已传输字节数 offset）
向服务端发起续传请求

携带 offset
向服务端发起普通请求
服务端响应是否支持续传？
回退至普通传输

丢弃已有数据或覆盖
从 offset 开始接收数据流
从头开始接收数据流
从头接收数据流
数据块写入文件（追加模式）
每写入一个数据块

更新本地断点记录
是否发生网络中断？
保存当前断点

进入等待重连状态
重连成功？
继续等待或放弃任务
传输是否完成？
校验文件完整性

（哈希/大小）
校验通过？
任务完成，清除断点记录
任务失败，可选重试或报错

3、详细逻辑阐述

1. 传输前准备

1、断点持久化：每次成功写入数据块后，立即将已传输的字节数保存到本地（如 SharedPreferences、SQLite 或文件）。持久化应具备原子性，避免写入过程中掉电导致记录损坏。

2、续传能力检测：发起续传请求前，先判断服务端是否支持断点续传。例如 HTTP 请求可发送 HEAD 方法检查 Accept-Ranges 头；或直接尝试带 Range 的请求，根据返回码（206 Partial Content 或 200 OK）判定。

2. 续传请求构造

1、HTTP 示例：

php 复制代码

GET /file.zip HTTP/1.1
Range: bytes=1024000-

表示从 1,024,000 字节处开始下载。

2、FTP 示例：

php 复制代码

REST 1024000
RETR file.zip

若服务端返回 416 Range Not Satisfiable，说明断点已超出文件大小，需从头开始。

3. 数据块写入与断点更新 (64KB)

1、写入策略：采用"追加"模式打开本地文件，避免覆盖已有数据。

2、更新频率：每成功写入一个数据块 (block)（如 64KB）后，立即更新内存中的 offset 并持久化。若网络中断，下次重连时即可从最近一次持久化的位置恢复。

3、写缓冲与同步：为防止操作系统缓存导致断点滞后，可在关键时机强制 flush/fsync，但需平衡性能与可靠性。

4、网络中断与重连集成

1、当 Wi-Fi 断开时，传输循环会被异常捕获（如 SocketTimeoutException、IOException）。此时保存当前断点，并进入重连等待（参考前文的重连策略）。

2、重连成功后，无需重新扫描文件，直接读取持久化的断点，继续向服务端发起续传请求。

3、重连失败达到上限时，将任务标记为"暂停"，等待用户手动重试或切换网络。

5、完整性校验

1、传输完成后，通过比对文件总大小（Content-Length）与本地文件大小，或计算哈希（MD5/SHA1）与服务端提供的值，确保文件完整。

2、若校验失败，可重新发起续传（从失败点或从头），但需避免无限循环。

6、异常与边界处理

场景	处理方式
服务端不支持续传	回退至普通传输，并删除已有部分文件（或覆盖），同时提示用户。
断点记录损坏	从头开始传输，并覆盖原文件（或重命名备份）。
本地文件被篡改	校验失败后，丢弃该文件并重新下载。
并发写同一文件	使用文件锁或任务队列，避免多线程同时写入。

7、技术实现要点

1、协议选择：推荐使用 HTTP/1.1 及以上版本，天然支持 Range 头；若使用自定义协议，需自行设计续传命令。

2、断点存储：使用可靠存储介质，支持跨应用重启。例如 Android 可用 Room 数据库，iOS 可用 CoreData 或 UserDefaults。

3、网络监听：结合 ConnectivityManager（Android）或 NWPathMonitor（iOS）实时监测 Wi-Fi 状态变化，在连接恢复时自动续传。

4、重试与退避：断点续传中的网络重试可复用前文的重连策略，但续传请求本身也应具备退避机制，避免频繁重试导致服务端压力。

8、状态机视角

开始传输
网络中断/用户暂停
网络恢复/用户恢复
成功续传
传输结束
校验通过
校验失败
不可恢复错误
就绪
传输中
暂停
续传中
完成
校验中
重试
失败

总结

Wi-Fi 弱网环境下的断点续传，本质是将文件传输 与网络状态解耦，通过持久化断点、智能续传、完整性校验三个核心环节，确保在频繁断连时仍能高效完成传输。结合重连策略，可构建一套完整、可靠的文件传输机制，显著提升弱网场景下的用户体验。