SwiftUI iOS15 TextEditor点击粘贴触发pos参数无效崩溃

AI 小北

2026-8-28

问题根因

崩溃核心原因是TextEditor绑定值的onChange回调里，强制修改文本内容的逻辑打断了底层UITextView粘贴操作的内部事务流程：

从崩溃栈可以明确看到，点击粘贴后系统正执行文本粘贴范围校验（对应_UITextKitTextPosition compare:、UITextPasteController _clampRange:调用逻辑），此时在onChange中直接重写description值、调用removeLast()删字符的操作，会让UITextView内部持有的文本位置指针、选中范围和实际文本内容不匹配，系统拿到无效位置对象后直接触发断言崩溃。
真机和模拟器的表现差异不是兼容性问题：iPhone 13真机长按没出粘贴选项，是因为设备开启实况文本功能后，无选中文本状态下长按优先展示scanText入口，根本没走到粘贴逻辑，所以没触发崩溃，不代表真机不存在该问题。
现有onChange逻辑本身存在错误：if description <= wordCount是字符串类型和整数类型直接比较，逻辑完全不生效；直接调用self.description.removeLast()在文本长度不足时还会触发越界问题。
onAppear里全局修改UITextView.appearance().backgroundColor的操作会影响App内所有UITextView实例，也可能干扰SwiftUI TextEditor的内部状态更新。

修复方案

先做快速验证：临时注释掉整个.onChange(of: description)修饰符，重新运行模拟器点击粘贴，崩溃会立刻消失，可直接确认问题来源。
修正文本校验逻辑，不要在系统编辑事务执行的当前调用栈里直接重写绑定值，把文本修改操作派发至下一个主循环执行，同时修正原有逻辑错误，参考代码：

.onChange(of: description) { newValue in
    // 异步执行文本处理，不打断系统当前粘贴/输入事务
    DispatchQueue.main.async {
        var processedText = newValue
        // 先处理换行符替换
        if processedText.contains("\n") {
            processedText = processedText.replacingOccurrences(of: "\n", with: "")
            nameIsFocused = false
        }
        // 修正原字符串与整数比较的错误，处理字数限制
        if processedText.count > wordCount {
            processedText = String(processedText.prefix(wordCount))
        }
        // 仅当处理后文本和原值不一致时才赋值，避免触发不必要的状态更新
        if processedText != description {
            description = processedText
        }
    }
}

移除全局Appearance修改，不要在onAppear里改全局UITextView样式：iOS 16及以上版本直接加.scrollContentBackground(.hidden)修饰符隐藏TextEditor原生背景即可；如果要兼容iOS 16以下版本，用UIViewRepresentable包装自定义UITextView实例，单独给该实例设置backgroundColor = .clear，不要影响全局文本视图。
如果上述修改后仍偶现崩溃，直接换用UIViewRepresentable包装自定义UITextView的方案，在textViewDidChange代理方法中做文本校验，这种方式对文本编辑流程的干扰最小，不会出现SwiftUI绑定更新和UITextView内部状态不同步的问题。

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