Android Fragment使用Navigation跳转时PopupWindow调用dismiss()无法关闭问题

问题原因 #

• 核心诱因是初始化时调用了setBackgroundDrawable(null)：PopupWindow的内部状态更新逻辑、动画时序、窗口附着校验都强依赖背景Drawable的存在，传入null会导致isShowing()状态和实际窗口附着状态不同步：当弹窗的消失动画刚触发时，内部就会提前把isShowing标记为false，但WindowManager还未完成视图移除，此时调用dismiss()会因为isShowing() == false直接跳过后续的窗口移除逻辑，导致弹窗残留可见。
• 缺少isFocusable配置：默认isFocusable = false的情况下，PopupWindow的状态更新优先级低于宿主Fragment的生命周期调度，Navigation跳转触发的Fragment生命周期切换会抢占弹窗的消失调度，导致弹窗移除逻辑被打断。
• 未绑定生命周期：跳转前没有主动关闭弹窗的逻辑，弹窗的显示/消失时序和Fragment跳转时序冲突时，就会出现状态和视图不一致的问题。

解决方案 #

1. 修正初始化配置 #

不要传入null作为背景，至少设置透明Drawable，补全必要配置保证状态同步：

override fun createPopupMenu(popupView: View?) {
    if (popupView == null)
        return
    menuPopup = PopupWindow(context).apply {
        elevation = requireContext().convertDpToPixel(10f).toFloat()
        // 替换null为透明背景，修复内部状态异常
        setBackgroundDrawable(ColorDrawable(Color.TRANSPARENT))
        height = ViewGroup.LayoutParams.WRAP_CONTENT
        width = ViewGroup.LayoutParams.WRAP_CONTENT
        contentView = popupView
        isOutsideTouchable = true
        // 补充focusable配置，保证状态更新优先级
        isFocusable = true
    }
}

2. 封装安全dismiss方法兜底 #

针对已经出现状态不同步的场景，增加兜底逻辑强制移除残留视图：

private fun safeDismissMenuPopup() {
    if (!::menuPopup.isInitialized) return
    // 先执行原生dismiss逻辑
    menuPopup.dismiss()
    // 兜底校验：如果contentView还附着在窗口上，直接强制移除
    val popupContentView = menuPopup.contentView
    if (popupContentView.isAttachedToWindow) {
        val windowManager = requireContext().getSystemService(WindowManager::class.java)
        windowManager.removeViewImmediate(popupContentView)
    }
}

3. 绑定生命周期&跳转前主动调用 #

在Fragment生命周期销毁前、Navigation跳转前主动调用安全关闭方法，避免时序冲突：

// Fragment生命周期触发时自动关闭
override fun onPause() {
    super.onPause()
    safeDismissMenuPopup()
}

// 跳转前主动关闭
fun navigateToOtherPage() {
    safeDismissMenuPopup()
    findNavController().navigate(/* 你的导航目标 */)
}

内容的提问来源于stack exchange，提问作者Anton A.