Ошибка "navigation destination unknown to this NavController" в Android Navigation

Причина ошибки и основное решение

Ошибка IllegalArgumentException: navigation destination xxx is unknown to this NavController возникает, когда NavController не может найти указанный destination (пункт назначения) или action (действие) в текущем графе навигации. Чаще всего это происходит из-за того, что NavController, к которому вы обращаетесь, не «знает» о том графе, в котором определён этот destination.

В вашем случае проблема в том, что findNavController() может вернуть неправильный экземпляр NavController. Это типичная ловушка для новичков. Когда вы вызываете findNavController() из фрагмента, он ищет NavController, начиная с самого фрагмента, затем поднимается к его родительскому View, и так далее. Если фрагмент не является прямым потомком NavHostFragment, поиск может «перескочить» на другой NavController (например, на уровне Activity), который ничего не знает о вашем nav_graph.

Как это исправить

Самый надёжный способ — получить NavController через Navigation.findNavController(), передав ему конкретное View, которое гарантированно находится внутри NavHostFragment. Лучше всего использовать кнопку, по которой происходит нажатие:

binding.buttonGoToDetails.setOnClickListener { view ->
    Navigation.findNavController(view).navigate(R.id.action_home_to_details)
}

Или, альтернативно, используйте requireActivity().findNavController(R.id.nav_host_fragment), если у вас есть ID NavHostFragment:

binding.buttonGoToDetails.setOnClickListener {
    requireActivity().findNavController(R.id.nav_host_fragment).navigate(R.id.action_home_to_details)
}

Другие возможные причины и их решения

• Неправильный NavHostFragment в layout: Убедитесь, что в вашем XML-файле Activity (например, activity_main.xml) NavHostFragment имеет правильный атрибут app:navGraph:

  <androidx.fragment.app.FragmentContainerView
      android:id="@+id/nav_host_fragment"
      android:name="androidx.navigation.fragment.NavHostFragment"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      app:defaultNavHost="true"
      app:navGraph="@navigation/nav_graph" />

• Динамическая загрузка графа: Если вы программно устанавливаете navGraph через NavHostFragment.findNavController().setGraph(), убедитесь, что это делается до попытки навигации.
• Проблемы с многомодульностью: Если вы используете несколько модулей, проверьте, что ID ресурсов (R.id.action_...) не конфликтуют. Используйте полные пути или Safe Args.
• Safe Args: Рекомендуется использовать плагин Safe Args для генерации классов Directions. Тогда вы будете использовать HomeFragmentDirections.actionHomeToDetails() вместо сырых ID — это исключит ошибки с опечатками:

  val action = HomeFragmentDirections.actionHomeToDetails()
  findNavController().navigate(action)
  

Диагностика

Чтобы точно определить, какой NavController используется, добавьте логирование:

val navController = findNavController()
Log.d("NavDebug", "Current graph: ${navController.graph}, Current destination: ${navController.currentDestination}")

Если в логе вы видите другой граф (например, с ID nav_graph, но без вашего action), значит, вы обращаетесь не к тому контроллеру.

В 90% случаев проблема решается заменой findNavController() на Navigation.findNavController(view). Попробуйте этот способ в первую очередь.

class HomeFragment : Fragment() {
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        
        // 1. Явно получаем NavController через NavHostFragment
        val navHostFragment = requireActivity().supportFragmentManager
            .findFragmentById(R.id.nav_host_fragment) as NavHostFragment
        val navController = navHostFragment.navController
        
        // 2. Проверяем, что текущий destination — HomeFragment
        if (navController.currentDestination?.id == R.id.homeFragment) {
            // 3. Используем Safe Args (если подключили плагин)
            val action = HomeFragmentDirections.actionHomeToDetails()
            navController.navigate(action)
        } else {
            Log.e("Navigation", "Current destination is not HomeFragment")
        }
    }
}