Android Compose结合Voyager导航拦截返回键异常问题求助

问题场景 #

我用Voyager导航库开发了一个包含两个Compose页面的Android应用，在第二个页面捕获系统返回键时，虽然能触发navigator.pop()回到第一个页面，但返回键事件会继续传播，直接导致第一个页面也退出应用。我原本使用的返回键检测代码如下：

val requester = remember { FocusRequester() }
val navigator = LocalNavigator.currentOrThrow

LaunchedEffect(Unit) {
    requester.requestFocus()
}

AndroidView(
    modifier = Modifier
        .focusRequester(requester)
        .focusable()
        .fillMaxSize()
        .onKeyEvent { keyEvent ->
            if (keyEvent.nativeKeyEvent.keyCode == KeyEvent.KEYCODE_BACK) {
                if (keyEvent.nativeKeyEvent.action == KeyEvent.ACTION_DOWN) navigator.pop()
                true
            } else true
        },
    onRelease = {
        // 原代码省略部分
    }
)

我以为返回true就能消费事件阻止传播，但问题依旧，尝试BackHandler也无效，请问如何正确消费返回键，实现从第二个页面正常返回第一个页面？

核心问题分析 #

当前实现存在两个关键问题：

• onKeyEvent中对非返回键事件也返回true，错误消费了所有其他按键事件，同时返回键事件的处理逻辑未正确区分事件阶段，导致事件未被有效拦截。
• 使用AndroidView捕获焦点和按键事件的方式过于复杂，易与Voyager的导航生命周期冲突，这也是BackHandler无效的主要原因。

正确解决方案 #

方案一：使用Compose官方BackHandler（推荐） #

Voyager会自动管理导航栈，只需在第二个页面的Composable中添加BackHandler，并判断当前页面是否处于栈顶，确保只在当前页面生效：

@Composable
fun SecondScreen() {
    val navigator = LocalNavigator.currentOrThrow
    // 仅当前页面在栈顶时处理返回键
    BackHandler(enabled = navigator.lastItem is SecondScreen) {
        navigator.pop()
    }

    // 页面内容
    Column(modifier = Modifier.fillMaxSize()) {
        Text(text = "第二个页面")
        Button(onClick = { navigator.pop() }) {
            Text("手动返回")
        }
    }
}

方案二：修正onKeyEvent逻辑 #

若坚持使用onKeyEvent，需修正返回值逻辑，仅处理返回键时返回true，其他事件返回false，同时正确处理事件动作：

@Composable
fun SecondScreen() {
    val navigator = LocalNavigator.currentOrThrow

    Box(
        modifier = Modifier
            .fillMaxSize()
            .focusable()
            .onKeyEvent { keyEvent ->
                if (keyEvent.type == KeyEventType.KeyDown && keyEvent.key == Key.Back) {
                    navigator.pop()
                    true // 消费返回键事件
                } else {
                    false // 不消费其他事件
                }
            }
    ) {
        // 页面内容
        Text(text = "第二个页面")
    }
}

关键注意事项 #

• 避免用AndroidView捕获全局按键事件，Compose的Modifier.onKeyEvent或BackHandler已足够，且能更好地适配Compose生命周期与Voyager导航栈。
• 使用BackHandler时，必须通过navigator.lastItem判断当前页面是否在栈顶，防止其他页面的BackHandler被误触发。
• 确保使用最新版本的Voyager库，旧版本可能存在导航栈与返回键处理的兼容性问题。

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