您现在的位置：程式碼之家 >> 編程語言 > >> 更多程式語言 >> 程式設計綜合問答

Android Fragment + WebView 返回鍵監聽 Bug：canGoBack 失效根因與修正

編輯：程式設計綜合問答

場景：Activity 含 4 個 Fragment，每個 Fragment 內嵌一個 WebView。Activity 統一攔截返回鍵，調用當前 Fragment 的 `webView.goBack()`。現象：進入 A Fragment → 切換到 B Fragment（不操作） → 返回 A Fragment，此時 `webView.canGoBack()` 返回 `false`，直接觸發退出邏輯。

根因分析

現象	原因
B Fragment 的 WebView 從未加載過頁面/未發生導航	`canGoBack()` 只有在歷史棧長度 > 1 時才返回 true。剛建立、未跳轉的 WebView 歷史棧只有初始頁，故為 false
返回 A Fragment 時，邏輯錯誤地檢查了 B Fragment 的 WebView	代碼可能在 `onBackPressed` 中遍歷所有 Fragment 的 WebView，或引用了錯誤的 Fragment 實例
Fragment 重建導致 WebView 實例變化	若使用 `replace` + `addToBackStack`，返回時可能重新 `onCreateView` 建立新 WebView，歷史棧丟失

正確的返回鍵處理模式

1. 每個 Fragment 自己處理自己的 WebView 返回


public class WebFragment extends Fragment {
    private WebView webView;

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        View view = inflater.inflate(R.layout.fragment_web, container, false);
        webView = view.findViewById(R.id.webView);
        webView.setWebViewClient(new WebViewClient());
        webView.loadUrl("https://example.com");
        return view;
    }

    // 供 Activity 調用
    public boolean handleBackPress() {
        if (webView != null && webView.canGoBack()) {
            webView.goBack();
            return true; // 消費事件
        }
        return false; // 未消費，交給 Activity 處理（如退出應用）
    }
}

2. Activity 只委派給當前可見 Fragment


public class MainActivity extends AppCompatActivity {
    @Override
    public void onBackPressed() {
        Fragment current = getSupportFragmentManager().findFragmentById(R.id.container);
        if (current instanceof WebFragment) {
            if (((WebFragment) current).handleBackPress()) {
                return; // Fragment 已處理
            }
        }
        // 也可檢查 ViewPager 當前頁面
        // Fragment current = adapter.getItem(viewPager.getCurrentItem());

        super.onBackPressed(); // 默認退出/彈棧
    }
}

3. 使用 `hide`/`show` 而非 `replace` 保持 WebView 狀態


// 切換 Fragment 時
FragmentTransaction ft = getSupportFragmentManager().beginTransaction();
if (targetFragment.isAdded()) {
    ft.hide(currentFragment).show(targetFragment);
} else {
    ft.hide(currentFragment).add(R.id.container, targetFragment);
}
ft.commit();
// 這樣 WebView 實例不銷毀，歷史棧、滾動位置、JS 狀態全保留

常見錯誤代碼對比


// ❌ 錯誤：在 Activity 直接持有 4 個 WebView 引用，切換時引用錯亂
WebView wv1, wv2, wv3, wv4;
@Override public void onBackPressed() {
    if (wv1.canGoBack()) { wv1.goBack(); return; } // 若當前是 Fragment2，wv1 可能不可見但仍持有舊實例
    ...
}

// ✅ 正確：Fragment 封裝 WebView 並暴露 handleBackPress()

進階：WebView 狀態保存與恢復（跨進程死亡重建）


@Override
public void onSaveInstanceState(@NonNull Bundle outState) {
    super.onSaveInstanceState(outState);
    webView.saveState(outState); // 保存歷史棧、滾動、表單數據
}

@Override
public void onViewStateRestored(@Nullable Bundle savedInstanceState) {
    super.onViewStateRestored(savedInstanceState);
    if (savedInstanceState != null) {
        webView.restoreState(savedInstanceState);
    }
}