在QMetaObject::invokeMethod中用QString做Q_ARG参数出现匹配错误如何解决？

问题原因 #

报错的核心是Q_ARG宏对参数类型的强匹配要求：Q_ARG(Type, value)要求value的类型必须和Type完全一致，不允许隐式类型转换。Q_ARG内部会直接取参数的地址绑定到Type&引用，不匹配的类型即使支持隐式转换，生成的临时对象也无法绑定到非const左值引用，因此触发编译匹配失败。
结合错误日志的参数类型提示，大概率是两种场景导致的：要么代码中引入了using namespace std::string_literals;将字符串字面量推导为std::string，要么你传入的参数本身就是std::string类型，两种场景都无法和Q_ARG第一个参数声明的QString直接匹配。

可行解决方案 #

• 方案1：显式构造QString对象传入，避免隐式转换
  把Q_ARG的第二个参数替换为显式构造的QString实例，推荐用QStringLiteral宏减少运行时构造开销：

  QMetaObject::invokeMethod(
      mReceiver, 
      "setname", 
      Qt::QueuedConnection, 
      Q_ARG(QString, QStringLiteral("test")));
  

  如果参数本身是std::string类型，用QString::fromStdString转换即可：

  std::string name = "test";
  QMetaObject::invokeMethod(
      mReceiver, 
      "setname", 
      Qt::QueuedConnection, 
      Q_ARG(QString, QString::fromStdString(name)));
  

• 方案2：使用Qt5新增的函数指针版invokeMethod（推荐）
  这种写法不需要手动写Q_ARG宏，编译期会自动检查槽函数和参数的类型匹配，支持正常的隐式类型转换，代码更简洁安全，也不存在类型匹配问题：

  // 把ReceiverClass替换为mReceiver实际所属的类名即可
  QMetaObject::invokeMethod(mReceiver, &ReceiverClass::setname, Qt::QueuedConnection, "test");
  

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