Android Navigation组件Fragment重建问题及解决方案咨询

方案1：优化ViewModel+Compose状态保存，解决LazyColumn滚动状态丢失问题 #

针对ViewModel保存状态时LazyColumn滚动状态无法保留的痛点，核心是为每个ViewPager页面的LazyColumn状态绑定独立的保存键，同时缓存列表数据减少重建损耗：

• 为每个ViewPager页面的LazyListState单独持久化：

@Composable
fun FragmentAContent(
    pagerState: PagerState,
    viewModel: FragmentAViewModel
) {
    HorizontalPager(
        state = pagerState,
        pageCount = viewModel.tabCount
    ) { page ->
        // 用页面索引作为键，单独保存对应LazyColumn的滚动状态
        val listState = rememberSaveable(key = "lazy_list_state_$page") {
            LazyListState()
        }
        LazyColumn(state = listState) {
            items(viewModel.getListData(page)) { item ->
                ItemRow(item) {
                    // 点击导航到Fragment B的逻辑
                }
            }
        }
    }
}

• ViewModel缓存各页面列表数据，避免重建时重复加载：

class FragmentAViewModel : ViewModel() {
    private val pageDataCache = mutableMapOf<Int, List<Item>>()
    var selectedPage by mutableStateOf(0)

    fun getListData(page: Int): List<Item> {
        return pageDataCache.getOrPut(page) {
            fetchDataForPage(page) // 仅首次加载对应页面数据
        }
    }
}

• Fragment中同步ViewPager状态到ViewModel，重建时恢复：

class FragmentA : Fragment() {
    private val viewModel by viewModels<FragmentAViewModel>()

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        return ComposeView(requireContext()).apply {
            setContent {
                val pagerState = rememberPagerState(initialPage = viewModel.selectedPage) {
                    viewModel.tabCount
                }
                LaunchedEffect(pagerState.currentPage) {
                    viewModel.selectedPage = pagerState.currentPage
                }
                FragmentAContent(pagerState, viewModel)
            }
        }
    }
}

方案2：自定义极简版FragmentNavigator，替换为Add操作 #

如果不想完全背离Navigation设计，可自定义极简Navigator，将默认的Replace行为改为Add，避免Fragment A被销毁：

• 创建自定义Navigator：

class AddFragmentNavigator(
    context: Context,
    manager: FragmentManager,
    containerId: Int
) : FragmentNavigator(context, manager, containerId) {
    override fun navigate(
        entries: List<NavBackStackEntry>,
        navOptions: NavOptions?,
        navigatorExtras: Navigator.Extras?
    ) {
        val ft = manager.beginTransaction()
        entries.forEach { entry ->
            val fragment = createFragment(entry)
            ft.add(containerId, fragment, entry.id)
        }
        ft.addToBackStack(entries.last().id)
        ft.setReorderingAllowed(true)
        ft.commit()
    }
}

• 在NavHost中注册自定义Navigator：

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            val navHostController = rememberNavController()
            LaunchedEffect(Unit) {
                navHostController.navigatorProvider.addNavigator(
                    AddFragmentNavigator(
                        context = this@MainActivity,
                        manager = supportFragmentManager,
                        containerId = R.id.nav_host_fragment
                    )
                )
            }
            NavHost(
                navController = navHostController,
                startDestination = "fragment_a",
                modifier = Modifier.fillMaxSize()
            ) {
                composable("fragment_a") { FragmentA() }
                composable("fragment_b") { FragmentB() }
                composable("fragment_c") { FragmentC() }
            }
        }
    }
}

方案3：利用Navigation自带栈管理优化状态保留 #

通过配置导航参数，让Fragment A保留在栈中并自动恢复状态：

• 导航到Fragment B时设置参数：

// Fragment A中点击导航的逻辑
navController.navigate("fragment_b") {
    popUpTo("fragment_a") {
        inclusive = false
        saveState = true
    }
    restoreState = true
}

• 导航图中开启Fragment A的状态保存：

<fragment
    android:id="@+id/fragment_a"
    android:name="com.example.FragmentA"
    android:saveEnabled="true"
    android:label="Fragment A">
    <action
        android:id="@+id/action_fragment_a_to_fragment_b"
        app:destination="@id/fragment_b"
        app:popUpTo="@id/fragment_a"
        app:popUpToInclusive="false"
        app:saveState="true"
        app:restoreState="true"/>
</fragment>

内容的提问来源于stack exchange，提问作者V I J E S H