本文详解如何在使用 FragmentStateAdapter 和 ViewPager2 时，防止 Fragment 在 Tab 切换时被销毁重建，确保状态持久、数据不重载、UI 不闪烁。核心方案包括正确使用 setOffscreenPageLimit() 和避免误用已废弃的 setRetainInstance()。
本文详解如何在使用 `fragmentstateadapter` 和 `viewpager2` 时，防止 fragment 在 tab 切换时被销毁重建，确保状态持久、数据不重载、ui 不闪烁。核心方案包括正确使用 `setoffscreenpagelimit()` 和避免误用已废弃的 `setretaininstance()`。
FragmentStateAdapter 是 ViewPager2 的推荐适配器，它默认采用“按需创建 + 销毁离屏 Fragment”的策略以节省内存——这正是你遇到“Fragment 被重复加载”的根本原因。但请注意：setRetainInstance(true) 在 FragmentStateAdapter 中完全无效且已被弃用（自 AndroidX Fragment 1.3.0 起移除支持），它仅适用于已淘汰的 FragmentPagerAdapter。因此，答案中提及的 setRetainInstance() 方案不仅不适用，还可能导致编译错误或运行时异常。
✅ 正确解决方案是合理设置 ViewPager2 的 offscreenPageLimit：
该参数指定 ViewPager2 在当前页面两侧预加载并保持存活的 Fragment 数量（默认为 1）。例如，若共 3 个 Tab，将 limit 设为 2 即可确保所有 Fragment 始终驻留在内存中，切换时不会调用 createFragment() 重建。
✅ 正确配置方式（推荐）
在设置 Adapter 后、绑定 TabLayout 前，立即设置限制值：
ViewPager2 mViewPager = findViewById(R.id.ViewPager);
TabLayout mTabLayout = findViewById(R.id.TabLayout);
LandingAdapter mAdapter = new LandingAdapter(getSupportFragmentManager(), getLifecycle());
mViewPager.setAdapter(mAdapter);
// ? 关键：设置离屏页保留数量（此处设为 fragment 总数 - 1）
int tabCount = mAdapter.getItemCount();
if (tabCount > 0) {
mViewPager.setOffscreenPageLimit(tabCount - 1); // 保留全部相邻页
}
// 添加 Fragment（保持原有逻辑）
int savedAppMode = SharedPrefs.getInt(this, "app_mode_checked_item", 0);
if (savedAppMode == 1) {
mAdapter.addFragment(new ItemsFrag1());
mAdapter.addFragment(new ContactsFrag1());
mAdapter.addFragment(new ImagesFrag1());
} else {
mAdapter.addFragment(new ItemsFrag2());
mAdapter.addFragment(new ContactsFrag2());
mAdapter.addFragment(new ImagesFrag2());
}
new TabLayoutMediator(mTabLayout, mViewPager, (tab, position) -> {
// ... tab 设置逻辑（保持不变）
}).attach();
⚠️ 注意事项与最佳实践
- 不要盲目设为 Integer.MAX_VALUE：虽能强制保留全部 Fragment，但会显著增加内存占用，尤其当 Fragment 内含大图、视频或复杂 View 树时，易引发 OOM。
- offscreenPageLimit 最小值为 1：设为 0 会被自动修正为 1，无法禁用预加载。
- Fragment 生命周期不受影响：即使 Fragment 未销毁，其 onResume()/onPause() 仍会随可见性正常回调，业务逻辑（如网络请求、动画）需自行判断 isVisible() 或使用 viewLifecycleOwner。
-
Adapter 设计优化建议：当前 LandingAdapter 使用 List
存储实例，存在内存泄漏风险（Fragment 持有 Activity 引用）。更健壮的方式是改用 List > + 反射创建，或直接在 createFragment(int) 中根据 position 返回新实例（推荐）：
@Override
public Fragment createFragment(int position) {
switch (position) {
case 0:
return savedAppMode == 1 ? new ItemsFrag1() : new ItemsFrag2();
case 1:
return savedAppMode == 1 ? new ContactsFrag1() : new ContactsFrag2();
case 2:
return savedAppMode == 1 ? new ImagesFrag1() : new ImagesFrag2();
default:
throw new IllegalArgumentException("Invalid position: " + position);
}
}
这样既避免持有 Fragment 实例，又确保 getItemId() 可基于 position 稳定返回（无需 hashCode()，避免哈希冲突）。
✅ 总结
解决 ViewPager2 Tab 切换时 Fragment 重载问题，唯一可靠且现代的方式是：
? 调用 ViewPager2.setOffscreenPageLimit(N)，其中 N = fragmentCount - 1；
? 彻底弃用 setRetainInstance()（已废弃且不兼容 FragmentStateAdapter）；
? 优化 Adapter 实现，避免强引用 Fragment 实例，提升内存安全性与可维护性。
通过以上调整，你的 Fragment 将在 Tab 切换中保持状态、跳过重建流程，用户体验显著提升。
