DialogFragment调用onBackPressed意外结束Activity问题如何解决？

问题根因 #

系统返回键的事件分发遵循Window优先级规则：Dialog所属Window的优先级高于Activity所属Window，因此返回键事件会先被DialogFragment内部的Dialog拦截，Dialog默认会消费返回键事件，调用dismiss()关闭自身，不会将事件传递给Activity的onBackPressed()方法。
你直接调用requireActivity().onBackPressed()的逻辑绕开了Dialog的事件拦截流程，直接触发了Activity的返回逻辑，因此会直接关闭Activity，不会先关闭弹窗。

解决方案 #

方案1：兼容双模式的快速修复 #

在关闭按钮点击逻辑中先判断当前是否为弹窗展示模式，分别处理：

viewBinding.closeBtn.setOnClickListener {
    // 判断当前是否以Dialog形式展示
    if (dialog?.isShowing == true) {
        // 弹窗模式下先关闭弹窗，若需要Activity处理业务逻辑可在dismiss后补充调用
        dismiss()
        // 如有需要可在此处加业务逻辑，比如通知Activity做后续处理
    } else {
        // 普通Fragment模式下走Activity返回逻辑
        requireActivity().onBackPressed()
    }
}

方案2：接口回调解耦（更符合业务扩展性要求） #

如果你的场景需要不同宿主Activity自定义关闭逻辑（比如二次确认），更推荐用接口回调的方式解耦，避免直接耦合Activity的onBackPressed方法：

1. 定义关闭回调接口

interface ShareDialogCloseListener {
    fun onCloseRequest()
}

2. 在Fragment中绑定回调

class SharePatientDialogFragment : DialogFragment() {
    private var closeListener: ShareDialogCloseListener? = null

    override fun onAttach(context: Context) {
        super.onAttach(context)
        closeListener = context as? ShareDialogCloseListener
            ?: throw IllegalArgumentException("宿主Activity必须实现ShareDialogCloseListener接口")
    }

    // 点击事件中调用回调
    fun initView() {
        viewBinding.closeBtn.setOnClickListener {
            closeListener?.onCloseRequest()
        }
    }
}

3. 不同宿主Activity分别实现回调逻辑

• 作为普通Fragment使用的Activity：

class NormalActivity : AppCompatActivity(), ShareDialogCloseListener {
    override fun onCloseRequest() {
        // 按你的原有业务逻辑走返回处理
        onBackPressed()
    }
}

• 作为DialogFragment使用的Activity：

class DialogHostActivity : AppCompatActivity(), ShareDialogCloseListener {
    override fun onCloseRequest() {
        val dialog = supportFragmentManager.findFragmentByTag("share") as? SharePatientDialogFragment
        // 可根据业务需要插入二次确认逻辑
        dialog?.dismiss()
    }
}

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