View未设置NavController问题求助（底部导航+Koin+嵌套导航）

问题根源 #

你当前的底部导航实现完全违背了Navigation Component的设计逻辑：

• 通过FragmentTransaction.replace直接实例化并替换Fragment，而非依赖Navigation Component管理导航栈。Fragment3属于嵌套导航图，它应该是NavHostFragment管控的导航目的地，而非独立实例化的Fragment。
• 直接创建Fragment3()实例时，其视图层级中没有对应的NavHostFragment，也就不存在NavController。而koinNavGraphViewModel需要通过NavController获取导航图作用域，因此抛出View does not have a NavController set异常。

解决方案 #

1. 修正主导航图配置

在res/navigation/main_nav_graph.xml中引入Fragment3的嵌套导航图，确保底部菜单项ID与导航图目的地ID一致：

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/main_nav_graph"
    app:startDestination="@id/fragment1">

    <!-- 其他一级目的地 -->
    <fragment
        android:id="@+id/fragment1"
        android:name="com.example.coursecpm.Fragment1"
        android:label="Fragment1" />
    <fragment
        android:id="@+id/fragment2"
        android:name="com.example.coursecpm.Fragment2"
        android:label="Fragment2" />

    <!-- 引入嵌套导航图作为底部菜单项的目的地 -->
    <include app:graph="@navigation/fragment_3_nav_graph" />

    <fragment
        android:id="@+id/fragment4"
        android:name="com.example.coursecpm.Fragment4"
        android:label="Fragment4" />
    <fragment
        android:id="@+id/fragment5"
        android:name="com.example.coursecpm.Fragment5"
        android:label="Fragment5" />

</navigation>

嵌套导航图fragment_3_nav_graph.xml示例（确保Fragment3为起始目的地）：

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/fragment_3_nav_graph"
    app:startDestination="@id/fragment3">

    <fragment
        android:id="@+id/fragment3"
        android:name="com.example.coursecpm.Fragment3"
        android:label="Fragment3" />

    <!-- 嵌套图中的其他目的地（如有） -->
</navigation>

2. 重构MainActivity的底部导航逻辑

删除手动replace Fragment的代码，改用NavigationUI绑定底部导航栏与NavController：

class MainActivity : AppCompatActivity(), BottomNavBarVisibilityController {

    lateinit var binding: ActivityMainBinding
    private lateinit var navController: NavController

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)

        // 获取NavHostFragment的NavController
        val navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment_container) as NavHostFragment
        navController = navHostFragment.navController

        setupBottomNav()
    }

    override fun showBottomNavBar() {
        binding.bottomNavBar.visibility = View.VISIBLE
    }

    override fun hideBottomNavBar() {
        binding.bottomNavBar.visibility = View.GONE
    }

    private fun setupBottomNav() {
        // 绑定底部导航与NavController
        NavigationUI.setupWithNavController(binding.bottomNavBar, navController)
        // 设置默认选中项
        binding.bottomNavBar.selectedItemId = R.id.fragment3
    }
}

同时确保布局中的容器是NavHostFragment而非普通FrameLayout：

<!-- activity_main.xml中的容器 -->
<androidx.fragment.app.FragmentContainerView
    android:id="@+id/nav_host_fragment_container"
    android:name="androidx.navigation.fragment.NavHostFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:navGraph="@navigation/main_nav_graph" />

3. 修正Koin ViewModel配置

保留原有模块声明即可，navGraphViewModel会自动识别嵌套导航图的作用域：

val appModule = module {
    viewModel { Fragment3FlowViewModel() }
}

Fragment3中的ViewModel引用无需修改：

private val viewModel: Fragment3FlowViewModel by koinNavGraphViewModel(R.id.fragment_3_nav_graph)

关键注意事项 #

• 永远不要手动实例化Fragment并通过replace实现底部导航，这会破坏Navigation Component的导航栈和作用域管理机制。
• 嵌套导航图的作用域由NavController维护，只有通过Navigation Component导航到Fragment3时，才能正确获取对应的NavController和作用域内的ViewModel。

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