BottomNavigationView切换Fragment时导航状态无法持久化及避免Fragment重建的方案咨询

这确实是Navigation组件搭配BottomNavigationView时的常见坑——默认情况下，切换底部导航项时，未选中的Fragment会被销毁，切回来时重新创建，导致之前的深层导航路径、用户修改的视图状态全丢了。下面给你几个实用的解决方案，按推荐程度排序：

方案一：手动用hide/show管理Fragment（最推荐） #

放弃Navigation组件默认的setupWithNavController，自己通过FragmentManager的hide()和show()来维护Fragment实例，这样Fragment不会被销毁，所有状态自然保留。

具体实现步骤： #

1. 在Activity中提前创建所有底部导航对应的Fragment实例，存在一个Map里方便快速获取
2. 首次启动时显示默认的Fragment
3. 给BottomNavigationView设置选中监听器，切换时隐藏当前显示的Fragment，显示目标Fragment（如果还没添加就先add）

示例代码（Kotlin）：

class MainActivity : AppCompatActivity() {
    private val fragmentMap = mutableMapOf<Int, Fragment>()
    private var currentFragment: Fragment? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // 初始化所有底部导航对应的Fragment实例
        fragmentMap[R.id.nav_home] = HomeFragment()
        fragmentMap[R.id.nav_dashboard] = DashboardFragment()
        fragmentMap[R.id.nav_notifications] = NotificationsFragment()

        // 默认显示首页Fragment
        currentFragment = fragmentMap[R.id.nav_home]
        supportFragmentManager.beginTransaction()
            .add(R.id.fragment_container, currentFragment!!)
            .commit()

        // 处理底部导航选中事件
        bottom_navigation.setOnItemSelectedListener { item ->
            val targetFragment = fragmentMap[item.itemId] ?: return@setOnItemSelectedListener false
            if (targetFragment != currentFragment) {
                supportFragmentManager.beginTransaction().apply {
                    currentFragment?.let { hide(it) }
                    if (!targetFragment.isAdded) {
                        add(R.id.fragment_container, targetFragment)
                    }
                    show(targetFragment)
                    commit()
                }
                currentFragment = targetFragment
            }
            true
        }
    }
}

这种方式的好处是完全规避了Fragment销毁重建的问题，用户的所有操作状态（包括深层导航、输入框内容等）都会完整保留，逻辑也清晰易懂。

方案二：基于Navigation组件的状态保存与恢复 #

如果你不想放弃Navigation组件的便利，可以通过保存每个导航目的地的状态，切回来时恢复。核心是利用NavController的saveState()和restoreState()方法，配合launchSingleTop和restoreState的NavOptions。

具体实现： #

在Activity中维护每个底部导航项对应的导航状态，切换时保存当前状态，切回时恢复目标状态：

class MainActivity : AppCompatActivity() {
    private val navHostStates = mutableMapOf<Int, Bundle?>()
    private var currentNavId: Int = R.id.nav_home

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        val navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
        val navController = navHostFragment.navController

        // 处理底部导航切换
        bottom_navigation.setOnItemSelectedListener { item ->
            val targetId = item.itemId
            if (targetId != currentNavId) {
                // 保存当前导航的状态
                navHostStates[currentNavId] = navController.saveState()
                // 切换到目标目的地，配置单顶启动+恢复状态
                navController.navigate(
                    targetId,
                    null,
                    NavOptions.Builder()
                        .setLaunchSingleTop(true)
                        .setRestoreState(true)
                        .build()
                )
                currentNavId = targetId
                // 恢复目标目的地的之前状态
                navHostStates[targetId]?.let { navController.restoreState(it) }
            }
            true
        }

        // 恢复Activity重建前的状态
        savedInstanceState?.let {
            currentNavId = it.getInt("currentNavId")
            navHostStates.putAll(it.getSerializable("navHostStates") as Map<Int, Bundle?>)
            navHostStates[currentNavId]?.let { state -> navController.restoreState(state) }
        }
    }

    override fun onSaveInstanceState(outState: Bundle) {
        super.onSaveInstanceState(outState)
        val navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
        // 保存当前导航的最新状态
        navHostStates[currentNavId] = navHostFragment.navController.saveState()
        outState.putInt("currentNavId", currentNavId)
        outState.putSerializable("navHostStates", navHostStates as Serializable)
    }
}

注意：这个方案需要确保Navigation组件版本足够新（建议用2.4.0+），部分复杂场景下可能会出现状态恢复不彻底的情况，需要额外测试。

方案三：通过ViewModel/savedInstanceState手动恢复状态 #

如果上述两种方案都不适合，你可以选择手动保存深层导航的路径和视图状态，在Fragment重建后恢复。这种方式更灵活，但需要写更多代码。

具体实现： #

1. 创建一个ViewModel来保存导航状态（ViewModel在Fragment重建时不会销毁，比savedInstanceState更可靠）
2. 当导航到深层页面时，记录目的地ID和参数
3. 在Fragment重建时，检查ViewModel中的状态，手动导航回深层页面，同时恢复视图内容

示例代码：
首先定义ViewModel：

class HomeNavViewModel : ViewModel() {
    var deepDestination: Int? = null
    var deepArgs: Bundle? = null
    // 可以额外保存视图状态，比如输入框文本
    var inputText: String? = null
}

然后在HomeFragment中使用：

class HomeFragment : Fragment() {
    private lateinit var viewModel: HomeNavViewModel
    private lateinit var inputEt: EditText

    override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
        val view = inflater.inflate(R.layout.fragment_home, container, false)
        inputEt = view.findViewById(R.id.input_et)
        return view
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        viewModel = ViewModelProvider(this)[HomeNavViewModel::class.java]

        // 恢复视图状态
        viewModel.inputText?.let { inputEt.setText(it) }

        // 恢复深层导航状态
        viewModel.deepDestination?.let { dest ->
            findNavController().navigate(dest, viewModel.deepArgs)
            // 清空状态，避免重复导航
            viewModel.deepDestination = null
            viewModel.deepArgs = null
        }

        // 监听输入框变化，保存到ViewModel
        inputEt.addTextChangedListener(object : TextWatcher {
            override fun afterTextChanged(s: Editable?) {
                viewModel.inputText = s.toString()
            }
            override fun beforeTextChanged(s: CharSequence?, start: Int, count: Int, after: Int) {}
            override fun onTextChanged(s: CharSequence?, start: Int, before: Int, count: Int) {}
        })

        // 导航到深层页面时保存状态
        view.findViewById<Button>(R.id.go_deep_btn).setOnClickListener {
            val args = Bundle().apply { putString("key", "value") }
            findNavController().navigate(R.id.deep_fragment, args)
            viewModel.deepDestination = R.id.deep_fragment
            viewModel.deepArgs = args
        }
    }
}

这种方式适合需要精细控制某些状态的场景，但需要逐个处理需要恢复的视图和导航状态，代码量会多一些。

内容的提问来源于stack exchange，提问作者ivan