Navigation Compose+ViewModel+Hilt导航失效问题求助

我参照Android官方文档实现基于Navigation Compose、ViewModel与Hilt的导航功能，但点击设置按钮后无法跳转到Settings页面。程序无报错，ViewModel发送导航事件时，NavigationScreen中的LaunchedEffect完全没触发。我期望点击设置按钮后，通过navController.navigate将Settings Composable推入栈顶，但功能未生效。

Composables代码 #

@HiltAndroidApp
class MyApplication : Application() {}

@Serializable
object NavScreen

@AndroidEntryPoint
class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()
        setContent {
            val navController = rememberNavController()

            PhotosSyncTheme {
                NavHost(
                    navController = navController,
                    startDestination = NavScreen
                ) {
                    composable<NavScreen> { NavigationScreen(navController) }
                    composable<NavigationEvent.NavigateToHome> { HomeScreen() }
                    composable<NavigationEvent.NavigateToSettings> { Settings() }
                }
            }
        }
    }
}

@Composable
fun NavigationScreen(navController: NavController) {
    val navViewModel = hiltViewModel<NavigationViewModel>()

    val navigationEvent by navViewModel.navigationEvents.collectAsState(initial = NavigationEvent.NavigateToHome)

    LaunchedEffect(navigationEvent) {
        Log.d("Navigation Screen", navigationEvent.toString())
        navigationEvent.let { event ->
            Log.d("Navigation Screen", event.toString())
            when (event) {
                is NavigationEvent.NavigateBack -> navController.popBackStack()
                NavigationEvent.NavigateToHome -> navController.navigate(NavigationEvent.NavigateToHome)
                NavigationEvent.NavigateToSettings -> navController.navigate(NavigationEvent.NavigateToSettings)
            }
        }
    }
}

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun HomeScreen() {
    val navViewModel = hiltViewModel<NavigationViewModel>()
    var selectedItem by remember { mutableIntStateOf(0) }

    Scaffold(
        modifier = Modifier.fillMaxSize(),
        topBar = {
            TopAppBar(title = { Text("Photos Sync") }, actions = {
                IconButton(onClick = {
                    navViewModel.navigateToSettings()
                }) {
                    Icon(
                        imageVector = Icons.Filled.Settings,
                        contentDescription = "Settings icon"
                    )
                }
            })
        }
    )
    { }
}

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun Settings() {
    val viewModel = hiltViewModel<NavigationViewModel>()

    Scaffold(
        modifier = Modifier.fillMaxSize(),
        topBar = {
            TopAppBarWithBack(title = "Definições")
        }
    )
    { }
}

ViewModel代码 #

@HiltViewModel
class NavigationViewModel @Inject constructor() : ViewModel() {
    private val _navigationEvents = MutableSharedFlow<NavigationEvent>()
    val navigationEvents: SharedFlow<NavigationEvent> = _navigationEvents.asSharedFlow()

    fun navigateBack() {
        viewModelScope.launch { _navigationEvents.emit(NavigationEvent.NavigateBack) }
    }

    fun navigateToHome() {
        viewModelScope.launch { _navigationEvents.emit(NavigationEvent.NavigateToHome) }
    }

    fun navigateToSettings() {
        viewModelScope.launch {
            Log.d("Navigation ViewModel", "Emit Navigate To Settings")
            try {
                _navigationEvents.emit(NavigationEvent.NavigateToSettings)

            } catch (e: Exception) {
                Log.e("Navigation ViewModel", "Error emitting navigation event")
            } finally {
                Log.d("Navigation ViewModel", "done Emit Navigate To Settings")
            }
        }
    }

    fun navigateTo(event: NavigationEvent) {
        viewModelScope.launch { _navigationEvents.emit(event) }
    }

    sealed class NavigationEvent {
        @Serializable
        object NavigateBack : NavigationEvent()

        @Serializable
        object NavigateToHome : NavigationEvent()

        @Serializable
        object NavigateToSettings : NavigationEvent()
    }
}

核心问题1：NavigationScreen不在栈中，无法接收事件 #

从NavigationScreen导航到HomeScreen后，NavigationScreen会被弹出栈，对应的Composable被销毁，它的LaunchedEffect自然不会再执行。你的导航逻辑完全依赖这个已经销毁的Composable，事件根本无法被处理。

核心问题2：SharedFlow默认不重播事件 #

MutableSharedFlow是冷流，没有重播特性。当HomeScreen发送事件时，NavigationScreen已经不在栈中，没有订阅者，事件会直接丢失。

修复步骤： #

方案1：简化导航结构（推荐）

直接移除中间的NavigationScreen，将HomeScreen设为启动目标，在按钮点击时直接调用navController.navigate：

@AndroidEntryPoint
class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()
        setContent {
            val navController = rememberNavController()

            PhotosSyncTheme {
                NavHost(
                    navController = navController,
                    startDestination = NavigationEvent.NavigateToHome
                ) {
                    composable<NavigationEvent.NavigateToHome> { HomeScreen(navController) }
                    composable<NavigationEvent.NavigateToSettings> { Settings(navController) }
                }
            }
        }
    }
}

// 修改HomeScreen，直接传入navController处理导航
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun HomeScreen(navController: NavController) {
    var selectedItem by remember { mutableIntStateOf(0) }

    Scaffold(
        modifier = Modifier.fillMaxSize(),
        topBar = {
            TopAppBar(title = { Text("Photos Sync") }, actions = {
                IconButton(onClick = {
                    navController.navigate(NavigationEvent.NavigateToSettings)
                }) {
                    Icon(
                        imageVector = Icons.Filled.Settings,
                        contentDescription = "Settings icon"
                    )
                }
            })
        }
    )
    { }
}

方案2：用StateFlow重构ViewModel事件管理

如果需要统一管理导航事件，将SharedFlow改为StateFlow（支持重播最新值），并在当前栈中的Composable里订阅事件：

// 修改ViewModel
@HiltViewModel
class NavigationViewModel @Inject constructor() : ViewModel() {
    private val _navigationEvents = MutableStateFlow<NavigationEvent?>(null)
    val navigationEvents: StateFlow<NavigationEvent?> = _navigationEvents.asStateFlow()

    fun navigateToSettings() {
        Log.d("Navigation ViewModel", "Emit Navigate To Settings")
        _navigationEvents.value = NavigationEvent.NavigateToSettings
    }

    // 处理完事件后重置，避免重复触发
    fun consumeEvent() {
        _navigationEvents.value = null
    }

    sealed class NavigationEvent {
        @Serializable
        object NavigateBack : NavigationEvent()
        @Serializable
        object NavigateToHome : NavigationEvent()
        @Serializable
        object NavigateToSettings : NavigationEvent()
    }
}

// 在HomeScreen中订阅事件
@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun HomeScreen(navController: NavController) {
    val navViewModel = hiltViewModel<NavigationViewModel>()
    val navigationEvent by navViewModel.navigationEvents.collectAsState()

    LaunchedEffect(navigationEvent) {
        navigationEvent?.let { event ->
            when (event) {
                NavigationViewModel.NavigationEvent.NavigateToSettings -> 
                    navController.navigate(NavigationViewModel.NavigationEvent.NavigateToSettings)
                else -> {}
            }
            navViewModel.consumeEvent()
        }
    }

    // 其余代码不变
}

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