Qt UI线程是什么？为何需在UI线程调用Q_PROPERTY的setter方法

核心原因：Qt QObject的线程亲和性规则 #

• QObject及其子类（包括你的ImageOrientation）都有线程亲和性：每个QObject实例绑定到创建它的线程（这里你的ImageOrientation由QML在Qt UI线程实例化，关联线程为UI线程）。
• Qt硬性要求：所有对QObject的属性修改、信号发送、槽调用，必须在它的关联线程中执行。跨线程直接操作QObject属于未定义行为——当前可能看似正常，但在不同设备、Qt版本或高负载场景下，会触发崩溃、UI更新异常、数据竞争等问题。

你的场景中的具体风险 #

• JNI回调函数Java_com_example_myapplication_MainActivity_setNativeRotation运行在Android的非UI线程（比如Binder线程或Java侧工作线程），并非Qt的UI线程。
• 你直接在这个线程调用setRotation()，相当于跨线程修改QObject的属性并发送rotationChanged信号：
  • 属性m_rotation没有线程保护，多线程同时读写可能导致数据错误。
  • QML的UI渲染和属性绑定依赖UI线程事件循环，非线程安全的信号发送可能引发UI延迟、卡顿甚至崩溃。

修复方案：将调用切换到Qt UI线程 #

修改JNI回调函数，使用QMetaObject::invokeMethod把setRotation()的调用投递到UI线程的事件队列中：

extern "C" {
JNIEXPORT void JNICALL Java_com_example_myapplication_MainActivity_setNativeRotation
    (JNIEnv *, jobject, jint rotation, jlong ptr){

    ImageOrientation* orientation = reinterpret_cast<ImageOrientation*>(ptr);
    int adjustedRotation = rotation;
    if(adjustedRotation == 90)
        adjustedRotation = 270;
    else if(adjustedRotation == 270)
        adjustedRotation = 90;

    // 用队列连接将操作投递到UI线程执行
    QMetaObject::invokeMethod(orientation, [orientation, adjustedRotation]() {
        orientation->setRotation(adjustedRotation);
        qDebug() << adjustedRotation;
    }, Qt::QueuedConnection);
}
}

Qt::QueuedConnection会把lambda内的代码放到UI线程的事件循环中执行，确保所有对ImageOrientation的操作都在它的关联线程（UI线程）中进行，完全符合Qt的线程规则。

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