OnBackPressedDispatcher正确用法：替代废弃onBackPressed避免无限循环

核心逻辑 #

OnBackPressedDispatcher的分发规则是：按注册顺序（或优先级）遍历回调，只有当回调明确表示已处理事件时，才会终止后续流程；若回调未处理，事件会继续传递给下一个回调，直到触发系统默认的返回逻辑。

你之前出现无限循环，是因为在自定义回调里调用了onBackPressedDispatcher.onBackPressed()，这会重新触发整个分发流程，包括你自己的回调，从而陷入循环。

具体实现代码 #

1. Activity中的实现 #

在onCreate方法中注册回调，通过临时禁用回调的方式兼容低版本：

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        onBackPressedDispatcher.addCallback(this, object : OnBackPressedCallback(true) {
            override fun handleOnBackPressed() {
                // 自定义条件判断：是否需要自行处理返回键
                val needHandleSelf = checkIfNeedHandleBack()

                if (needHandleSelf) {
                    // 执行自定义逻辑，比如关闭弹窗、回退自定义页面栈
                    handleCustomBackLogic()
                } else {
                    // 临时禁用当前回调，让系统处理默认逻辑
                    isEnabled = false
                    onBackPressedDispatcher.onBackPressed()
                    // 恢复回调启用状态，避免后续返回键失效
                    isEnabled = true
                }
            }
        })
    }

    // 示例：判断是否有弹窗显示
    private fun checkIfNeedHandleBack(): Boolean {
        return supportFragmentManager.findFragmentByTag("custom_dialog") != null
    }

    // 示例：关闭弹窗
    private fun handleCustomBackLogic() {
        supportFragmentManager.findFragmentByTag("custom_dialog")?.let {
            (it as DialogFragment).dismiss()
        }
    }
}

2. Fragment中的实现 #

Fragment需绑定viewLifecycleOwner，确保回调随View生命周期自动销毁：

class MyFragment : Fragment() {
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)

        requireActivity().onBackPressedDispatcher.addCallback(viewLifecycleOwner, object : OnBackPressedCallback(true) {
            override fun handleOnBackPressed() {
                val needHandleSelf = checkIfNeedHandleBack()
                if (needHandleSelf) {
                    // 执行Fragment内的自定义返回逻辑
                    navigateToPreviousCustomState()
                } else {
                    isEnabled = false
                    requireActivity().onBackPressedDispatcher.onBackPressed()
                    isEnabled = true
                }
            }
        })
    }

    // 示例：判断是否处于自定义页面状态
    private fun checkIfNeedHandleBack(): Boolean {
        return viewModel.currentPage.value == PageState.EDIT_MODE
    }

    // 示例：回退到上一个状态
    private fun navigateToPreviousCustomState() {
        viewModel.restorePreviousPage()
    }
}

3. API 33+ 简洁写法 #

Android 13及以上版本，OnBackPressedCallback的handleOnBackPressed()支持返回值，直接返回false即可让事件继续分发：

onBackPressedDispatcher.addCallback(this, object : OnBackPressedCallback(true) {
    override fun handleOnBackPressed(): Boolean {
        if (checkIfNeedHandleBack()) {
            handleCustomBackLogic()
            return true // 表示已处理，终止分发
        }
        return false // 未处理，交给系统默认逻辑
    }
})

关键注意事项 #

• 禁止在handleOnBackPressed()中直接调用onBackPressedDispatcher.onBackPressed()，否则会触发重复分发导致循环。
• 低版本兼容时，临时禁用回调后必须恢复启用状态，避免后续返回键失效。
• Fragment务必使用viewLifecycleOwner作为回调的生命周期所有者，防止内存泄漏。

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