Jetpack Compose错误提示无障碍焦点请求无效问题排查

核心问题确认 #

先明确已知前提：

• 错误提示组件已配置focusRequester，日志显示焦点请求成功
• 手动点击错误文本时，无障碍工具可正常朗读
• 相同代码在全新项目中可正常触发朗读，排除代码逻辑本身问题

逐步排查方案 #

1. 检查组件的无障碍语义配置 #

• 确认错误提示组件的Modifier.semantics未覆盖默认语义：比如是否正确设置了contentDescription，是否存在semantics { contentDescription = null }这类禁用无障碍的配置
• 确保组件已添加Modifier.focusable(true)，且该Modifier未被其他布局Modifier意外覆盖

2. 排查焦点拦截与冲突 #

• 检查错误状态触发时，是否有其他组件（如OTP输入框）同时请求焦点，导致焦点被抢占
• 添加全局焦点变化监听，完整打印焦点流转流程：

  val focusManager = LocalFocusManager.current
  LaunchedEffect(Unit) {
      focusManager.addFocusChangeListener { oldFocus, newFocus ->
          Log.d("FocusDebug", "旧焦点ID: ${oldFocus?.id}, 新焦点ID: ${newFocus?.id}")
      }
  }
  

  验证错误提示组件的焦点是否稳定持有，未被快速夺走

3. 检查项目级无障碍配置 #

• 查看AndroidManifest.xml，确认是否存在android:accessibilityFlags等可能影响无障碍的全局配置
• 对比新项目与现有项目的Compose版本：不同版本的Compose可能存在无障碍焦点朗读的逻辑差异，优先确保版本一致

4. 排查布局层级与状态影响 #

• 即使移除了动画，检查父组件是否存在Modifier.animateContentSize、Modifier.visibility等动态布局逻辑，导致焦点组件的布局状态不稳定，无障碍工具未检测到焦点变化
• 临时将错误提示组件移至界面最顶层（脱离原有布局层级），测试是否能触发朗读，排查是否是父组件拦截了无障碍事件

5. 验证无障碍工具兼容性 #

• 切换系统自带TalkBack与第三方无障碍工具测试：部分第三方工具对焦点事件的处理逻辑不同，确认是否为工具兼容性问题
• 检查系统无障碍设置：确保TalkBack的「焦点朗读」等核心功能已开启，未被自定义设置禁用

6. 对比依赖与主题差异 #

• 导出两个项目的依赖树（执行./gradlew app:dependencies命令），对比Compose、AppCompat等核心依赖的版本，排查是否存在依赖冲突
• 检查现有项目是否使用了自定义Compose主题或Modifier扩展，这类自定义逻辑可能修改了默认的焦点/无障碍行为

应急替代方案 #

若暂时无法定位根因，可绕过焦点直接发送无障碍朗读事件：

val context = LocalContext.current
LaunchedEffect(isError) {
    if (isError) {
        val announcement = AccessibilityEvent.obtain(AccessibilityEvent.TYPE_ANNOUNCEMENT)
        announcement.text.add("Password incorrect")
        AccessibilityManager.getInstance(context).sendAccessibilityEvent(announcement)
    }
}

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