如何解决FocusRequester未初始化异常？HorizontalPager焦点控制方案

问题描述 #

开发了StartPage、LoginPage、SignupPage三个页面并集成到HorizontalPager中，在SignupPage内给TextField调用了requestFocus方法。导航流程为Start→Login，但切换到LoginPage时触发了FocusRequester未初始化异常——该FocusRequester明明定义在SignupPage中。排查后确认原因是HorizontalPager会预加载非可见页面，需要实现仅在SignupPage可见时触发requestFocus，不可见时禁用该操作。

报错信息 #

java.lang.IllegalStateException: 
FocusRequester is not initialized. Here are some possible fixes:
1. Remember the FocusRequester: val focusRequester = remember { FocusRequester() }
2. Did you forget to add a Modifier.focusRequester() ?
3. Are you attempting to request focus during composition? Focus requests should be made in response to some event. Eg Modifier.clickable { focusRequester.requestFocus() }

原因分析 #

HorizontalPager默认会预加载相邻页面（默认预加载1个），当导航到LoginPage时，SignupPage已被预加载并进入组合阶段，但此时它的布局尚未完成，FocusRequester还未与TextField绑定，此时调用requestFocus就会抛出未初始化异常。

解决方案 #

方案1：绑定HorizontalPager页面状态控制焦点请求 #

直接利用HorizontalPager的PagerState判断当前可见页面，结合LaunchedEffect在页面切换到SignupPage时才触发焦点请求：

首先在父组件中维护Pager状态：

val pagerState = rememberPagerState(initialPage = 0) // 假设0=StartPage，1=LoginPage，2=SignupPage

然后在SignupPage中监听Pager状态：

// SignupPage.kt
@Composable
fun SignupPage(pagerState: PagerState) {
    val focusRequester = remember { FocusRequester() }
    
    LaunchedEffect(pagerState.currentPage, pagerState.isScrollInProgress) {
        // 仅当当前页面是SignupPage且滚动已停止时请求焦点
        if (pagerState.currentPage == 2 && !pagerState.isScrollInProgress) {
            focusRequester.requestFocus()
        }
    }

    TextField(
        value = "",
        onValueChange = {},
        modifier = Modifier
            .focusRequester(focusRequester)
    )
}

方案2：通过LifecycleState判断（你的尝试方向可行） #

利用Compose的生命周期监听，只有当SignupPage处于RESUMED状态（真正可见时）才请求焦点：

// SignupPage.kt
@Composable
fun SignupPage() {
    val focusRequester = remember { FocusRequester() }
    val lifecycleOwner = LocalLifecycleOwner.current
    val lifecycleState by lifecycleOwner.lifecycle.currentStateAsState()

    LaunchedEffect(lifecycleState) {
        if (lifecycleState == Lifecycle.State.RESUMED) {
            focusRequester.requestFocus()
        }
    }

    TextField(
        value = "",
        onValueChange = {},
        modifier = Modifier
            .focusRequester(focusRequester)
    )
}

HorizontalPager预加载的页面只会进入STARTED状态，只有当页面真正可见时才会切换到RESUMED，这个判断能精准控制焦点请求时机。

方案3：前置检查FocusRequester初始化状态 #

在请求焦点前先判断是否初始化，避免异常，但这种方式可能存在焦点请求不及时的问题，仅作为补充方案：

LaunchedEffect(Unit) {
    if (focusRequester.isInitialized) {
        focusRequester.requestFocus()
    }
}

最佳实践建议 #

• 优先选方案1，逻辑直接和HorizontalPager的页面状态绑定，能精准控制焦点触发时机，避免预加载带来的问题。
• 如果SignupPage需要独立复用（不依赖Pager），方案2更合适，符合组件的独立性原则。
• 务必确保FocusRequester用remember包裹，避免每次重组创建新实例，这是报错提示第一条的核心要求，别漏了。

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