QSharedMemory附加失败：AlreadyExists错误排查求助

核心问题定位 #

QSharedMemory::AlreadyExists 错误的本质是：同一进程内，同一个键的共享内存实例被重复调用attach()。即使是不同实例，只要键相同且当前进程已经关联过该共享内存，再次attach就会触发这个错误。以下是针对性的排查和解决步骤：

1. 检查读取端是否重复attach #

如果读取逻辑被多次调用，每次都新建QSharedMemory实例并直接attach，就会触发错误。

错误示例：

void readSharedData() {
    QSharedMemory shm("MySharedKey");
    // 第一次调用正常，第二次调用时当前进程已attach过该键，直接报错
    if (!shm.attach()) {
        qDebug() << "Attach failed:" << shm.errorString();
    }
}

修正方案：

确保同一进程内同一键的共享内存只attach一次，或attach前检查状态：

void readSharedData() {
    // 用静态实例保证进程内唯一
    static QSharedMemory shm("MySharedKey");
    if (!shm.isAttached()) {
        if (!shm.attach()) {
            qDebug() << "Attach failed:" << shm.errorString();
            return;
        }
    }
    // 读取数据逻辑
    shm.lock();
    QByteArray data(static_cast<char*>(shm.data()), shm.size());
    shm.unlock();
    qDebug() << "Read content:" << data;
}

2. 规范写入端的detach时机 #

如果写入端和读取端是同一进程，写入后未detach会导致进程一直关联共享内存，后续读取时attach必然报错。

写入端正确示例：

void writeSharedData(const QByteArray& data) {
    QSharedMemory shm("MySharedKey");
    // 先解除当前进程可能存在的关联
    if (shm.isAttached()) {
        shm.detach();
    }
    // 创建或覆盖共享内存
    if (!shm.create(data.size())) {
        qDebug() << "Create failed:" << shm.errorString();
        return;
    }
    // 写入数据
    shm.lock();
    char* dest = static_cast<char*>(shm.data());
    memcpy(dest, data.constData(), data.size());
    shm.unlock();
    // 写入完成后解除关联
    shm.detach();
}

3. 确保键的一致性 #

Qt会自动为setKey()设置的键添加前缀，若读取端和写入端混用setKey()和setNativeKey()，会导致键不匹配（虽通常触发NotFound，但也可能引发异常）。

• 两端统一使用setKey("自定义键")，或统一使用setNativeKey("原生系统键")，不要混用。

4. 跨进程场景的额外处理 #

如果是两个独立进程，读取端触发该错误，大概率是读取进程之前已经attach过该共享内存未释放。可在attach前强制detach当前进程的关联：

void crossProcessRead() {
    QSharedMemory shm("MySharedKey");
    // 先解除当前进程可能存在的旧关联
    shm.detach();
    if (!shm.attach()) {
        qDebug() << "Attach failed:" << shm.errorString();
        return;
    }
    // 读取逻辑...
    shm.detach(); // 读取完成后释放关联
}

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