Fragment中Composable调用findNavController.navigate触发异常排查

原本基于View与ViewBinding的LoginFragment子类，正逐步迁移至Jetpack Compose。移除视图相关代码后，在onCreateView中返回ComposeView加载Composable内容。点击注册按钮时，通过ViewModel发送导航事件，调用findNavController().navigate(LoginFragmentDirections.actionLoginFragmentToRegisterFragment())时应用崩溃，抛出异常：

java.lang.IllegalArgumentException: Navigation action/destination package:id/action_loginFragment_to_registerFragment cannot be found from the current destination Destination(package:id/registerFragment) label=RegisterFragment class=package.RegisterFragment

已知nav.xml已正确定义所有目的地，RegisterFragment是未使用Compose的BaseFragment子类，求排查问题原因。

排查方向 #

• 导航事件重复触发：检查ViewModel的导航事件是否存在重复发送的情况。比如Composable重组时多次收集事件，导致第一次导航到RegisterFragment后，第二次事件仍在触发，此时当前目的地已经是RegisterFragment，自然找不到从LoginFragment出发的导航动作。可以给导航事件用Event类包装（只消费一次），或者在收集时用launchWhenStarted配合distinctUntilChanged避免重复处理。
• NavController获取时机错误：确认在LoginFragment中调用findNavController()的时机是否正确。如果是在Composable中直接获取，或者ViewModel中错误持有了旧的NavController实例，可能导致导航时使用的不是当前LoginFragment的NavController。建议在LoginFragment的onViewCreated中获取NavController并传递给ViewModel，或者在Composable中通过LocalNavController.current获取正确实例。
• ComposeView的导航宿主绑定问题：检查LoginFragment返回ComposeView时，是否正确关联了导航宿主。比如是否在ComposeView的内容中使用NavHost？如果LoginFragment是导航图中的一个目的地，不需要在内部再嵌套NavHost，否则会导致NavController层级混乱，当前目的地识别错误。确保LoginFragment的Compose内容只是普通UI，导航逻辑依赖宿主的NavController。
• 导航动作的触发条件未正确判断：检查触发导航的逻辑是否在错误的时机执行。比如Composable初始化时就触发了导航，或者按钮点击的回调被意外多次绑定，导致在页面还未完全加载时就发送了导航事件，甚至在已经跳转到RegisterFragment后仍在执行。

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