Qt新信号槽语法适配问题：编译器选择错误重载函数

我完全懂你遇到的这个坑——从旧的const char*信号语法切换到QMetaMethod参数的新语法后，编译器误选了connect函数的重载，导致信号槽连接失效。这本质是因为QObject::connect有多个重载版本，当传入QMetaMethod类型的信号时，编译器没法自动判断你要连接到成员函数槽的那个重载。

问题根源分析 #

之前用const char*版本时，对应的重载签名辨识度极高：

QMetaObject::Connection connect(const QObject *sender, const char *signal,
                                const QObject *receiver, const char *method,
                                Qt::ConnectionType type = Qt::AutoConnection)

编译器根本不会和其他重载混淆。但换成QMetaMethod参数后，存在一个接收两个QMetaMethod参数的重载（信号和槽都用QMetaMethod表示），还有模板版本的重载，编译器很容易匹配到错误的分支。

修正后的代码方案 #

你需要明确给编译器指明要使用的重载版本，最直接的方式是把槽函数也转换成QMetaMethod对象，精准匹配正确的重载：

#include <QMetaMethod>

class SignalWaiter : public QObject { 
    Q_OBJECT 
public: 
    SignalWaiter(const QObject* sender, const QMetaMethod &signal); 
private slots: 
    void signalCaught(); 
}; 

SignalWaiter::SignalWaiter(const QObject* sender, const QMetaMethod &signal) { 
    // 将槽函数转换为QMetaMethod对象
    QMetaMethod slotMethod = QMetaMethod::fromMethod(&SignalWaiter::signalCaught);
    // 调用接收两个QMetaMethod参数的connect重载
    QObject::connect(sender, signal, this, slotMethod);
}

如果你更偏爱类型安全的函数指针语法（还能避免手动处理QMetaMethod），可以调整构造函数参数为信号的函数指针：

// 假设目标信号是无参类型，比如void SomeSender::targetSignal()
template<typename SignalFunc>
SignalWaiter(const QObject* sender, SignalFunc signal) { 
    QObject::connect(sender, signal, this, &SignalWaiter::signalCaught);
}

这种方式不仅能让编译器自动匹配正确的模板重载，还能在编译期就检查信号和槽的参数是否兼容，减少运行期问题。

额外小提示 #

如果担心信号和槽的签名不匹配，可以加个简单的运行期检查：

// 验证返回值和参数类型是否一致
if (signal.returnType() != slotMethod.returnType() || 
    signal.parameterTypes() != slotMethod.parameterTypes()) {
    qWarning() << "信号与槽签名不匹配！";
}

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