macOS下如何将Pasteboard的promiseKeeper移至子线程避免主线程阻塞

背景与问题 #

当前使用Qt 5.15.2，基于<ApplicationServices/ApplicationServices.h>库处理剪贴板：

• 已知通过PasteboardSetPromiseKeeper设置剪贴板的promise keeper回调（用于延迟渲染剪贴板数据），通过PasteboardPutItemFlavor放置空数据，用户按下Ctrl+V时触发该回调
• 核心问题：PromiseKeeper函数始终运行在主线程，导致UI冻结、流程挂起

已尝试操作 #

• 通过QThread创建子线程，PasteboardCreate和PasteboardSetPromiseKeeper均在子线程执行
• 尝试多层线程嵌套，PromiseKeeper仍运行在主线程，无效果
• 怀疑与macOS系统事件循环有关，参考Qt源码得知需在子线程创建“run loop context”，但不明确用法尚未尝试

疑问 #

• 是否对PromiseKeeper的使用存在误解？
• 是否绝对不能阻塞PromiseKeeper？
• 如何实现用户按下Ctrl+V时从网络获取数据并写入剪贴板？

原始伪代码 #

// in child thread context
OSStatus err = PasteboardCreate(kPasteboardClipboard, &m_pasteboard);
err = PasteboardSetPromiseKeeper(m_pasteboard, promiseKeeper, this);

OSStatus MacClipboard::promiseKeeper(PasteboardRef pasteboard, PasteboardItemID pasteboardItemID, CFStringRef uti, void *_macClipboard)
{
    qDebug() << "promiseKeeper Thread id=" << QThread::currentThreadId();
    
    // In this case, I need to access the data on the network in another thread.

    macClipboard->_promisMutex.lock();
    macClipboard->_createPromise(pasteboardItemID, formatName);
    bool timeouted = !(macClipboard->_promisWaitCondition.wait(&macClipboard->_promisMutex, 5000));
    macClipboard->_promisMutex.unlock();

    const CFDataRef cfData = CFDataCreate(nullptr, (UInt8*)macClipboard->promiseData()->constData(), macClipboard->promiseData()->size());
    resultStatus = PasteboardPutItemFlavor(pasteboard, pasteboardItemID, uti, cfData, kPasteboardFlavorNoFlags);

    return noErr;
}

问题分析与解决方案 #

核心逻辑澄清 #

macOS的剪贴板Promise Keeper回调由系统在发起粘贴请求的线程（通常是主线程）触发，和创建剪贴板对象的线程无关——这是系统设计规则，所以你之前在子线程创建剪贴板的操作无法改变回调执行线程。同时，PromiseKeeper绝对不能阻塞：系统在等待回调返回期间会卡住发起粘贴的进程，这就是UI冻结的直接原因。

正确实现步骤 #

1. 立即返回PromiseKeeper，不做阻塞操作：回调仅标记任务，立刻返回noErr释放主线程
2. 异步拉取网络数据：用Qt线程池或QThread启动后台任务，避免阻塞
3. 数据就绪后写入剪贴板：主动调用PasteboardPutItemFlavor写入真实数据，系统会自动完成粘贴流程

修改后的伪代码 #

OSStatus MacClipboard::promiseKeeper(PasteboardRef pasteboard, PasteboardItemID pasteboardItemID, CFStringRef uti, void *_macClipboard)
{
    qDebug() << "promiseKeeper Thread id=" << QThread::currentThreadId();
    
    MacClipboard* macClipboard = static_cast<MacClipboard*>(_macClipboard);
    // 标记待处理的粘贴任务
    macClipboard->_promisMutex.lock();
    macClipboard->pendingTasks.append({pasteboard, pasteboardItemID, uti});
    macClipboard->_promisMutex.unlock();

    // 异步启动网络数据拉取（Qt::QueuedConnection确保在对象线程执行，或直接用QThreadPool）
    QMetaObject::invokeMethod(macClipboard, "fetchDataAsync", Qt::QueuedConnection,
                              Q_ARG(PasteboardRef, pasteboard),
                              Q_ARG(PasteboardItemID, pasteboardItemID),
                              Q_ARG(CFStringRef, uti));

    // 立即返回，释放主线程
    return noErr;
}

// 异步拉取数据的槽函数（建议移到QThread或QThreadPool执行）
void MacClipboard::fetchDataAsync(PasteboardRef pasteboard, PasteboardItemID itemID, CFStringRef uti)
{
    // 模拟网络请求，替换为实际的网络调用
    QByteArray networkData = this->performNetworkFetch();

    // 数据就绪后写入剪贴板
    macClipboard->_promisMutex.lock();
    const CFDataRef cfData = CFDataCreate(nullptr, reinterpret_cast<UInt8*>(networkData.constData()), networkData.size());
    if (cfData) {
        PasteboardPutItemFlavor(pasteboard, itemID, uti, cfData, kPasteboardFlavorNoFlags);
        CFRelease(cfData);
    }
    // 清理待处理任务
    macClipboard->pendingTasks.removeOne({pasteboard, itemID, uti});
    macClipboard->_promisMutex.unlock();
}

注意事项 #

• 确保PasteboardRef在整个异步流程中保持有效，不要提前释放
• 网络请求需设置超时机制，超时后可写入空数据或提示内容
• 遵循Qt线程规则，避免跨线程直接访问UI对象或未线程安全的成员变量

内容的提问来源于stack exchange，提问作者gao.xiangyang