为什么在使用NavHostFragment时会遇到报错问题？-HCRM博客

在Android开发中，NavHostFragment 是一个用于承载其他Fragment 的容器，它通常与 Android Jetpack Navigation 组件一起使用，以实现应用内的导航功能，在实际使用过程中，开发者可能会遇到一些错误和问题，以下是关于NavHostFragment 报错的详细解析及解决方案：

常见错误及解决方案

（图片来源网络，侵权删除）

错误类型	错误描述	解决方案
IllegalStateException	`Activity ...MainActivity@797467d does not have a NavController set on 2131296504`	在使用`FragmentContainerView` 作为`NavHostFragment` 时，尝试通过`Navigation.findNavController(Activity, @IdRes int)` 在 Activity 的`onCreate()` 中检索`NavController` 将失败，应直接从`NavHostFragment` 检索`NavController`。
NullPointerException	在`MainActivity.kt` 文件中，`navController` 返回`null`，导致程序崩溃。	确保在 xml 布局文件中正确设置了`app:navGraph="@navigation/nav_graph"`，并在 Activity 中正确初始化了`NavController`。
Custom Navigator Crash	自定义`NavHostFragment` 和`FragmentNavigator` 后，程序直接崩溃。	检查自定义的`NavHostFragment` 和`FragmentNavigator` 代码，确保没有逻辑错误或配置不当，确保正确设置了`mFragmentManager`、`mContext` 和`mContainerId`。
Dependency Issue	由于依赖库版本不匹配或冲突，导致`NavHostFragment` 无法正常工作。	确保在`build.gradle` 文件中添加了正确的依赖库版本，并同步项目以解决依赖冲突。

示例代码

以下是一个简单的示例，展示了如何在 Android 项目中使用NavHostFragment：

app/build.gradle

dependencies {
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.0.1'
    implementation 'androidx.legacy:legacysupportv4:1.0.0'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'androidx.test.ext:junit:1.1.2'
    androidTestImplementation 'androidx.test.espresso:espressocore:3.3.0'
    def nav_version = '2.1.0'
    implementation "androidx.navigation:navigationfragment:$nav_version"
    implementation "androidx.navigation:navigationui:$nav_version"
}

res/layout/activity_main.xml

<?xml version="1.0" encoding="utf8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/resauto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
    <fragment
        android:id="@+id/fragment_nav_host"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:name="androidx.navigation.fragment.NavHostFragment"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:navGraph="@navigation/nav_graph_main"
        app:defaultNavHost="true"
        />
</androidx.constraintlayout.widget.ConstraintLayout>

MainActivity.kt

class MainActivity : AppCompatActivity() {
    private lateinit var toolbar: Toolbar
    private val navController by lazy {
        (supportFragmentManager.findFragmentById(R.id.fragment_nav_host) as NavHostFragment).navController
    }
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        toolbar = findViewById(R.id.mainToolBar)
        setSupportActionBar(toolbar)
        setupActionBarWithNavController(navController)
    }
    override fun onCreateOptionsMenu(menu: Menu?): Boolean {
        val inflater: MenuInflater = menuInflater
        inflater.inflate(R.menu.main_menu_bar, menu)
        return true
    }
}

FAQs（常见问题解答）

（图片来源网络，侵权删除）

1、为什么使用FragmentContainerView 作为NavHostFragment 时会报错？

答：在使用FragmentContainerView 作为NavHostFragment 时，尝试通过Navigation.findNavController(Activity, @IdRes int) 在 Activity 的onCreate() 中检索NavController 将失败，应该直接从NavHostFragment 检索NavController。

2、如何正确设置NavController？

答：在 xml 布局文件中，确保正确设置了app:navGraph="@navigation/nav_graph"，并在 Activity 中通过(supportFragmentManager.findFragmentById(R.id.fragment_nav_host) as NavHostFragment).navController 来正确初始化NavController。