Flutter自定义CacheManager如何调整CachedNetworkImage缓存有效期

flutter_cache_manager 计算缓存文件validTill有效期的优先级规则为：优先读取图片HTTP请求返回的响应头中Cache-Control字段的max-age值，只有当响应头未返回Cache-Control相关配置时，才会 fallback 到你在Config中设置的stalePeriod参数。你现在看到的7天有效期，是服务端返回的max-age值覆盖了你自定义的5分钟配置导致的。

你可以选择以下任意一种方案实现自定义有效期：

方案1：调整服务端配置（推荐） #

如果有权限修改图片服务的配置，直接将图片响应头的Cache-Control字段设置为max-age=300（对应5分钟），无需修改客户端代码即可生效，符合HTTP缓存规范。

方案2：客户端自定义HttpFileService覆盖响应头配置 #

如果无法调整服务端，可自定义HttpFileService强制覆盖响应头的max-age值，代码示例如下：

class CustomHttpFileService extends HttpFileService {
  @override
  Future<FileServiceResponse> get(String url, {Map<String, String>? headers}) async {
    final originalResponse = await super.get(url, headers: headers);
    if (originalResponse is HttpGetResponse) {
      // 复制原有响应头，覆盖cache-control字段，强制max-age为5分钟（300秒）
      final modifiedHeaders = Map<String, String>.from(originalResponse.headers);
      modifiedHeaders['cache-control'] = 'max-age=300';
      return HttpGetResponse(
        originalResponse.content,
        originalResponse.statusCode,
        modifiedHeaders,
      );
    }
    return originalResponse;
  }
}

之后把你原有自定义缓存管理器配置中的fileService替换为自定义的CustomHttpFileService即可：

static CacheManager instance = CacheManager(
  Config(
    key,
    stalePeriod: const Duration(minutes: 5),
    maxNrOfCacheObjects: 200,
    fileService: CustomHttpFileService(), // 替换为自定义的FileService
  ),
);

修改配置后需要先清空App本地已有的缓存数据再测试，否则之前已经缓存的图片还是会沿用旧的7天有效期配置，不会自动更新。

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