Jetpack Compose+Hilt导航报错：_navController未初始化及方案咨询

一、错误原因及修复方案 #

错误原因 #

你遇到的kotlin.UninitializedPropertyAccessException是因为调用navigator.navigate()时，Navigator类中的_navController还未被初始化。常见触发场景包括：

• 屏幕旋转等配置变化后，保留的ViewModel在新的NavigationGraph完成setController调用前，触发了导航操作；
• Composable重组过程中，导航逻辑先于setController执行；
• lateinit变量未做初始化检查，直接调用导致异常。

修复方案 #

方案1：替换lateinit为可空类型并添加初始化检查

修改Navigator类，避免使用lateinit，改用可空变量并在导航前做校验：

@ActivityRetainedScoped
class Navigator {
    private var _navController: NavHostController? = null

    fun navigate(destination: NavigationDestination) {
        _navController?.let { navController ->
            navController.navigate(destination.route)
        } ?: run {
            throw IllegalStateException("NavController尚未初始化，请先调用setController")
        }
    }

    fun setController(controller: NavHostController) {
        _navController = controller
    }
}

方案2：确保setController仅在NavController初始化时执行

在NavigationGraph中使用LaunchedEffect，保证setController只在NavController创建或变化时执行，避免重组带来的重复调用：

@Composable
fun NavigationGraph(
    navigator: Navigator
) {
    val navController = rememberNavController()
    // 仅在navController初始化时执行一次setController
    LaunchedEffect(navController) {
        navigator.setController(navController)
    }
    NavHost(navController = navController, startDestination = Routes.CLIENTS_ROUTE ) {
        composable(Routes.CLIENTS_ROUTE) {
            val viewModel = hiltViewModel<ClientViewModel>()
            ClientScreen(viewModel = viewModel)
        }
        composable(Routes.ASSESSMENT_OPTIONS_ROUTE, arguments = listOf(navArgument(RouteArgs.CLIENT_ID) {type = NavType.StringType})) { backStackEntry ->
            val viewModel = hiltViewModel<ClientViewModel>()
            ClientAssessmentOptionScreen(viewModel = viewModel)
        }
    }
}

方案3：调整Navigator的作用域

如果不需要在配置变化时保留Navigator实例，可将其作用域改为@ActivityScoped，确保每次Activity重建时都创建新的Navigator并重新绑定NavController：

@Module
@InstallIn(ActivityComponent::class)
class AppModule {
    @Provides
    fun providesNavigation() = Navigator()
}

@ActivityScoped
class Navigator {
    private lateinit var _navController: NavHostController

    fun navigate(destination: NavigationDestination) {
        if (::_navController.isInitialized) {
            _navController.navigate(destination.route)
        } else {
            throw IllegalStateException("NavController尚未初始化")
        }
    }

    fun setController(controller: NavHostController) {
        _navController = controller
    }
}

二、ViewModel负责导航的方案是否合理？ #

ViewModel负责导航的方案存在争议，需根据项目需求权衡：

不推荐的原因 #

• 职责边界模糊：导航属于UI层职责，ViewModel核心应聚焦业务逻辑与状态维护，依赖导航组件会打破关注点分离原则；
• 可测试性降低：ViewModel依赖Navigator或NavController后，单元测试需要模拟这些UI层组件，增加测试复杂度；
• 生命周期风险：如你遇到的问题，导航组件与ViewModel生命周期不一致时，易出现未初始化或无效引用的异常。

更优替代方案：ViewModel发出导航事件，UI层执行导航 #

推荐采用"事件驱动"模式，ViewModel仅负责发出导航意图，由UI层（Composable）监听并执行导航，既保留ViewModel的业务独立性，又实现导航需求：

1. ViewModel中定义导航事件流：

@HiltViewModel
class ClientViewModel @Inject constructor(
    private val repository: IClientRepository,
    private val savedStateHandle: SavedStateHandle,
) : ViewModel() {
    // 定义导航事件的Flow
    private val _navigationEvents = MutableSharedFlow<NavigationDestination>()
    val navigationEvents = _navigationEvents.asSharedFlow()

    fun onEvent(event: ClientEvent) {
        viewModelScope.launch {
            when(event) {
                is ClientEvent.OnClientClicked ->
                    event.client.clientName?.let {
                        _navigationEvents.emit(
                            NavigationDestination(Routes.generateAssessmentOptionsRoute(clientId = it))
                        )
                    }
            }
        }
    }
}

2. UI层监听事件并执行导航：

@Composable
fun ClientScreen(viewModel: ClientViewModel) {
    val navController = rememberNavController()
    
    // 监听导航事件，执行导航
    LaunchedEffect(Unit) {
        viewModel.navigationEvents.collect { destination ->
            navController.navigate(destination.route)
        }
    }

    // 剩余UI代码...
}

这种模式下，ViewModel不依赖任何UI层组件，测试时只需验证导航事件是否正确发出即可，同时UI层专注于执行导航操作，职责清晰。

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