Android多Activity/Fragment应用：无需自定义回调，让返回键退Fragment而非退Activity

我正在把一个复杂应用从重写onBackPressed()迁移到OnBackPressedDispatcher。之前我们在Activity层级重写返回键行为，现在希望只在需要特定返回键逻辑的Fragment中自定义，同时启用预测返回功能。但现在发现系统返回键会直接退出整个Activity，而不是弹出栈顶的Fragment。

我的需求是：不向onBackPressedDispatcher提供自定义回调的前提下，怎么设置让Android返回键默认弹出Fragment而不是退出Activity？

附上当前测试的代码片段：

private val onBackPressedCallback: OnBackPressedCallback = object : OnBackPressedCallback(true) {
    override fun handleOnBackPressed() {
        // 设置enabled为true时无法启用预测返回
        // 设置enabled为false时系统返回键无法弹出Fragment栈
    }
}

1. 彻底移除Activity中自定义的onBackPressed()实现 #

如果之前在Activity里重写了onBackPressed()方法，必须完全删除或注释掉。OnBackPressedDispatcher的默认逻辑是：优先检查Fragment回退栈，若栈不为空则弹出栈顶Fragment；若回退栈为空，才会触发退出Activity的操作。残留的Activity层级onBackPressed()代码会覆盖这个默认行为。

2. 仅在需要特殊逻辑的Fragment中注册回调 #

只有当某个Fragment需要自定义返回行为（比如弹出确认对话框、跳转至特定页面）时，才在该Fragment中注册OnBackPressedCallback。对于普通Fragment，无需添加任何回调，让OnBackPressedDispatcher自动处理回退栈即可。

3. 确保Fragment事务正确加入回退栈 #

检查添加Fragment的代码，必须在提交事务时调用addToBackStack()，否则Fragment不会被纳入回退栈管理。示例代码：

supportFragmentManager.beginTransaction()
    .replace(R.id.container, TargetFragment())
    .addToBackStack(null) // 此调用是Fragment进入回退栈的关键
    .commit()

4. 适配预测返回功能的注意点 #

预测返回要求应用适配Android 13（API 33）及以上版本，同时满足：

• 无全局拦截返回键的自定义逻辑
• 所有需要回退的Fragment事务都已加入回退栈
• 注册OnBackPressedCallback时，仅在需要拦截返回时设置enabled = true，不需要拦截时设为false，让系统能正常处理预测返回的动画与逻辑。

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