DialogFragment中Compose TextField获焦但软键盘无法弹出如何解决？

自定义Jetpack Compose实现的MyTextFiled组件分别在普通Fragment、DialogFragment中使用时表现不一致：

• 普通Fragment场景：点击输入框可正常唤起系统软键盘
• DialogFragment场景：即使TextField已经获取焦点，软键盘仍无法自动弹出

组件实现代码如下：

fun MyTextFiled(
    search: (String) -> Unit,
    query: String?
) {
    var state by rememberSaveable { mutableStateOf(query) }
    Card(
        shape = RoundedCornerShape(dimensionResource(id = R.dimen.padding_5dp)),
    ) {
        Row(
            horizontalArrangement = Arrangement.Center,
            verticalAlignment = Alignment.CenterVertically,
            modifier = Modifier
                .height(36.dp)
                .background(colorResource(id = R.color.background_wallet_searchView)),
        ) {
            Icon(
                painter = painterResource(id = R.drawable.ic_new_search),
                contentDescription = null,
                modifier = Modifier
                    .size(20.dp)
                    .padding(start = dimensionResource(id = R.dimen.padding_5dp)),
                tint = colorResource(id = R.color.text_secondary),
            )
            BasicTextField(
                value = state?:"",
                onValueChange = {
                    search.invoke(it)
                    state = it
                },
                maxLines = 1,
                modifier = Modifier
                    .weight(1F)
                    .align(Alignment.CenterVertically)
                    .padding(horizontal = dimensionResource(id = R.dimen.padding_5dp)),
                singleLine = true,
                textStyle = TextStyle(
                    color = colorResource(id = R.color.text_secondary),
                    fontSize = 13.sp,
                    fontStyle = MaterialTheme.typography.overline.fontStyle
                ),
                keyboardOptions = KeyboardOptions.Default.copy(
                    capitalization = KeyboardCapitalization.Sentences,
                    autoCorrect = true,
                    keyboardType = KeyboardType.Number,
                    imeAction = ImeAction.Search
                ),
                decorationBox = { innerTextField ->
                    if (state.isNullOrEmpty()) {
                        Text(
                            text = stringResource(id = R.string.search),
                            style = MaterialTheme.typography.overline,
                            fontSize = 12.sp,
                            color = colorResource(id = R.color.text_secondary)
                        )
                    }
                    innerTextField()
                }
            )
            if (!state.isNullOrEmpty())
                Icon(
                    painter = painterResource(id = R.drawable.round_close_24),
                    contentDescription = null,
                    modifier = Modifier
                        .clickable {
                            state = ""
                            search.invoke("")
                        }
                        .size(20.dp)
                        .padding(end = dimensionResource(id = R.dimen.padding_5dp))
                )
        }
    }
}

DialogFragment的窗口默认软键盘交互策略和普通Fragment依附的Activity窗口存在差异：Dialog窗口默认不会在输入控件获取焦点时主动触发软键盘弹出，Compose的焦点传递逻辑不会绕过系统Window层的软键盘显示规则，因此会出现控件已获焦但键盘不弹出的问题。

根据自己的实现场景二选一即可：

• 方案1：在DialogFragment生命周期中配置Window软键盘参数
  在DialogFragment的onStart方法中清除阻止输入法弹出的窗口标志，设置软键盘默认显示策略：

  override fun onStart() {
      super.onStart()
      dialog?.window?.apply {
          clearFlags(
              WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE,
              WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM
          )
          setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_ALWAYS_VISIBLE)
      }
  }
  

• 方案2：在Compose侧主动唤起软键盘
  给输入框绑定焦点请求器，在Dialog布局完成后主动请求焦点并调起软键盘：

  // 在MyTextFiled内部添加以下逻辑
  val focusRequester = remember { FocusRequester() }
  val keyboardController = LocalSoftwareKeyboardController.current
  
  LaunchedEffect(Unit) {
      // 等待Dialog渲染完成再操作，避免焦点请求失效
      delay(120)
      focusRequester.requestFocus()
      keyboardController?.show()
  }
  
  // 给原有BasicTextField的modifier添加focusRequester配置
  BasicTextField(
      // 其他原有参数保持不变
      modifier = Modifier
          // 保留你之前写的所有modifier逻辑
          .focusRequester(focusRequester)
  )
  

注意：如果使用的是Compose原生Dialog组件而非Fragment实现的DialogFragment，直接使用方案2即可，不需要额外处理Window参数。

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