在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。
（图片来源网络，侵权删除）
