ViewPager + Fragment 滑動切換數據丟失、事件失效？setOffscreenPageLimit 解決

現象

• ViewPager 包含多個 Fragment。
• 滑到第 3 頁，再滑回第 1 頁 → **第 1 頁數據消失、點擊事件失效**。

根本原因

ViewPager 默認 **銷毀離屏頁面** 以節省內存：

• setOffscreenPageLimit(1) 默認值 → **只保留當前頁左右各 1 頁**。
• 滑到第 3 頁時，第 1 頁超出範圍 → onDestroyView() 被調用 → View 被銷毀、數據清空。
• 滑回時重新走 onCreateView() → 若未做緩存/恢復邏輯 → **空白/事件丟失**。

解決方案對比

方案二：Fragment 標準懶加載模板（推薦長期項目）

public abstract class BaseLazyFragment extends Fragment {
    private boolean isViewCreated = false;
    private boolean isVisibleToUser = false;
    private boolean isDataLoaded = false;

    @Override
    public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
        super.onViewCreated(view, savedInstanceState);
        isViewCreated = true;
        tryLoadData();
    }

    @Override
    public void setUserVisibleHint(boolean isVisibleToUser) {
        super.setUserVisibleHint(isVisibleToUser);
        this.isVisibleToUser = isVisibleToUser;
        tryLoadData();
    }

    private void tryLoadData() {
        if (isViewCreated && isVisibleToUser && !isDataLoaded) {
            loadData();
            isDataLoaded = true;
        }
    }

    // 子類實現具體加載邏輯
    protected abstract void loadData();

    @Override
    public void onDestroyView() {
        super.onDestroyView();
        isViewCreated = false;
        isDataLoaded = false; // 視業務決定是否重置
    }
}

關鍵點提醒

• setOffscreenPageLimit **必須在設置 Adapter 之前調用** 生效。
• Fragment **不要在 onCreateView 做耗時初始化**，放入 loadData() 或 onViewCreated。
• 事件失效通常因 **View 重建後未重新綁定監聽器** → 懶加載模板中 onViewCreated 會重新綁定。
• ViewPager2 已棄用 setUserVisibleHint，改用 FragmentTransaction.setMaxLifecycle()，遷移時注意。

最佳實踐建議

1. **頁面少（≤5）、輕量** → 直接 setOffscreenPageLimit(totalCount)，最省事。
2. **頁面多/重、長列表** → 實現懶加載模板 + setOffscreenPageLimit(1~2)。
3. **新項目** → 直接上 **ViewPager2 + FragmentStateAdapter**，體驗更佳。

ViewPager 銷毀重建是設計使然，**要么加大緩存，要么做好懶加載與狀態恢復**，二選一，不可兼顧。