Android WebView onPageFinished 回調時頁面未真正加載完成的解決方案

問題現象

`WebViewClient.onPageFinished()` 回調觸發時，頁面（如淘寶登錄頁）實際仍在加載中（AJAX 異步請求未完成），截圖顯示內容不全。

根本原因

• `onPageFinished` 僅表示**主文檔 HTML 解析完成**，不代表所有子資源 (JS、CSS、圖片、AJAX、iframe) 加載完畢。
• 現代頁面大量使用 **AJAX/Fetch 異步渲染**、**SPA 路由**、**懶加載圖片**，主文檔結束時 DOM 尚未就緒。

解決方案對比

推薦實踐：固定延遲 + readyState 輪詢折中方案

webView.setWebViewClient(new WebViewClient() {
    @Override
    public void onPageFinished(WebView view, String url) {
        // 方案：延遲 500ms 後開始輪詢 readyState
        new Handler(Looper.getMainLooper()).postDelayed(() -> {
            checkReadyState(view, 0);
        }, 500);
    }
    
    private void checkReadyState(WebView view, int attempt) {
        if (attempt > 20) { // 最多等待 10 秒
            takeSnapshot(view); // 超時強制截圖
            return;
        }
        view.evaluateJavascript("document.readyState", value -> {
            if ("complete".equals(value.replace("\"", ""))) {
                takeSnapshot(view);
            } else {
                new Handler(Looper.getMainLooper()).postDelayed(() -> 
                    checkReadyState(view, attempt + 1), 500);
            }
        });
    }
    
    private void takeSnapshot(WebView view) {
        // 截圖/打印/其他操作
        Bitmap bitmap = Bitmap.createBitmap(view.getWidth(), view.getHeight(), Bitmap.Config.ARGB_8888);
        view.draw(new Canvas(bitmap));
        // 保存 bitmap...
    }
});

針對淘寶等複雜頁面的特殊處理

• **注入自定義 JS**：在 `onPageStarted` 中 `addJavascriptInterface` 暴露 `onAjaxComplete`，頁面業務代碼調用（需協商）。
• **關鍵元素輪詢**：`evaluateJavascript("document.querySelector('.login-btn') !== null", ...)` 等待核心元素出現。
• **放棄完美**：對不可控第三方頁面，接受「視覺基本穩定」即可，設置合理超時 (3-5s) 強制截圖。

最佳回答核心：「淘寶是 ajax 異步加載的，建議你加上點延遲看看」—— 直指異步加載本質，給出工程上可行的折中方案。