Android Dialog设置不可取消后出现背景点击穿透如何解决

当给Dialog做如下配置，实现点击外部、按返回键不关闭弹窗的效果时：

setCanceledOnTouchOutside(false);
setCancelable(false);

很容易遇到点击弹窗外部蒙层时，触摸事件穿透到下方页面，误触发按钮、复选框等控件的问题，以下是生产环境验证过的可靠解决方案：

方案1：给Dialog Window添加外部触摸事件拦截（优先推荐，兼容性最好） #

在Dialog调用show()方法之后，给Window的顶层视图添加触摸监听，直接消费所有落在Dialog边界外的事件，不让事件向下传递：

// Kotlin写法，Java可直接参照调整语法
window?.decorView?.setOnTouchListener { _, event ->
    if (event.action == MotionEvent.ACTION_OUTSIDE) {
        // 返回true代表消费事件，终止事件传递
        true
    } else {
        // Dialog内部的事件正常放行
        false
    }
}

这个方案适配Android 5.0到Android 14的所有官方版本和绝大多数定制ROM，不需要修改业务页面代码，耦合度极低。

方案2：重写Dialog的onTouchEvent做兜底拦截 #

如果是自定义Dialog，可以直接重写Dialog的触摸事件方法，全局拦截外部事件：

@Override
public boolean onTouchEvent(MotionEvent event) {
    // 识别到是弹窗边界外的触摸事件直接消费
    if (MotionEvent.ACTION_OUTSIDE == event.getAction()) {
        return true;
    }
    return super.onTouchEvent(event);
}

注意：这个方法必须配合setCanceledOnTouchOutside(false)使用，单独使用不会生效

避坑提醒 #

• 不要给Dialog的内容布局设置点击/触摸监听尝试拦截，外部点击事件不会传递到内容布局层，这种写法完全无效
• 不要用「弹出Dialog时给底层页面根布局设置可点击拦截、关闭Dialog时再恢复」的临时方案，耦合度极高，多弹窗场景下很容易出现状态错乱
• 遇到深度定制的国产ROM如果单种方案失效，可以把上述两个方案叠加使用，不会产生冲突

问题根因：Dialog设置不可取消属性后，系统默认不会消费Dialog边界外的触摸事件，事件会直接派发给底层Activity的Window，最终触发底层控件的点击响应，只要在Dialog对应的Window层把这部分事件消费掉，就能从根源解决穿透问题。

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