Android TV返回页面时焦点无法稳定定位至原按钮问题排查

问题核心 #

日志显示焦点请求requestFocus()调用成功，但返回第一屏时仅30%场景能正确聚焦到原按钮，说明你的焦点请求被系统逻辑拦截、覆盖，或者视图状态不满足聚焦条件。以下是具体排查方向和解决方案：

1. 视图初始化时序不匹配 #

返回第一屏时，目标按钮可能还未完成布局绘制或挂载到视图树，此时调用requestFocus()会因为视图不可用而失效。

• 排查：在请求焦点前打印button.isAttachedToWindow()、button.isFocusable()的返回值，确认状态是否为true。
• 解决：延迟执行焦点请求，确保视图就绪：

  lastFocusedButton?.post {
      if (it.isAttachedToWindow && it.isFocusable) {
          it.requestFocus()
      }
  }
  

  或者监听视图布局完成事件：

  lastFocusedButton?.viewTreeObserver?.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
      override fun onGlobalLayout() {
          lastFocusedButton?.requestFocus()
          lastFocusedButton?.viewTreeObserver?.removeOnGlobalLayoutListener(this)
      }
  })
  

2. 系统自动焦点抢占 #

Android TV会在页面恢复时自动分配默认焦点（优先选择布局中第一个可聚焦视图或标记focusableInTouchMode="true"的视图），如果你的请求时机晚于系统自动分配，就会被覆盖。

• 排查：在onResume中打印焦点变化日志，看是否有其他视图先获得焦点：

  override fun onResume() {
      super.onResume()
      Log.d("FocusLog", "系统当前焦点：${requireActivity().currentFocus?.id}")
  }
  

• 解决：
  • 阻止系统自动分配：在页面根布局添加android:descendantFocusability="blocksDescendants"，手动控制焦点流程。
  • 提前焦点请求时机：将焦点恢复逻辑移到onStart而非onResume，或者在窗口获得焦点时处理：

    override fun onWindowFocusChanged(hasFocus: Boolean) {
        super.onWindowFocusChanged(hasFocus)
        if (hasFocus) {
            lastFocusedButton?.requestFocus()
        }
    }
    

3. FocusRestorer 逻辑冲突 #

你使用的focusRestorer在页面恢复时可能也会自动恢复焦点，和你手动保存的原按钮焦点逻辑冲突，导致部分场景被覆盖。

• 排查：临时禁用focusRestorer，测试返回时焦点是否正常。
• 解决：打开第二屏时暂停focusRestorer的自动恢复，返回后先执行手动焦点恢复，再重启focusRestorer。

4. 目标按钮焦点状态被修改 #

页面恢复时，目标按钮可能因为数据刷新、状态重置（比如enabled变为false、focusable被设为false）而无法接收焦点。

• 排查：请求焦点前打印按钮状态：

  Log.d("ButtonState", "enabled: ${button.isEnabled}, focusable: ${button.isFocusable}")
  

• 解决：恢复焦点前确保按钮状态正确：

  lastFocusedButton?.let {
      it.isEnabled = true
      it.isFocusable = true
      it.requestFocus()
  }
  

5. 焦点请求不在主线程 #

如果焦点请求在非主线程执行，会导致请求无效。

• 排查：检查代码线程，打印Looper.myLooper() == Looper.getMainLooper()的结果。
• 解决：确保焦点操作在主线程执行：

  requireActivity().runOnUiThread {
      lastFocusedButton?.requestFocus()
  }
  

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