Flutter中API响应缓存及12小时定时调用方案咨询

一、存储方式选择：缓存 vs SharedPreferences #

优先选择专用缓存库（如flutter_cache_manager），而非SharedPreferences，原因如下：

• SharedPreferences仅适合存储小体积键值对，图片列表+JSON的响应体积通常较大，用SP会显著拖慢读写速度，且结构上不适合存储复杂列表数据。
• 缓存库专门针对文件缓存设计，支持自动管理过期时间，还能直接配合图片加载组件（如cached_network_image）复用缓存的图片，更贴合你的需求。

如果需要更灵活的结构化数据操作，也可以考虑用本地数据库（如Hive、Isar）替代缓存库，查询和更新效率更高。

二、每12小时更新缓存的实现 #

纯Dart的Cron在Flutter后台环境下无法稳定运行，推荐结合本地时间戳校验+页面生命周期监听+后台任务插件实现需求：

1. 页面打开时触发检查更新 #

在ListScreen的初始化方法里加入校验逻辑，确保每次打开页面时都能判断是否需要更新：

@override
void initState() {
  super.initState();
  _checkAndRefreshCache();
}

Future<void> _checkAndRefreshCache() async {
  final lastUpdate = await _getLastUpdateTimestamp();
  final now = DateTime.now();
  
  // 超过12小时则触发API更新
  if (lastUpdate == null || now.difference(lastUpdate).inHours >= 12) {
    await _fetchApiDataAndSave();
    await _saveLastUpdateTimestamp(now);
  }
}

// 封装本地存储时间戳的方法（用SharedPreferences即可）
Future<DateTime?> _getLastUpdateTimestamp() async {
  final prefs = await SharedPreferences.getInstance();
  final timestamp = prefs.getInt('last_api_update');
  return timestamp != null ? DateTime.fromMillisecondsSinceEpoch(timestamp) : null;
}

Future<void> _saveLastUpdateTimestamp(DateTime time) async {
  final prefs = await SharedPreferences.getInstance();
  await prefs.setInt('last_api_update', time.millisecondsSinceEpoch);
}

2. 后台定时更新（解决应用关闭时的调用问题） #

应用完全关闭后，iOS系统不允许主动唤醒应用执行任务（这是系统限制，无法绕过），但可以通过后台任务插件实现应用在后台存活时的定时更新：
推荐使用workmanager（Android）+background_fetch（跨平台），以下是workmanager的配置示例：

// 后台任务回调
void _backgroundTaskCallback() {
  Workmanager().executeTask((taskName, inputData) async {
    try {
      await _fetchApiDataAndSave();
      await _saveLastUpdateTimestamp(DateTime.now());
      return Future.value(true);
    } catch (e) {
      // 任务失败，不覆盖旧缓存
      return Future.value(false);
    }
  });
}

// 在main函数初始化后台任务
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Workmanager().initialize(
    _backgroundTaskCallback,
    isInDebugMode: false,
  );
  // 注册每12小时执行一次的任务
  await Workmanager().registerPeriodicTask(
    'api_auto_update',
    'api_update_task',
    frequency: Duration(hours: 12),
    initialDelay: Duration(minutes: 1), // 首次启动延迟1分钟执行
  );
  runApp(MyApp());
}

注意：iOS后台任务的执行频率会被系统严格限制，建议始终保留页面打开时的校验逻辑作为兜底。

三、修复缓存库使用问题（针对你试过的flutter_cache_manager/dio_cache_manager） #

如果之前使用缓存库未达到预期，大概率是缓存键或过期配置错误，以下是正确的使用示例：

1. Dio Cache Manager 配置 #

final dio = Dio();
final cacheConfig = CacheConfig(
  baseUrl: '你的API基础地址',
  defaultMaxAge: Duration(hours: 12), // 默认缓存12小时
);
final cacheManager = DioCacheManager(cacheConfig);
dio.interceptors.add(cacheManager.interceptor);

// 发起请求时指定缓存策略
final response = await dio.get(
  '/api/image-list',
  options: Options(
    headers: {
      CacheControl.header: CacheControl.maxAge(Duration(hours: 12)).toString(),
    },
  ),
);

2. Flutter Cache Manager 存储JSON与图片 #

// 存储API返回的JSON数据
final jsonData = json.encode(response.data);
await DefaultCacheManager().putFile(
  'api_image_list.json',
  utf8.encode(jsonData),
  maxAge: Duration(hours: 12),
);

// 读取缓存的JSON数据
final cachedFile = await DefaultCacheManager().getFile('api_image_list.json');
if (cachedFile != null) {
  final jsonString = await cachedFile.readAsString();
  final data = json.decode(jsonString);
  // 将数据加载到UI
}

// 图片直接使用CachedNetworkImage自动复用缓存
CachedNetworkImage(
  imageUrl: item.imageUrl,
  placeholder: (context, url) => CircularProgressIndicator(),
  errorWidget: (context, url, error) => Icon(Icons.error),
)

四、关键注意事项 #

• API调用失败时，不要覆盖本地缓存，保留之前的有效数据，避免UI出现空白。
• iOS后台任务无法保证严格的12小时周期，系统会根据应用活跃度调整，必须依赖页面打开时的校验逻辑兜底。
• 若缓存库无法满足复杂数据操作需求，可切换到Hive/Isar数据库，支持结构化数据的增删改查。

内容的提问来源于stack exchange，提问作者Jay Panchal