Android TV Jetpack Compose崩溃求助：visitAncestors调用未附加节点

核心原因 #

这个崩溃是Compose焦点系统尝试访问已从Compose树中分离（未附加）的FocusTargetNode时触发的，通常出现在焦点搜索过程中，节点因重组、页面跳转等原因已经被移除，但焦点系统仍持有对它的引用。

针对性解决方案 #

1. 绑定焦点状态与组件生命周期 #

• 避免在组件销毁/移除后调用焦点相关API（如FocusRequester.requestFocus()）。通过DisposableEffect在组件销毁时清理焦点请求：

val focusRequester = remember { FocusRequester() }
DisposableEffect(Unit) {
    onDispose {
        focusRequester.freeFocus()
    }
}

• 用LaunchedEffect配合组件可见性状态，仅在组件可见时执行焦点操作：

val isVisible by remember { mutableStateOf(true) }
LaunchedEffect(isVisible) {
    if (isVisible) {
        focusRequester.requestFocus()
    } else {
        focusRequester.freeFocus()
    }
}

2. 升级Compose UI版本修复已知Bug #

该异常在Compose UI旧版本中存在焦点系统的生命周期处理漏洞，建议升级到Compose UI 1.4.0及以上版本（或对应Jetpack Compose BOM版本），官方后续版本已修复多个相关问题。

3. 优化焦点组件的重组逻辑 #

• 避免频繁创建销毁带focusTarget修饰符的组件，用remember稳定化组件状态减少不必要重组：

@Composable
fun TvListItem(item: Item) {
    val itemKey = remember(item.id) { item.id }
    Box(
        modifier = Modifier
            .focusTarget()
            .focusRequester(remember { FocusRequester() })
    ) {
        // 列表项内容
    }
}

• 动态显示/隐藏组件时，用if判断彻底移除组件（而非仅视觉隐藏），避免残留未附加的焦点节点。

4. 自定义焦点搜索逻辑（临时规避） #

若升级版本后仍偶现问题，可自定义焦点搜索规则跳过未附加节点：

fun Modifier.customFocusSearch() = this.focusProperties {
    nextFocusDown = FocusRequester.Cancel
    // 按需自定义其他方向的焦点搜索逻辑
}

崩溃日志分析 #

异常调用链指向焦点搜索流程：

java.lang.IllegalStateException: visitAncestors called on an unattached node
at androidx.compose.ui.focus.FocusTargetNode.fetchFocusProperties$ui_release(FocusTargetNode.kt:251)
at androidx.compose.ui.focus.TwoDimensionalFocusSearchKt.searchChildren-4C6V_qg(TwoDimensionalFocusSearch.kt:170)
at androidx.compose.ui.focus.TwoDimensionalFocusSearchKt.generateAndSearchChildren-4C6V_qg(TwoDimensionalFocusSearch.kt:141)
at androidx.compose.ui.focus.TwoDimensionalFocusSearchKt.searchChildren-4C6V_qg(TwoDimensionalFocusSearch.kt:173)

说明焦点系统遍历子节点搜索下一个焦点目标时，遇到了已被分离的节点，调用visitAncestors触发状态检查异常。

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