Android Navigation：如何修复Jetpack Compose NavHost中的返回按钮行为？

使用androidx.navigation:navigation-compose:2.5.3的NavHost组件时，通过Deep Link打开应用进入详情页后，点击返回按钮会先回到列表页再退出应用，不符合预期的直接退出行为：

• 预期：点击返回按钮直接退出应用
• 实际：遍历模拟的返回栈（先回到列表页，再退出）

复现代码 #

AndroidManifest.xml #

<application>
    ...
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <!-- Accepts URIs that begin with "http://www.example.com/gizmos” -->
        <data android:scheme="http"
            android:host="www.example.com"
            android:pathPrefix="/gizmos" />
        <!-- note that the leading "/" is required for pathPrefix-->
    </intent-filter>
</application>

MainActivity.kt #

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            MyApplicationTheme {
                Surface(
                    modifier = Modifier.fillMaxSize(),
                    color = MaterialTheme.colorScheme.background
                ) {
                    MainNavigation()
                }
            }
        }
    }
}

@Composable
fun MainNavigation() {
    val navController = rememberNavController()

    NavHost(navController = navController, startDestination = "start") {
        navigation(
            startDestination = "list",
            route = "start",
        ) {
            composable("list") { ListScreen(navigateToDetail = {
                navController.navigate(route = "detail/$it")
            }) }
            composable(
                route = "detail/{id}",
                arguments = listOf(
                    navArgument(name = "id") { type = NavType.LongType }
                ),
                deepLinks = listOf(
                    navDeepLink {
                        uriPattern = "http://www.example.com/gizmos/{id}"
                    }
                )
            ) { backStackEntry ->
                val id = backStackEntry.arguments?.getLong("id")

                DetailScreen(id)
            }
        }
        // TODO: Add more destinations
    }
}

@Composable
fun ListScreen(
    navigateToDetail : (Long) -> Unit,
) {
    Text("List")
    Button(onClick = {
        navigateToDetail(42)
    }) {
        Text("Navigate to 42")
    }
}

@Composable
fun DetailScreen(
    id : Long?,
) {
    Text("Detail: $id")
}

解决方案 #

这个问题是因为Navigation组件默认会为Deep Link构建模拟返回栈（包含导航图的startDestination），可以通过以下两种方式修正：

方法一：配置Deep Link的导航行为 #

在navDeepLink中设置appLinkingBehavior为APP_LINKING_BEHAVIOR_REPLACE_EXISTING，通过Deep Link进入时会替换整个返回栈，只保留当前详情页：

composable(
    route = "detail/{id}",
    arguments = listOf(
        navArgument(name = "id") { type = NavType.LongType }
    ),
    deepLinks = listOf(
        navDeepLink {
            uriPattern = "http://www.example.com/gizmos/{id}"
            // 设置替换现有栈的行为
            appLinkingBehavior = AppLinkingBehavior.APP_LINKING_BEHAVIOR_REPLACE_EXISTING
        }
    )
) { backStackEntry ->
    val id = backStackEntry.arguments?.getLong("id")
    DetailScreen(id)
}

方法二：手动处理Deep Link导航，清空返回栈 #

在MainNavigation中检查启动Intent是否包含Deep Link，手动导航并清空之前的返回栈：

@Composable
fun MainNavigation(context: Context = LocalContext.current) {
    val navController = rememberNavController()
    val intent = (context as Activity).intent

    LaunchedEffect(intent) {
        val deepLink = intent.data
        if (deepLink != null) {
            // 导航到Deep Link目标，同时清空整个返回栈
            navController.navigate(deepLink) {
                popUpTo(navController.graph.startDestinationId) {
                    inclusive = true
                }
            }
        }
    }

    NavHost(navController = navController, startDestination = "start") {
        // 原导航图内容保持不变
        navigation(
            startDestination = "list",
            route = "start",
        ) {
            composable("list") { ListScreen(navigateToDetail = {
                navController.navigate(route = "detail/$it")
            }) }
            composable(
                route = "detail/{id}",
                arguments = listOf(
                    navArgument(name = "id") { type = NavType.LongType }
                ),
                deepLinks = listOf(
                    navDeepLink {
                        uriPattern = "http://www.example.com/gizmos/{id}"
                    }
                )
            ) { backStackEntry ->
                val id = backStackEntry.arguments?.getLong("id")
                DetailScreen(id)
            }
        }
    }
}

说明 #

• 方法一简洁直接，通过配置修改Deep Link默认行为；
• 方法二更灵活，适合需要自定义导航逻辑的场景；
• 两种方式都能实现“点击返回直接退出应用”的预期效果。

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