斷點續傳是指下載或上傳中斷後,可以從上次失敗的位置繼續,而不是從頭開始。本文聚焦於 iOS 應用中的檔案下載,尤其是大檔案下載時,若沒有斷點續傳,任何異常、網路中斷或使用者主動暫停,都可能導致重新下載,浪費時間與流量。
更進一步的需求是:即使 App 被使用者手動結束,或因 crash 而重新啟動,也能依據已下載的暫存檔案繼續下載。這是本文希望解決的核心問題。
斷點續傳需要伺服器支援。常見方式包括 FTP 與 HTTP,而 iOS 應用中最常見的是 HTTP。HTTP 斷點續傳主要依賴請求標頭中的 Range。

Range 以位元組為單位。請求方可以指定從某個位元組位置開始下載,而不一定要知道檔案總大小。例如:
Range: bytes=1208765-
代表要求伺服器從第 1208765 個位元組之後開始回傳內容。

伺服器若支援 Range,會在回應中帶入 Accept-Ranges,並以 Content-Range 說明本次回傳的範圍與總長度。

例如 Content-Range: bytes 1208765-20489997/20489998 表示本次回傳從 1208765 到 20489997,總長度為 20489998。此時 HTTP 狀態碼通常是 206,而不是 200。
若專案使用 AFNetworking,可以透過 AFHTTPRequestOperation 實作斷點續傳。關鍵步驟如下:

AFHTTPRequestOperation 的底層依賴 NSURLConnectionDataDelegate。AFNetworking 會在子執行緒中發出請求,並透過 delegate 回呼接收資料。之所以不在主執行緒直接等待,是因為主執行緒的 RunLoop 模式會在使用者操作介面時切換,可能影響非同步任務的執行時機。
若自行實作,可以基於 NSURLConnection 與 NSURLConnectionDataDelegate。重點包括:

初始化 NSURLConnection 時,建議將 run loop mode 設定為 NSRunLoopCommonModes,否則在 TableView 或 ScrollView 滾動時,進度 UI 可能無法即時更新。

從 iOS 7 開始,Apple 推出 NSURLSession,功能比 NSURLConnection 更完整,也更適合非同步網路任務。若使用 NSURLSessionDataTask,需要實作 NSURLSessionDataDelegate 與 NSURLSessionTaskDelegate。

其流程與 NSURLConnection 類似,但 didCompleteWithError 會整合完成與失敗狀態,因此需要依 error 判斷要執行成功或失敗的後續處理。

NSURLSessionDownloadTask 是專門用於下載的任務,對應 NSURLSessionDownloadDelegate。它適合需要暫停、恢復與背景下載的場景。

使用 download task 時,暫停可透過 cancelByProducingResumeData 取得續傳資料,並將其持久化。恢復時再把 resumeData 交給 downloadTaskWithResumeData 即可。進度可透過 didWriteData 回呼取得。

需要注意的是,didFinishDownloadingToURL 回呼之後,系統會刪除暫存位置中的檔案,因此所有檔案搬移或處理都必須在該方法內完成。
斷點續傳的核心在於:伺服器支援 Range、用戶端保存已下載資料、並在下次請求時告知伺服器從哪個位置繼續。實作方式可以從 AFHTTPRequestOperation、NSURLConnection、NSURLSessionDataTask 到 NSURLSessionDownloadTask 逐步理解。若只是簡單下載,NSURLSessionDownloadTask 通常是較現代且合適的選擇。