使用Bottom Navigation Views模板新建项目Fragment状态无法保留求助

核心前提 #

确保你的项目使用Navigation 2.4.0-alpha01及以上版本，这是多回退栈和状态自动保存的基础。

排查与修复步骤 #

1. 核对依赖版本
   打开模块级build.gradle（或build.gradle.kts），确认Navigation相关依赖版本达标，例如：

   dependencies {
       implementation "androidx.navigation:navigation-fragment-ktx:2.7.7"
       implementation "androidx.navigation:navigation-ui-ktx:2.7.7"
   }
   

   同步项目后再测试。

2. 清理Activity中多余的Fragment切换逻辑
   Android Studio的Bottom Navigation模板可能会生成手动切换Fragment的代码（比如OnNavigationItemSelectedListener+replace事务），这会覆盖Navigation默认的多回退栈逻辑。请删除这类代码，只保留Navigation的初始化和绑定代码：

   class MainActivity : AppCompatActivity() {
       override fun onCreate(savedInstanceState: Bundle?) {
           super.onCreate(savedInstanceState)
           setContentView(R.layout.activity_main)
           val navView: BottomNavigationView = findViewById(R.id.nav_view)
   
           val navController = findNavController(R.id.nav_host_fragment_activity_main)
           // 仅保留这一行绑定代码，删除手动的item选中监听
           navView.setupWithNavController(navController)
       }
   }
   

3. 确保导航图与底部菜单ID匹配
   打开res/navigation/nav_graph.xml，检查每个目的地的id是否和res/menu/bottom_nav_menu.xml中对应的item id完全一致。比如：

   • 导航图中首页目的地id为@+id/homeFragment
   • 底部菜单中首页item的id也必须是@+id/homeFragment
     不匹配会导致Navigation无法正确关联回退栈，每次切换都会重建Fragment。

4. 避免手动调用saveState/restoreState
   Navigation 2.4+版本中，setupWithNavController()已经自动处理Fragment的状态保存与恢复，手动调用saveState()或restoreState()会干扰默认逻辑，建议移除这类代码。

验证 #

完成上述步骤后，切换底部导航栏，Fragment的输入内容、滚动位置等状态应该会被正确保留，不会每次切换都重建实例。

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