套件概覽
Dio Smart Retry 是一個為 Dio HTTP 客戶端設計的重試工具，旨在根據預設條件自動重試請求。它預設僅對被視為可重試的 HTTP 狀態碼進行重試，例如 5xx 伺服器錯誤或網路逾時。此套件以簡單性與可靠性為核心設計，能順暢整合至現有的 Dio 設定中。該套件支援所有主要平台，包括 Android、iOS、Web、macOS、Windows 和 Linux，非常適合用於跨平台 Flutter 應用中的穩健網路作業。
適用情境
- 處理暫時性網路失敗
- 自動重試伺服器錯誤
- 在連線狀況不佳時提升應用程式之韌性
- 簡化 API 呼叫中的錯誤處理
- 減少業務代碼中的手動重試邏輯
主要特色
- 自動重試可重試的HTTP狀態
- 與 Dio 的輕鬆整合
- 支援多個平台
- 可設定的重試行為
- 輕量且開銷極小
適合對象
- 頻繁呼叫 API 的 Flutter 應用
- 需要可靠網絡通訊的應用程式
- 尋求簡單重試邏輯的開發者
- 使用 Dio 進行 HTTP 請求的項目
- 希望減少樣板錯誤處理的團隊
使用建議
- 預設不會重試客戶端錯誤（4xx）
- 自定重試邏輯需要額外設定
- 僅限基於 Dio 的 HTTP 客戶端
- 可能需要針對高延遲環境進行調整
- 沒有內建的退避策略，僅支援基本重試