WebView 預設禁用 DOM Storage,導致 H5 頁面無法使用 localStorage / sessionStorage。本文給出最小化、可直接複製的配置代碼,解決「存不進、讀不出」的常見問題。
WebView webView = findViewById(R.id.webview);
WebSettings settings = webView.getSettings();
// 1. 啟用 JavaScript(前提)
settings.setJavaScriptEnabled(true);
// 2. 關鍵:啟用 DOM Storage(localStorage/sessionStorage 依賴此項)
settings.setDomStorageEnabled(true);
// 3. 可選:啟用 Application Cache(HTML5 離線緩存)
settings.setAppCacheEnabled(true);
settings.setAppCacheMaxSize(8 * 1024 * 1024); // 8MB
String cacheDir = getCacheDir().getAbsolutePath();
settings.setAppCachePath(cacheDir);
// 4. 可選:允許文件訪問(部分舊設備需要)
settings.setAllowFileAccess(true);
settings.setAllowContentAccess(true);
// 5. 可選:資料庫存儲路徑(舊版 Web SQL Database 用)
settings.setDatabaseEnabled(true);
String dbPath = getDir("database", MODE_PRIVATE).getPath();
settings.setDatabasePath(dbPath);
// 6. 地理定位權限(如 H5 需用)
settings.setGeolocationEnabled(true);
file:// 協議下 localStorage 共享受限,建議使用 WebViewAssetLoader 或本地 HTTP Server 方案。QuotaExceededError,需捕獲處理。webView.evaluateJavascript(
"try { localStorage.setItem('test', '1'); localStorage.removeItem('test'); 'OK'; } catch(e) { e.message; }",
value -> Log.d("WebView", "localStorage test: " + value)
);
配置上述項目後,WebView 即可完整支援 HTML5 本地存儲 API,滿足離線緩存、用戶偏好保存等場景需求。