Flutter Quill编辑器移动端无法粘贴剪贴板内容报错求助

问题原因 #

从报错栈可以看出，该错误源于Flutter的Clipboard.getData()方法在Android平台尝试读取剪贴板内容时，遇到了无法直接读取的非文本类型内容（如文件、富媒体等），而flutter_quill v5.3.0的默认粘贴逻辑未处理这类异常，导致抛出PlatformException。

解决方案 #

1. 升级flutter_quill到最新稳定版 #

该剪贴板异常处理问题在flutter_quill的后续版本中已被修复。修改pubspec.yaml中的依赖版本：

dependencies:
  flutter_quill: ^latest_version # 替换为当前最新稳定版

执行flutter pub get更新依赖后，重新测试粘贴功能。

2. 自定义粘贴逻辑（若升级后仍存在问题） #

如果无法升级版本，或仍遇到特殊场景的剪贴板问题，可以重写粘贴逻辑，仅处理纯文本内容并捕获异常：

// 替换原QuillEditor.basic的代码
Expanded(
  child: quill.QuillEditor.builder(
    controller: _controller,
    readOnly: false,
    focusNode: FocusNode(),
    builder: (context, scrollController) {
      return quill.RawEditor(
        controller: _controller,
        scrollController: scrollController,
        readOnly: false,
        createState: () => _CustomRawEditorState(),
      );
    },
  ),
)

// 自定义RawEditorState，重写pasteText方法
class _CustomRawEditorState extends quill.RawEditorState {
  @override
  Future<void> pasteText() async {
    try {
      // 仅读取纯文本剪贴板内容
      final clipboardData = await Clipboard.getData(Clipboard.kTextPlain);
      if (clipboardData?.text != null && clipboardData!.text!.isNotEmpty) {
        // 将文本插入编辑器当前光标位置
        insertText(clipboardData.text!);
      }
    } catch (e) {
      // 捕获剪贴板读取异常，可添加用户提示
      debugPrint('粘贴失败：$e');
      ScaffoldMessenger.of(context).showSnackBar(
        const SnackBar(content: Text('无法粘贴非文本内容')),
      );
    }
  }
}

3. 临时规避方案 #

如果用户粘贴的内容包含非文本数据，可提示用户仅复制纯文本内容后再尝试粘贴，避免触发该错误。

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