Android使用Navigation graph点击按钮无法跳转Fragment如何解决

核心错误修复 #

你当前的点击事件仅生成了导航方向对象，未调用导航方法执行跳转操作，这是跳转失败的核心原因，修改点击事件代码如下：

binding.playVideos.setOnClickListener {
    // 构造导航方向
    val direction = HomeFragmentDirections.actionHomeFragmentToPlayerFragment()
    // 获取NavController并执行导航
    findNavController().navigate(direction)
}

如果上述修改后仍无法跳转，按以下步骤逐一排查：

• 检查Safe Args依赖配置是否正确
  确认module级build.gradle文件中已添加Safe Args插件和对应依赖，否则HomeFragmentDirections类无法正常生成，可能会触发运行时异常导致跳转失败：

  // 插件声明部分（plugins代码块）
  id 'androidx.navigation.safeargs.kotlin'
  // 依赖部分
  implementation "androidx.navigation:navigation-fragment-ktx:2.5.3"
  implementation "androidx.navigation:navigation-ui-ktx:2.5.3"
  

  版本可替换为项目中正在使用的稳定版即可。
• 验证点击事件是否正常触发
  在点击回调中添加Log打印或断点调试，确认点击按钮时该回调被执行，排除binding.playVideos和布局中按钮id不匹配、点击事件被上层控件拦截等问题。
• 检查NavController获取是否正确
  如果在Fragment中调用findNavController()报错，可改用以下稳定方式获取：

  val navHostFragment = requireActivity().supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
  val navController = navHostFragment.navController
  navController.navigate(direction)
  

• 排查PlayerFragment运行异常
  若跳转执行后仍无显示，检查PlayerFragment的onCreateView、onViewCreated等生命周期方法是否存在崩溃逻辑，可添加Log验证PlayerFragment的生命周期是否正常回调，排除页面创建失败导致的无显示问题。

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