Jetpack Compose中VerificationScreen导航目标被调用4次的原因排查

核心原因 #

你直接通过VerificationScreenViewModel(...)手动实例化ViewModel，而Compose的composable块会随着UI重组多次执行，每次重组都会调用这个构造函数创建新实例。哪怕导航只触发一次，后续的UI重组（比如父组件状态变化、系统事件触发重组）都会导致ViewModel被重复创建。

另外，你没有使用Jetpack Compose提供的ViewModel生命周期管理机制，ViewModel无法和导航目标的BackStackEntry绑定，也就无法保持实例的唯一性。

修复步骤 #

1. 改用Compose的ViewModel获取方法：使用viewModel()或者hiltViewModel()（如果用Hilt）来获取ViewModel，这样ViewModel会和当前导航目标的BackStackEntry生命周期绑定，确保同一个导航目标下只有一个实例。
2. 正确传递参数到ViewModel：通过SavedStateHandle获取导航参数，避免手动传递导致的实例化问题。

无Hilt场景示例代码 #

先修改ViewModel，用SavedStateHandle接收参数：

class VerificationScreenViewModel(savedStateHandle: SavedStateHandle) : ViewModel() {
    val verificationId: String? = savedStateHandle["verificationId"]
}

然后在NavGraph中通过工厂创建ViewModel：

composable("VerificationScreen/{verificationId}") { backStackEntry ->
    BackHandler(true) {
        // 补充返回逻辑
    }
    val viewModel: VerificationScreenViewModel = viewModel(
        factory = object : ViewModelProvider.Factory {
            override fun <T : ViewModel> create(modelClass: Class<T>): T {
                return VerificationScreenViewModel(backStackEntry.savedStateHandle) as T
            }
        }
    )

    VerificationScreen(viewModel)
}

Hilt场景示例代码 #

给ViewModel添加Hilt注解：

@HiltViewModel
class VerificationScreenViewModel @Inject constructor(
    private val savedStateHandle: SavedStateHandle
) : ViewModel() {
    val verificationId: String? = savedStateHandle["verificationId"]
}

NavGraph中直接用hiltViewModel()获取：

composable("VerificationScreen/{verificationId}") {
    BackHandler(true) {
        // 补充返回逻辑
    }
    val viewModel: VerificationScreenViewModel = hiltViewModel()
    VerificationScreen(viewModel)
}

额外注意点 #

• 绝对不要在Composable函数中手动实例化ViewModel，必须依赖框架提供的生命周期管理方法，否则会导致实例无法复用、生命周期混乱。
• 若后续仍有频繁重组，可检查父Composable的状态变化逻辑，但当前问题的核心是ViewModel实例化方式错误。

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