تخزين استجابات Dio مؤقتًا في Flutter يساعد على تقليل طلبات الشبكة، لكنه يحتاج سياسة أوضح من مجرد إضافة interceptor. المثال القديم الذي يستخدم dio_http_cache مع Dio 4 ليس مثالًا متوافقًا تلقائيًا مع Dio 5. نستخدم هنا dio_cache_interceptor 4.0.7 وDio 5.11.1 وفق الواجهات التي روجعت في نوفمبر 2026.
تثبيت العميل مرة واحدة
أضف الحزمتين إلى pubspec.yaml ثم شغّل flutter pub get. أنشئ العميل واعترض الطلبات مرة واحدة في طبقة الخدمات أو حقن الاعتمادات، لا داخل getData في كل تحميل. تكرار إضافة interceptor على Dio نفسه قد يكرر المعالجة ويصعّب فهم مصدر الاستجابة.
import 'package:dio/dio.dart';
import 'package:dio_cache_interceptor/dio_cache_interceptor.dart';
Dio createCachedClient(String baseUrl) {
final options = CacheOptions(
store: MemCacheStore(),
policy: CachePolicy.request,
hitCacheOnNetworkFailure: true,
maxStale: const Duration(minutes: 10),
);
return Dio(BaseOptions(baseUrl: baseUrl))
..interceptors.add(DioCacheInterceptor(options: options));
}
الفرق بين MemCacheStore والتخزين الدائم
MemCacheStore يخزن الاستجابات في الذاكرة ويضيع عند انتهاء العملية. لا يصح وعد المستخدم بوجود البيانات بعد إعادة التشغيل بناءً على هذا المثال. إن احتجت الاستمرار فاختر مخزنًا دائمًا متوافقًا مع منصات مشروعك، وراجع سلوك ملفاته ومسح بيانات الحساب وحجم التخزين.
سياسة request تراعي توجيهات HTTP التي يرسلها الخادم. maxStale ليست مؤقتًا لطلب الشبكة ولا أمرًا لتحديث البيانات كل عشر دقائق؛ إنها حد إضافي لعمر النسخة المخزنة. تعليمات مثل no-store وETag تؤثر في النتيجة. اختبر خادمك الفعلي بدل افتراض أن كل استجابة ستدخل الكاش.
الشبكة المنقطعة والتحديث الإجباري
hitCacheOnNetworkFailure يسمح بالرجوع إلى نسخة متاحة عند فشل الشبكة وفق شروط المكتبة. لا يعني أن البيانات قد نُزّلت مسبقًا، ولا يضمن معالجة كل خطأ HTTP بالطريقة نفسها. اشرح للمستخدم متى يرى نسخة قديمة، واعرض تاريخ آخر تحديث إذا كانت حداثة البيانات مهمة.
استخدم CachePolicy.refresh لطلب تجديد مقصود عبر الخيارات الخاصة بذلك الطلب، مع الاحتفاظ بمصدر البيانات في Repository. لا تخلط نجاح قراءة الكاش مع نجاح حفظ تغيير في الخادم؛ طلبات الكتابة تحتاج عقدًا مختلفًا، ولا تُخزّن POST عشوائيًا أو استجابات المصادقة لمجرد أنها تمر عبر Dio.
مفاتيح الكاش والاختبارات
إذا اختلفت الاستجابة بحسب المستخدم أو اللغة أو المعاملات، فتأكد أن هوية الكاش تفصل هذه الحالات، أو امسح المخزن عند تغير الحساب. لا تحفظ رموز المصادقة في اسم ملف أو عنوان ظاهر. اختبر أول طلب، وطلبًا مكررًا، واستجابة no-store، وانقطاع الشبكة بعد نجاح سابق، والتحديث الإجباري. وفي الواجهة احتفظ بنتيجة الطلب بدل تكوين Future جديد عند كل build.
مراجع التنفيذ
لإكمال هذا الجزء، انتقل إلى التخزين المؤقت بمدة صلاحية في Flutter: مثال TTL Cache، ثم طبّق الربط الذي يناسب بنية مشروعك.







