Swift/Xcode：滑动操作触发textfield后键盘无法保持弹出如何解决

问题原因 #

你遇到的键盘自动收回问题是 UIContextualAction 的执行逻辑导致的：当你调用 completionHandler(true) 时，系统会自动执行侧滑操作结束后的界面复位流程，这个流程会主动取消当前所有控件的第一响应者状态。你把 becomeFirstResponder() 放在 completionHandler 调用之前，刚唤起的键盘刚好被后续的复位逻辑强制收起。

解决方案 #

调整代码执行顺序，把文本框的编辑权限配置和键盘唤起逻辑放到主队列异步执行，等侧滑复位流程完全结束后再触发：
首先在当前视图控制器中新增一个属性记录正在编辑的行，解决cell复用导致的状态错乱问题：

// 声明在视图控制器的属性区域
var editingIndexPath: IndexPath?

然后修改侧滑操作的代码：

func tableView(_ tableView: UITableView, trailingSwipeActionsConfigurationForRowAt indexPath: IndexPath) -> UISwipeActionsConfiguration? {
    
    let renameItem = UIContextualAction(style: .normal, title: "Rename") { contextAction, viewProperty, completionHandler in
        // 先记录当前要编辑的行
        self.editingIndexPath = indexPath
        // 先调用completionHandler结束侧滑状态
        completionHandler(true)
        // 异步调度到主队列，等待侧滑复位逻辑执行完成
        DispatchQueue.main.async {
            // 用可选绑定代替强制解包，避免异常情况下的崩溃
            guard let cell = tableView.cellForRow(at: indexPath) as? ItemTableViewCell else { return }
            cell.nameField.isUserInteractionEnabled = true
            cell.nameField.becomeFirstResponder()
        }
    }
    
    return UISwipeActionsConfiguration(actions: [renameItem])
}

额外适配建议 #

• 在 tableView(_:cellForRowAt:) 方法中添加状态判断，根据 editingIndexPath 配置对应cell的textfield交互权限，防止滚动cell复用导致编辑状态异常
• 实现 UITextFieldDelegate 的 textFieldShouldReturn(_:) 等结束输入的代理方法，在用户完成输入后将 editingIndexPath 置空，同时把textfield的 isUserInteractionEnabled 改回默认的false
• 若需要点击空白处收起键盘，记得在手势触发的逻辑中同步处理 editingIndexPath 和textfield的状态

同类问题排查方法 #

后续遇到第一响应者被莫名抢占的问题，可以通过Xcode符号断点快速定位：

1. 打开断点导航栏，点击左下角+号选择「Symbolic Breakpoint」
2. 符号栏填入 -[UIResponder resignFirstResponder]
3. 运行项目触发问题，断点会在任意控件放弃第一响应者状态时触发，查看调用栈就能直接找到触发响应者重置的逻辑位置

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