iOS自定义键盘每次切换时高度递增问题排查求助

这是个挺棘手的iOS自定义键盘边缘场景问题，我之前调试自定义键盘时也踩过Mail应用的类似坑，结合你描述的零代码复现、约束无效等情况，来拆解下可能的成因：

核心成因推测 #

• Mail回复界面的特殊布局逻辑：Apple Mail的回复窗口是嵌套在主界面的子视图层级中，它对输入视图的生命周期处理和Messages等常规应用差异很大。每次切换键盘时，Mail可能没有正确重置自定义键盘视图的frame或布局状态，导致系统重复执行高度计算逻辑，最终造成高度累加。零代码复现说明这是系统与Mail应用的交互bug，而非你的代码逻辑问题。
• UIInputViewController的生命周期异常：在Mail的容器视图环境下，切换键盘时系统可能没有按预期调用viewWillDisappear/viewDidDisappear来销毁或重置自定义键盘视图，而是复用了原有视图实例，但又重新触发了布局流程，导致高度被多次叠加计算。
• SwiftUI与UIKit的隐性冲突：虽然零代码UIKit版本也能复现问题，但SwiftUI的UIViewRepresentable包装逻辑可能会加剧这个问题——SwiftUI的视图更新机制和UIInputViewController的生命周期不完全对齐，导致布局状态无法被正确重置。不过核心问题还是Mail的特殊处理逻辑。

可尝试的解决方案 #

1. 强制在视图显示前重置高度 #

在viewWillAppear中手动将自定义键盘高度设为标准键盘高度，同时把高度约束优先级拉满（.required），避免Mail的布局逻辑覆盖你的设置：

class KeyboardViewController: UIInputViewController {
    private var heightConstraint: NSLayoutConstraint?
    
    override func viewDidLoad() {
        super.viewDidLoad()
        view.backgroundColor = .yellow
        
        // 初始化高度约束，优先级设为required
        heightConstraint = view.heightAnchor.constraint(equalToConstant: 66)
        heightConstraint?.priority = .required
        heightConstraint?.isActive = true
    }
    
    override func viewWillAppear(_ animated: Bool) {
        super.viewWillAppear(animated)
        // 获取系统标准键盘高度（也可以直接用固定值，比如66或根据设备调整）
        if let keyboardHeight = getSystemKeyboardHeight() {
            heightConstraint?.constant = keyboardHeight
        }
    }
    
    private func getSystemKeyboardHeight() -> CGFloat? {
        // 通过通知或系统默认值获取标准高度，这里简化处理
        return UIScreen.main.bounds.height * 0.15
    }
}

2. 监听键盘通知强制同步高度 #

注册UIKeyboardWillShowNotification，在回调中获取系统键盘的真实高度，强制同步到自定义键盘：

class KeyboardViewController: UIInputViewController {
    private var heightConstraint: NSLayoutConstraint?
    
    override func viewDidLoad() {
        super.viewDidLoad()
        view.backgroundColor = .yellow
        
        heightConstraint = view.heightAnchor.constraint(equalToConstant: 66)
        heightConstraint?.priority = .required
        heightConstraint?.isActive = true
        
        // 监听键盘显示通知
        NotificationCenter.default.addObserver(
            self,
            selector: #selector(syncKeyboardHeight),
            name: UIResponder.keyboardWillShowNotification,
            object: nil
        )
    }
    
    @objc private func syncKeyboardHeight(notification: NSNotification) {
        guard let keyboardFrame = notification.userInfo?[UIKeyboardFrameEndUserInfoKey] as? CGRect else { return }
        heightConstraint?.constant = keyboardFrame.height
        view.layoutIfNeeded()
    }
    
    deinit {
        NotificationCenter.default.removeObserver(self)
    }
}

3. 在视图消失时重置状态 #

尝试在viewDidDisappear中手动重置高度，避免下次显示时携带旧的布局状态：

override func viewDidDisappear(_ animated: Bool) {
    super.viewDidDisappear(animated)
    heightConstraint?.constant = 66 // 重置为默认高度
}

补充说明 #

这个问题属于Apple Mail应用的特殊场景bug，你可以考虑向Apple提交反馈（通过Feedback Assistant）来推动官方修复。上面的方案都是临时缓解措施，但应该能解决高度递增的问题。

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