Dio HTTP cache interceptor with multiple stores respecting HTTP directives (or not).

HTTP directives:

  • ETag
  • Last-Modified
  • Cache-Control
  • Date
  • Expires


  • BackupCacheStore: Combined store with primary and secondary.
  • DbCacheStore: Cache with database (sqflite).
  • FileCacheStore: Cache with file system.
  • MemCacheStore: Volatile cache with LRU strategy.


import 'package:dio_cache_interceptor/dio_cache_interceptor.dart';

// Global options
final options = const CacheOptions(
  store: DbCacheStore(), // Required.
  policy: CachePolicy.requestFirst, // Default. Requests first and caches response.
  hitCacheOnErrorExcept: [401, 403], // Optional. Returns a cached response on error if available but for statuses 401 & 403.
  priority: CachePriority.normal, // Optional. Default. Allows 3 cache levels and ease cleanup.
  maxStale: const Duration(days: 7), // Very optional. Overrides any HTTP directive to delete entry past this duration.

// Add cache interceptor with global/default options
final dio = Dio()
  ..interceptors.add(DioCacheInterceptor(options: options),


// Request with default options
var response = await dio.get('http://www.foo.com');

// Request with dedicated options
response = await dio.get('http://www.foo.com',
  options: Options(
    extra: CacheOptions(policy: CachePolicy.refresh).toExtra(),


CacheOptions are widely available on interceptor and on requests to take precedence.
There is no merge behaviour between interceptor and dedicated request options but store property.

See documentation for all properties.


Optionally, you can encrypt content and headers with your own algorithm via Encrypt / Decrypt methods if your storage is located in public folder.

Cache policy

enum CachePolicy {
  /// Returns the cached value if available.
  /// Requests otherwise.

  /// Forces to return the cached value if available.
  /// Requests otherwise.
  /// Caches response regardless directives.
  /// In short, you'll save every successful GET requests.

  /// Requests and skips cache save even if
  /// response has cache directives.
  /// Note: previously stored response stays untouched.

  /// Forces to request, even if a valid
  /// cache is available and caches if
  /// response has cache directives.

  /// Requests and caches if response has directives.

Features and bugs

Please file feature requests and bugs at the issue tracker.


From example folder:

flutter run test/test_suite.dart