Flutter中flutter_inappwebview如何清除CSS/JS/HTML等静态缓存

该需求完全可实现，flutter_inappwebview 原生提供了多粒度的缓存控制接口，完全覆盖SPA单页站点发版后清理旧CSS/JS/HTML静态资源缓存的场景，以下是可直接落地的实现方案，适配不同业务场景。

方案1：全量缓存清理（实现成本最低，适配单业务站点场景） #

如果你的WebView仅加载这一个SPA站点，直接在检测到站点发版、或者WebView初始化前调用全量清理接口即可，不会残留任何旧静态资源：

// 核心：清理WebView所有HTTP静态资源缓存
await InAppWebViewController.clearAllCache();

// 额外清理SPA常用的本地存储数据，避免旧版本状态干扰
if (Platform.isAndroid) {
  await AndroidInAppWebViewController.clearWebStorage();
  await AndroidInAppWebViewController.clearFormData();
}
if (Platform.isIOS) {
  await WKWebsiteDataStore.default().removeDataOfTypes(
    dataTypes: WKWebsiteDataType.values,
    modifiedSince: DateTime.fromMillisecondsSinceEpoch(0),
  );
}

注意：该方案会清空WebView下所有站点的Cookie、LocalStorage、IndexedDB、静态资源缓存，如果你的WebView同时加载多个业务域名，优先选下面的定向清理方案。

方案2：按域名定向清理缓存（适配多站点加载场景） #

如果WebView需要加载多个域名的内容，可仅针对SPA部署的域名做缓存清理，不影响其他站点的缓存数据：

// 替换为你的SPA实际部署域名
const spaOrigin = "https://your-spa-site.com";

if (Platform.isAndroid) {
  // 清理对应域名的WebStorage数据
  await AndroidWebStorageManager.instance().deleteOrigin(origin: spaOrigin);
  // 清理对应域名的HTTP静态资源缓存
  await AndroidInAppWebViewController.clearCacheForOrigin(origin: spaOrigin);
}

if (Platform.isIOS) {
  final dataStore = WKWebsiteDataStore.default();
  final siteRecords = await dataStore.fetchDataRecords(dataTypes: WKWebsiteDataType.values);
  // 匹配目标域名的缓存记录并删除
  for (final record in siteRecords) {
    if (record.displayName.contains("your-spa-site.com")) {
      await dataStore.removeDataOfTypes(
        dataTypes: record.dataTypes,
        forDataRecords: [record],
        completionHandler: () {},
      );
    }
  }
}

方案3：缓存协商+版本参数（体验最优，无首屏加载损耗） #

如果不想每次发版清空缓存导致首屏加载变慢，可配合前端资源规则实现无感更新，不需要主动调用清理接口：

• 要求前端打包时给所有CSS/JS等静态资源文件名加内容hash（Vite、Webpack等主流SPA构建工具默认支持该能力），HTML文件配置Cache-Control: no-cache响应头
• 加载WebView入口时，从服务端获取当前SPA的最新版本号，拼接到入口地址后作为参数，比如https://your-spa-site.com?spa_version=2.1.0，本地记录的版本号和服务端不一致时更新参数，会自动拉取最新的入口HTML，进而加载对应hash的最新静态资源，不会命中旧缓存。

避坑提示：不要依赖WebView自带的reload()方法做更新，该方法默认会优先读取本地缓存，大部分场景下无法拉取到最新的静态资源。

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