? ? 今天，在Qt編程，碰到一個需要使用invokeMethod方式來獲取函數是否執行成功的情況。
? ? invokeMethod()即可以同步調用，也可以異步調用。若調用者、被調用者，都在同一個線程，則是同步調用；若調用者、被調用者，在不同線程，則是異步調用。
? ? 注意：只有同步調用，才能通過invokeMethod()的返回值，來判斷函數是否執行成功。
? ? 比如，有如下精簡代碼:

//1）業務代碼
class ComWork : public QObject {Q_OBJECT
public:ComWork();signals:void sigSendResult(bool bOK);public slots:void SendCommand(QByteArray by) {qint64 nRet = m_pSerial->write(by);bool bOK = (nRet != -1);if(bOK)m_pSerial->flush();emit sigSendResult(bOK);} private:QSerialPort* m_pSerial;
};//2） 界面邏輯代碼
class ZoomWidget : public QWidget {
public:ZoomWidget (QWidget *parent= NULL);protected slots:void OnRecvCmdResult(bool bOK);private:QThread* m_pThread; //子線程ComWork* m_pWork;bool     m_bResult;
};ZoomWidget ::ZoomWidget (QWidget *parent): QWidget(parent)
{ui.setupUi(this);m_pThread = new QThread(this);m_pWork   = new ComWork();m_pWork->moveToThread(m_pThread); //m_pWork移動到子線程里，語句(a)//連接信號,語句(b)connect(m_pWork,&m_pWork::sigSendResult,this,ZoomWidget::OnRecvCmdResult);
}ZoomWidget::OnRecvCmdResult(bool bOK)
{m_bResult = bOK; //語句(c)qDebug()<<"recv status:"<<bOK;
}// 3）核心調用
ZoomWidget::DoSend()
{//進行調用,語句(d)QMetaObject::invokeMethod(m_pWork, "SendCommand", Qt::QueuedConnection, Q_ARG(QByteArray, sendData));
}

? ? 在Qt中，UI對象必須在主線程。而ZoomWidget是一個QWidtget，屬于UI對象，即ZoomWidget在主線程。
? ? 由語句(a)可知，m_pWork移動到了子線程里，即ZoomWidget與m_pWork不在同一個線程，
則在調用DoSend()函數時，QMetaObject::invokeMethod(m_pWork,…）其實是跨線程調用，也就是異步調用。而異步調用，由于"它不會等待函數是否執行，就直接返回了"，即invokeMethod(,…Qt::QueuedConnection ,)函數，不會等待m_pWork的SendCommand()是否執行，就直接返回，并給出一個返回值，該返回值是無效的。
? ? 如果強制返回，Qt編譯也會報"QMetaMethod::invoke: Unable to invoke methods with return values in queued connections"錯誤。
? ? 但可以通過信號槽的方式，把異步調用的結果(比如語句(b)、語句?)，返回給調用者(比如本例的ZoomWidget)。

? ? 這個 "Unable to invoke methods"的Qt 編譯報錯：

QMetaMethod::invoke: Unable to invoke methods with return values in queued connections

是一個非常常見的運行時錯誤，它的含義是：

你試圖使用 Qt::QueuedConnection（即異步方式）調用一個帶有返回值的方法，而這是 Qt 不支持的。

---

錯誤原因詳解

什么是 Qt::QueuedConnection？

• 它表示方法調用會在目標對象所在的線程中排隊執行（異步調用），而不是立即執行。
• 常用于跨線程通信，比如從子線程調用主線程的 UI 方法。

為什么不能在 Qt::QueuedConnection 中使用帶返回值的函數？

• 因為它是異步調用，調用者不會等待函數執行完成。
• 所以無法通過 Q_RETURN_ARG(...) 拿到函數的返回值。
• Qt 在底層會檢測這一點，并拋出警告或導致返回值無效。

---

示例代碼：錯誤寫法

int result = 0;
bool success = QMetaObject::invokeMethod(obj, "addNumbers",Qt::QueuedConnection, // ? 異步調用Q_RETURN_ARG(int, result),Q_ARG(int, 3),Q_ARG(int, 5));

上面這段代碼會導致報錯：

QMetaMethod::invoke: Unable to invoke methods with return values in queued connections

---

正確做法

? 方法一：使用 Qt::DirectConnection（同步調用）

如果你需要獲取返回值，請使用同步連接方式：

int result = 0;
bool success = QMetaObject::invokeMethod(obj, "addNumbers",Qt::DirectConnection, // ? 同步調用Q_RETURN_ARG(int, result),Q_ARG(int, 3),Q_ARG(int, 5));if (success) {qDebug() << "Result:" << result;
}

?? 注意：Qt::DirectConnection 要求調用線程和目標對象處于同一個線程，否則行為未定義。

---

? 方法二：避免返回值 + 使用信號傳遞結果（適合異步場景）

如果你確實需要跨線程調用并想獲取結果，可以這樣做：

步驟如下：

1. 將原函數改為無返回值；
2. 使用 QMetaObject::invokeMethod() 調用它；
3. 函數內部處理完后，發出一個信號把結果傳回來。

示例代碼：

class Worker : public QObject {Q_OBJECTsignals:void resultReady(int result); // 用于返回結果public slots:void addNumbersAsync(int a, int b) {int result = a + b;emit resultReady(result); // 發送結果}
};

調用方式：

Worker* worker = new Worker();
worker->moveToThread(thread);// 連接信號與槽來接收結果
connect(worker, &Worker::resultReady, this, [](int res) {qDebug() << "異步返回結果：" << res;
});// 異步調用
QMetaObject::invokeMethod(worker, "addNumbersAsync",Qt::QueuedConnection,Q_ARG(int, 3),Q_ARG(int, 5));

---

總結1

場景	是否允許返回值	推薦連接方式	備注
同一線程調用，需返回值	? 是	Qt::DirectConnection	可使用 Q_RETURN_ARG
跨線程調用，需返回值	? 否	? 不可用	必須用信號傳遞結果
跨線程調用，不需要返回值	? 是	Qt::QueuedConnection	正常使用

---

---

QMetaObject::invokeMethod() 的返回值類型

bool QMetaObject::invokeMethod(QObject *obj, const char *member, Qt::ConnectionType type, QGenericReturnArgument ret, ...)

返回值說明：

• 返回類型：bool
• 返回值含義：
  • true：表示方法成功調用。
  • false：表示方法調用失敗，可能原因包括：
    • 沒有找到名字匹配的方法（函數名錯誤或未聲明為 Q_INVOKABLE 或 slot）。
    • 參數類型不匹配。
    • 對象已經被刪除（懸空指針）。
    • 使用了 Qt::QueuedConnection 但目標對象沒有運行事件循環。

---

---

如何進一步排查失敗原因？

雖然返回值只能告訴你是否成功，但你可以通過以下方式定位問題：

1. 檢查函數是否被正確聲明為 Q_INVOKABLE 或 slot

class Worker : public QObject {Q_OBJECTpublic slots:void OpenPort(const QString &portName, int baudRate); // 必須匹配參數類型
};

或者：

Q_INVOKABLE void OpenPort(const QString &portName, int baudRate);

---

2. 確保對象沒有被釋放（避免懸空指針）

確保 m_pWork 是一個有效的 QObject* 指針，且對象尚未被 delete。

---

3. 參數類型必須一致（支持元對象系統）

確保你使用的參數類型是 Qt 元對象系統支持的類型（如 int, QString, double 等），或者自定義類型已注冊：

Q_DECLARE_METATYPE(MyCustomType)
qRegisterMetaType<MyCustomType>();

---

4. 調試輸出所有可用方法（用于排查函數名/參數是否正確）

const QMetaObject* metaObj = m_pWork->metaObject();
for (int i = 0; i < metaObj->methodCount(); ++i) {qDebug() << metaObj->method(i).signature();
}

---

總結2

內容	說明
invokeMethod() 是否有返回值？	? 有，返回 bool 類型
true 表示什么？	方法調用成功
false 表示什么？	方法調用失敗（函數名錯誤、參數不匹配、對象無效、異步調用等）
可以用來做什么？	判斷函數是否被成功調用，用于調試和錯誤處理

---