Android软键盘弹出时WindowVisibleDisplayFrame短暂异常缩小的原因及优化方案问询

我之前也碰到过类似的问题，结合你的场景和日志来看，咱们先拆解这个异常的来龙去脉，再给你几个靠谱的替代方案。

一、为什么会出现两次回调，第一次高度异常？ #

这个问题本质是系统布局调度的时序差导致的：

• 软键盘弹出时，系统不是一步到位完成布局的，而是分阶段调整窗口尺寸。第一次onGlobalLayout回调触发时，键盘可能还在弹出动画过程中，或者系统还没完成最终的窗口布局计算，这时候getWindowVisibleDisplayFrame返回的可视区域是临时状态，直接计算就会得到翻倍的异常高度。
• 你用的PopupWindow设置了SOFT_INPUT_ADJUST_RESIZE，它的布局调整和Activity主窗口的布局调整存在微小的同步延迟，第一次回调时PopupWindow还没跟上系统的最终布局状态，所以拿到了错误的rect值。
• 另外，不同ROM和Android版本的窗口调度逻辑差异，以及输入法的弹出动画时长，都会放大这个时序问题，导致偶尔出现这种异常。

二、哪些因素会影响这个异常的触发？ #

• 系统与ROM差异：Android 10+的窗口机制有不少变化，部分厂商的定制ROM对窗口布局的优先级调度不同，更容易出现这类时序问题。
• 输入法动画：第三方输入法的弹出动画逻辑、系统键盘的动画时长，会直接影响onGlobalLayout的回调时机和次数。
• PopupWindow初始化时机：如果PopupWindow的显示时机和Activity的onResume没有完全同步，初始布局监听的状态就容易出问题。

三、替代postDelay的优化方案 #

方案1：过滤不稳定的回调，只处理稳定状态 #

核心思路是：等待布局状态稳定后再处理，避免响应中间的临时回调。我们可以记录上一次的键盘高度，只有当当前高度在短时间内（比如30ms）没有变化时，才执行后续逻辑。

修改你的onGlobalLayout逻辑：

private var lastKeyboardHeight = 0
private var heightCheckRunnable: Runnable? = null

override fun onGlobalLayout() {
    val rect = Rect()
    popupView.getWindowVisibleDisplayFrame(rect)
    val currentKeyboardHeight = if (getScreenOrientation() == Configuration.ORIENTATION_PORTRAIT) {
        if (rect.bottom > portraitHeightMax) {
            portraitHeightMax = rect.bottom
        }
        portraitHeightMax - rect.bottom
    } else {
        if (rect.bottom > landscapeHeightMax) {
            landscapeHeightMax = rect.bottom
        }
        landscapeHeightMax - rect.bottom
    }

    // 先移除之前的检查任务，避免重复执行
    heightCheckRunnable?.let { viewsForTranslation.removeCallbacks(it) }

    // 30ms后检查高度是否稳定，稳定再处理
    heightCheckRunnable = Runnable {
        if (currentKeyboardHeight == lastKeyboardHeight) {
            keyboardHeight = currentKeyboardHeight
            keyboardChangeHeightListener?.onKeyboardHeightChanged(keyboardHeight)
            viewsForTranslation.translationY = -keyboardHeight.toFloat()
        }
        lastKeyboardHeight = currentKeyboardHeight
    }
    viewsForTranslation.postDelayed(heightCheckRunnable!!, 30)
}

方案2：结合键盘可见性，过滤不合理的高度值 #

我们可以通过InputMethodManager判断键盘的可见状态，同时对计算出的高度做合理性校验（比如键盘高度不可能超过屏幕高度的2/3），避免处理异常值：

private fun isKeyboardVisible(): Boolean {
    val imm = parentActivity.getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
    return imm.isAcceptingText
}

override fun onGlobalLayout() {
    val rect = Rect()
    popupView.getWindowVisibleDisplayFrame(rect)
    val currentKeyboardHeight = // 保持你原来的计算逻辑不变

    val screenHeight = parentActivity.resources.displayMetrics.heightPixels
    val isVisible = isKeyboardVisible()
    
    if (isVisible) {
        // 键盘可见时，只处理合理范围内的高度值
        if (currentKeyboardHeight in 1..(screenHeight * 2 / 3)) {
            updateKeyboardState(currentKeyboardHeight)
        }
    } else {
        updateKeyboardState(0)
    }
}

private fun updateKeyboardState(height: Int) {
    if (keyboardHeight != height) {
        keyboardHeight = height
        keyboardChangeHeightListener?.onKeyboardHeightChanged(height)
        viewsForTranslation.translationY = -height.toFloat()
    }
}

方案3：换用OnPreDrawListener监听布局 #

OnPreDrawListener会在布局完成但还未开始绘制时触发，比OnGlobalLayoutListener的时机更晚，能拿到更稳定的布局结果：

// 替换原来的OnGlobalLayoutListener注册逻辑
fun onResume() {
    popupView.viewTreeObserver.addOnPreDrawListener(preDrawListener)
    if (!isShowing) {
        decorView.post {
            showAtLocation(decorView, Gravity.NO_GRAVITY, 0, 0)
        }
    }
}

private val preDrawListener = ViewTreeObserver.OnPreDrawListener {
    val rect = Rect()
    popupView.getWindowVisibleDisplayFrame(rect)
    // 这里执行你的键盘高度计算和回调逻辑
    return@OnPreDrawListener true // 返回true允许View继续绘制
}

fun onPause() {
    popupView.viewTreeObserver.removeOnPreDrawListener(preDrawListener)
    // 别忘了移除所有Runnable回调
    heightCheckRunnable?.let { viewsForTranslation.removeCallbacks(it) }
}

四、额外注意事项 #

• 一定要在onPause中移除所有的Runnable回调和监听，避免内存泄漏。
• 屏幕旋转时，记得重置portraitHeightMax和landscapeHeightMax，否则会导致旋转后的高度计算错误。
• 多在不同ROM和Android版本上测试，确保方案的兼容性。

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