Android Jetpack Compose中TextFieldComponent被键盘遮挡问题求助

针对你遇到的TextFieldComponent被键盘遮挡、二次点击恢复正常的问题，核心原因大概率是自定义组件未正确处理键盘弹出时的布局偏移或焦点通知，以下是具体排查和修复步骤：

• 给外层Column绑定滚动容器并主动处理焦点滚动
  原生TextField会自动触发滚动容器的偏移，但自定义组件可能缺乏这个逻辑。给Column套一个verticalScroll，并给最后两个TextFieldComponent绑定焦点请求器，当它们获得焦点时主动滚动到可见位置：

  val scrollState = rememberScrollState()
  val scope = rememberCoroutineScope()
  val focusRequester4 = remember { FocusRequester() }
  val focusRequester5 = remember { FocusRequester() }
  
  Column(
      modifier = Modifier
          .fillMaxSize()
          .verticalScroll(scrollState)
  ) {
      // 前3个TextFieldComponent
      TextFieldComponent(...)
      TextFieldComponent(...)
      TextFieldComponent(...)
  
      // 第4个输入框
      TextFieldComponent(
          modifier = Modifier
              .focusRequester(focusRequester4)
              .onFocusChanged {
                  if (it.isFocused) {
                      scope.launch {
                          scrollState.animateScrollTo(scrollState.maxValue)
                      }
                  }
              }
      )
  
      // 第5个输入框
      TextFieldComponent(
          modifier = Modifier
              .focusRequester(focusRequester5)
              .onFocusChanged {
                  if (it.isFocused) {
                      scope.launch {
                          scrollState.animateScrollTo(scrollState.maxValue)
                      }
                  }
              }
      )
  }
  

• 检查自定义TextFieldComponent的Insets处理逻辑
  确保组件内部监听了窗口Insets变化，而非仅在父布局使用imePadding()。在组件内部添加Insets监听，动态调整布局：

  // TextFieldComponent内部实现示例
  @Composable
  fun TextFieldComponent(modifier: Modifier = Modifier) {
      var imeHeight by remember { mutableStateOf(0.dp) }
  
      Box(
          modifier = modifier
              .fillMaxWidth()
              .onWindowInsetsChanged { insets ->
                  imeHeight = insets.ime.bottom.toDp()
              }
              .padding(bottom = imeHeight)
      ) {
          // 输入框的具体UI实现
          BasicTextField(...)
      }
  }
  

• 验证AndroidManifest的软键盘配置
  确保当前Activity的android:windowSoftInputMode设置为adjustResize，而非adjustPan或其他值，这个配置是布局响应键盘弹出的基础：

  <activity
      android:name=".YourActivity"
      android:windowSoftInputMode="adjustResize">
  </activity>
  

• 排查组件内部的焦点逻辑
  如果自定义组件重写了焦点处理逻辑，检查是否在获得焦点时没有触发父布局的重新测量。比如是否调用了requestFocus()但没有通知Compose的布局系统更新，导致第一次点击时布局未及时滚动。

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