在使用 NavController 时，有哪些常见的错误需要避免？

在使用 NavController 时，以下是一些常见的错误和注意事项，以及如何避免它们：

1、获取 NavController 实例的错误：
确保在正确的生命周期内获取 NavController。例如，不要在 Activity 的 onCreate 方法中直接获取 NavHostFragment 的 NavController，因为在 onCreate 中 NavHostFragment 可能还没有完全创建好。应该在 onStart 或 onResume 生命周期方法中获取 。

2、Fragment 嵌套问题：
当你尝试将一个 Fragment 嵌套在另一个 Fragment 中时，可能会遇到 “Fragment already added” 的异常。为了避免这个问题，使用 FragmentContainerView 来嵌套 Fragment 。

3、底部导航栏图标无法动态更新：
如果你在 XML 布局文件中指定了图标的 tint，它可能会覆盖导航图中设置的图标。解决方案是在 XML 布局文件中删除 tint 属性，让导航图中的图标生效

4、ViewPager 与 Navigation 冲突：
使用 ViewPager 可能会与 Navigation 组件发生冲突。解决方案是使用 ViewPager2，它与 Navigation 组件兼容 。

5、自适应导航栏与 Navigation 冲突：
在 Android 10 中引入的自适应导航栏可能会与 Navigation 发生冲突。解决方案是在应用程序清单文件中添加以下代码，禁用自适应导航栏

<meta-data android:name="android.max_aspect_ratio" android:value="1.0" />

6、内存泄漏问题：
在某些情况下，NavController 可能会导致内存泄漏，尤其是当导航图中的 Fragment 没有被正确释放时。确保在 Fragment 的生命周期方法中正确管理资源，例如在 onDestroy 中进行必要的清理工作。

7、错误的导航目的地：
确保在 NavController.navigate() 调用中使用正确的目的地 ID。如果目的地 ID 错误，可能会导致应用崩溃。使用 try-catch 来捕获可能的 IllegalArgumentException 可以避免应用因为这个问题而崩溃 。

8、Toolbar/ActionBar 设置问题：
如果你的 Activity 使用了 Toolbar，需要将其使用的 Theme 设置为 noActionBar，否则可能会遇到错误。

9、菜单与 navigation 中的 ID 不匹配：
确保 BottomNavigationView 或其他组件使用的 menu 中的 ID 与导航图中的目的地 ID 匹配。每个 item 和 fragment 都是一一对应的关系，而且其 ID 必须相同。

10、使用 popBackStack() 时的错误：
当 popBackStack() 返回 false 时，意味着已经从返回堆栈中弹出最后一个目的地。在这种情况下，你可能需要导航到新目的地或结束当前 Activity。

11、在 Fragment 中使用 NavController：
在 Fragment 中使用 NavController 时，确保使用 Fragment.findNavController() 方法来获取实例。

12、在 Activity 中使用 NavController：
在 Activity 中，可以通过 Activity.findNavController(viewId) 方法来获取 NavController 实例。