Robolectric中Compose FocusRequester初始化问题解析

问题背景

在使用Robolectric进行Compose UI测试时，开发者可能会遇到一个关于FocusRequester初始化的异常问题。具体表现为当尝试在LaunchedEffect中调用requestFocus()时，系统抛出"FocusRequester is not initialized"错误。

问题现象

开发者通常会编写如下代码来初始化并自动请求焦点：

@Composable
fun initialFocusRequester(): FocusRequester =
  remember { FocusRequester() }.apply {
    LaunchedEffect(this) {
      requestFocus()
    }
  }

然后在UI组件中使用：

@Composable
fun MyComposable() {
  val focusRequester = initialFocusRequester()
  TextField(
    state = rememberTextFieldState(),
    modifier = Modifier.focusRequester(focusRequester)
}

在真实设备上运行时一切正常，但在Robolectric测试环境中却会抛出初始化异常。

问题根源

经过深入分析，这个问题主要有两个关键因素：

1. Robolectric测试环境的时间特性：Robolectric模拟的Android环境与实际设备存在细微差异，特别是在UI更新和事件处理的时间线上。

2. SubcomposeLayout的特殊性：当使用Scaffold等基于SubcomposeLayout的组件时，子组件的挂载和初始化会被延迟。在Robolectric环境中，这种延迟表现得更加明显。

解决方案

针对这个问题，开发者可以采用以下几种解决方案：

方案一：调整FocusRequester的创建位置

将FocusRequester的创建移至Scaffold内部，确保它在子组件完全挂载后才被初始化：

@Composable
fun MyComposable() {
  Scaffold {
    val focusRequester = remember { FocusRequester() }
    LaunchedEffect(focusRequester) {
      focusRequester.requestFocus()
    }
    TextField(
      state = rememberTextFieldState(),
      modifier = Modifier.focusRequester(focusRequester)
    )
  }
}

方案二：使用测试专用的Dispatcher

在测试环境中，可以显式控制协程的执行时机：

val effectTestDispatcher = StandardTestDispatcher()

@get:Rule
val composeRule = createComposeRule(effectTestDispatcher)

@Test
fun test() {
  composeRule.setContent {
    MyComposable()
  }
  effectTestDispatcher.scheduler.advanceUntilIdle()
}

方案三：添加适当的延迟

虽然不推荐作为最终解决方案，但在某些情况下可以添加微小延迟：

LaunchedEffect(this) {
  delay(16) // 约一帧时间
  requestFocus()
}

最佳实践建议

1. 避免在composition阶段请求焦点：焦点请求应该是对用户交互的响应，而不是在初始composition时自动执行。

2. 为测试环境特殊处理：考虑创建测试专用的FocusRequester工具函数，根据环境决定是否添加延迟。

3. 理解SubcomposeLayout的特性：当使用Scaffold、LazyColumn等组件时，要注意它们的子组件初始化时机。

总结

Robolectric测试环境中出现的FocusRequester初始化问题，本质上是由于测试环境与真实设备在UI更新时序上的差异导致的。通过理解Compose的组件生命周期和Robolectric的特性，开发者可以采取适当的解决方案。最佳实践是将FocusRequester的创建和初始化放在正确的位置，并针对测试环境做适当调整。