Jetpack Compose调用moveFocus报Unresolved reference错误解决方案

DevOps 小满

2026-8-27

问题成因

两个问题（编译报错、软键盘收不起来）都是Compose焦点/键盘API使用错误导致的：

moveFocus()是FocusManager的实例方法，不是静态方法，你直接拿FocusManager类名调用，编译器根本找不到这个方法，报Unresolved reference: moveFocus是必然结果，必须先拿到当前界面对应的FocusManager实例才能调用它的方法。
就算调通了moveFocus(FocusDirection.Down)逻辑也不对：这个方法只是把焦点移动到下一个可聚焦控件上，如果界面下方没有其他可聚焦组件，焦点根本清不掉，软键盘自然不会收起，完全达不到触发搜索后隐藏键盘的效果。

修复步骤

先在OutlinedTextField所在的Composable作用域里，拿到两个必要的实例：
- 通过LocalFocusManager.current获取当前可用的焦点管理器
- 通过LocalSoftwareKeyboardController.current获取软键盘控制器，专门用来控制软键盘显隐，比靠移焦点碰运气收键盘稳定得多
修改onSearch回调逻辑：触发搜索时先清掉输入框焦点、主动隐藏软键盘，再执行搜索业务逻辑。

修复后的代码参考：

// 在Composable函数内、OutlinedTextField调用前声明即可
val focusManager = LocalFocusManager.current
val keyboardController = LocalSoftwareKeyboardController.current

OutlinedTextField(
    value = searchItem.value,
    onValueChange = { searchItem.value = it },
    // 别漏了配置keyboardOptions，不然输入法不显示搜索按钮，onSearch回调根本不会触发
    keyboardOptions = KeyboardOptions(imeAction = ImeAction.Search),
    keyboardActions = KeyboardActions(
        onSearch = {
            focusManager.clearFocus()
            keyboardController?.hide()
            viewModel.SearchProduct(searchItem.value)
        }
    )
    // 其余原有OutlinedTextField参数照常配置即可
)

注意点

别用移动焦点的方式处理键盘隐藏：不同系统版本、不同输入法的焦点移动逻辑有差异，直接调用clearFocus()清空当前输入焦点，配合keyboardController?.hide()主动收起键盘，是兼容性最高的方案。
keyboardController的hide()方法要用空安全调用：部分场景（比如界面切到后台）下拿不到控制器实例，直接调用会触发崩溃，加?.即可避免问题。
如果写代码时找不到LocalSoftwareKeyboardController，手动导包即可，包路径是androidx.compose.ui.platform.LocalSoftwareKeyboardController，属于Compose UI基础包，不需要额外引入依赖。

内容的提问来源于stack exchange，提问作者Ashana.Jackol