Qt 6.5.3中QJSEngine脚本函数槽未在引擎线程执行的解决方法

问题场景 #

环境：Qt 6.5.3 + Visual Studio 2019
在工作线程中实例化QJSEngine，将其他线程（如网络通信对象、主线程QTimer）的信号连接到JS脚本函数时，连接虽成功，但脚本函数会在信号发送线程执行，而非QJSEngine所在的工作线程。由于QJSEngine非线程安全，这种跨线程访问会直接导致程序崩溃。尝试通过connect()传入上下文对象指定线程无效，仅C++对象的槽函数能通过信号槽机制切换线程。

最小复现示例 #

main()函数

int main(int argc, char *argv[]) {
    QCoreApplication a(argc, argv);

    JsThread t;
    t.start();

    return a.exec();
}

TestObj与JsThread类

class TestObj : public QObject {
    Q_OBJECT;

public:
    Q_INVOKABLE void callcpp() {
        qDebug() << QThread::currentThreadId();
    }
};

class JsThread : public QThread {
    Q_OBJECT;

public:
    JsThread(QObject* parent = nullptr) : QThread(parent) {
        timer.start(1000);
    }
protected:
    void run() override {
        QJSEngine engine;
        TestObj obj;

        QJSEngine::setObjectOwnership(&timer, QJSEngine::CppOwnership);
        engine.globalObject().setProperty("mytimer", engine.newQObject(&timer));

        QJSEngine::setObjectOwnership(&obj, QJSEngine::CppOwnership);
        engine.globalObject().setProperty("callcpp", engine.newQObject(&obj).property("callcpp"));

        engine.evaluate("function timerslot() {" 
                         "  callcpp();" 
                         "}" 
                         "" 
                         "mytimer.timeout.connect(timerslot);");

        exec();
    }

private:
    QTimer timer;
};

示例中，timerslot函数实际在主线程（QTimer所属线程）执行，引发QJSEngine线程安全问题。

解决方案 #

方案1：将信号发送对象移至QJSEngine所在线程 #

如果信号发送对象（如示例中的QTimer）可以被迁移到工作线程，直接在QJSEngine所在线程创建或移动该对象，这样信号触发时，JS函数会在同一线程执行，避免跨线程访问。

修改后的JsThread代码：

class JsThread : public QThread {
    Q_OBJECT;

protected:
    void run() override {
        // 在工作线程内创建QTimer，使其属于当前线程（QJSEngine所在线程）
        QTimer timer;
        timer.start(1000);
        
        QJSEngine engine;
        TestObj obj;

        QJSEngine::setObjectOwnership(&timer, QJSEngine::CppOwnership);
        engine.globalObject().setProperty("mytimer", engine.newQObject(&timer));

        QJSEngine::setObjectOwnership(&obj, QJSEngine::CppOwnership);
        engine.globalObject().setProperty("callcpp", engine.newQObject(&obj).property("callcpp"));

        engine.evaluate("function timerslot() {" 
                         "  callcpp();" 
                         "}" 
                         "" 
                         "mytimer.timeout.connect(timerslot);");

        exec();
    }
};

方案2：通过C++代理对象中转信号（适用于无法移动的信号发送对象） #

如果信号发送对象（如网络通信对象）必须留在原线程，可创建一个C++代理对象，利用Qt的跨线程信号槽机制，将信号转发到QJSEngine所在线程，再执行JS函数。

步骤1：定义代理类

class ProxyObj : public QObject {
    Q_OBJECT;
public:
    ProxyObj(QJSEngine* engine, QJSValue jsFunc, QObject* parent = nullptr) 
        : QObject(parent), m_engine(engine), m_jsFunc(jsFunc) {}

public slots:
    void onSignalTriggered() {
        // 在代理对象所在线程（即QJSEngine线程）执行JS函数
        m_jsFunc.call();
    }

private:
    QJSEngine* m_engine;
    QJSValue m_jsFunc;
};

步骤2：修改JsThread的run()方法

void run() override {
    QJSEngine engine;
    TestObj obj;

    // 模拟信号发送对象在主线程（实际场景可能是外部线程的网络对象）
    QTimer timer;
    timer.moveToThread(qApp->thread());
    timer.start(1000);

    QJSEngine::setObjectOwnership(&obj, QJSEngine::CppOwnership);
    engine.globalObject().setProperty("callcpp", engine.newQObject(&obj).property("callcpp"));

    // 预定义JS函数并获取引用
    QJSValue timerslot = engine.evaluate("function timerslot() {" 
                                         "  callcpp();" 
                                         "}");

    // 创建代理对象（代理对象默认在当前工作线程）
    ProxyObj proxy(&engine, timerslot);
    // 使用Qt::QueuedConnection确保槽函数在代理线程（QJSEngine线程）执行
    connect(&timer, &QTimer::timeout, &proxy, &ProxyObj::onSignalTriggered, Qt::QueuedConnection);

    exec();
}

原理说明 #

QJSEngine实例及其创建的JS函数、JS值均绑定到创建它们的线程，不支持跨线程直接访问。当直接将其他线程的信号连接到JS函数时，Qt会在信号发送线程执行该JS函数，违反QJSEngine的线程安全要求。

两种方案的核心都是确保JS函数的执行线程与QJSEngine的创建线程一致：

1. 方案1让信号在QJSEngine线程发送，自然触发同线程的JS函数执行；
2. 方案2通过C++代理中转，利用Qt的跨线程信号槽队列，将JS函数的调用切换到QJSEngine线程。

内容的提问来源于stack exchange，提问作者w.a.r.p