使用Hilt为Android Fragment注入NavController时崩溃问题排查

• 生产环境的崩溃核心原因是你在Activity级别提供的NavController实例，无法适配Fragment的生命周期时机：
  • 测试环境场景单一（比如冷启动后正常跳转），Fragment的初始化时机晚于Activity中NavHostView的加载完成，所以通过Activity查找NavController能成功；
  • 生产环境存在后台恢复、快速切换Fragment、多任务切换等复杂场景，Fragment可能在Activity的NavHostView还未完成初始化，或者Fragment尚未attach到Activity时，就被Hilt注入了NavController，此时调用Navigation.findNavController(activity, navHostId)会找不到对应ID的View，触发“ID does not reference a View inside this Activity”错误。
• 本质上是把生命周期更短的Fragment依赖，绑定到了Activity级别的实例上，忽略了Fragment和Activity的生命周期不同步问题。

不要在Activity模块中提供全局的NavController，改为基于Fragment生命周期的注入方案：

方案1：Fragment级别Module提供NavController #

创建一个绑定到FragmentComponent的Module，在Fragment范围内提供NavController，确保获取时机和Fragment生命周期同步：

@Module
@InstallIn(FragmentComponent::class)
object FragmentNavModule {
    @Provides
    @FragmentScoped
    fun provideNavController(fragment: Fragment): NavController {
        // 使用NavHostFragment的findNavController方法，无需依赖具体View ID，更安全
        return NavHostFragment.findNavController(fragment)
    }
}

之后在非MainFragment中直接通过@Inject声明NavController即可：

@AndroidEntryPoint
class OtherFragment : Fragment() {
    @Inject
    lateinit var navController: NavController

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        // 此时navController已完成注入，可直接使用
    }
}

方案2：结合AssistedInject适配注入时机 #

如果需要更精确控制注入时机（比如确保Fragment已创建View），可以用AssistedInject：

1. 定义一个辅助类持有NavController：

class NavControllerHolder @AssistedInject constructor(
    @Assisted val fragment: Fragment
) {
    val navController: NavController by lazy {
        NavHostFragment.findNavController(fragment)
    }
}

@AssistedFactory
interface NavControllerHolderFactory {
    fun create(fragment: Fragment): NavControllerHolder
}

2. 在Fragment中注入工厂，在合适的生命周期（比如onViewCreated）获取NavController：

@AndroidEntryPoint
class OtherFragment : Fragment() {
    @Inject
    lateinit var navControllerHolderFactory: NavControllerHolderFactory
    private lateinit var navController: NavController

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        navController = navControllerHolderFactory.create(this).navController
    }
}

关键注意事项 #

• 所有需要注入NavController的Fragment必须添加@AndroidEntryPoint注解，确保Hilt能正确处理Fragment的依赖注入。
• 避免直接在Activity中持有NavController实例提供给Fragment，Fragment的NavController应该从自身关联的NavHostFragment获取，而非Activity的全局实例。
• MainFragment直接使用Navigation.findNavController(requireView())的方式是安全的，因为它作为NavHostFragment的初始Fragment，在onViewCreated时View已经完全初始化，能正确找到NavController。

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