Windows下CMake构建Qt项目：staticMetaObject地址不一致致qobject_cast失败

问题场景 #

在Windows系统中使用CMake构建项目时出现以下异常：

• 主可执行文件通过target_link_libraries(exe PRIVATE dll)链接了某DLL，同时又通过QPluginLoader动态加载该DLL
• 该DLL内QObject子类的staticMetaObject地址，在主exe中获取的与插件实例调用metaObject()返回的地址完全不同
• 直接导致qobject_cast失效，因为Qt元对象系统依赖元对象地址匹配来验证继承关系
• 相同代码用QMake构建则无此问题

核心原因 #

这是Windows下DLL重复加载导致的实例冲突：
主exe链接DLL的导入库后，系统会在exe启动时自动加载该DLL到进程空间；后续QPluginLoader再次加载同一DLL时，Windows默认会创建新的模块实例，导致DLL中的静态变量（包括staticMetaObject）存在两份独立副本。

QMake无此问题是因为Qt的qmake工具针对插件场景做了默认优化：主项目不会直接链接插件DLL的导入库，而是通过纯虚接口交互，从根源避免了重复加载；或自动配置了符号导出、延迟加载等逻辑。

解决方案 #

方案1：避免直接链接插件DLL导入库（推荐） #

如果DLL是Qt插件，遵循Qt插件开发最佳实践：

• 将插件的抽象接口类（继承QObject+纯虚类）放在独立的静态库/头文件中，主exe仅依赖该接口
• 插件DLL实现接口类，并通过Q_PLUGIN_METADATA和Q_INTERFACES暴露
• 主exe启动时不会加载插件DLL，仅当QPluginLoader加载时才会加载，彻底避免重复实例

方案2：启用DLL延迟加载 #

如果必须让主exe链接DLL导入库，通过延迟加载让exe启动时不自动加载DLL，仅在首次调用DLL符号时加载，确保QPluginLoader加载时复用已有的实例：
在CMake中为exe添加配置：

target_link_options(exe PRIVATE
    /DELAYLOAD:your_target_dll_name.dll
)
# 链接延迟加载依赖库
target_link_libraries(exe PRIVATE delayimp.lib)

方案3：复用已加载的DLL实例 #

在调用QPluginLoader::load()前，先检查目标DLL是否已加载，若已加载则直接获取现有实例：

#include <QLibrary>
#include <QPluginLoader>

QString dllPath = "path/to/your_plugin.dll";
QObject* plugin = nullptr;

if (QLibrary::isLibraryLoaded(dllPath)) {
    plugin = QPluginLoader::staticInstance();
} else {
    QPluginLoader loader(dllPath);
    plugin = loader.load();
}

if (plugin) {
    YourInterface* iface = qobject_cast<YourInterface*>(plugin);
    // 后续业务逻辑
}

方案4：修正符号导出配置 #

确保DLL的元对象符号正确导出：

1. DLL项目CMake配置：

add_library(dll SHARED)
# 启用自动导出符号（Qt类需配合宏处理）
set(CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS ON)
# 手动定义导出宏
target_compile_definitions(dll PRIVATE YOUR_DLL_EXPORT)

2. 插件类声明中使用Qt导出宏：

#ifdef YOUR_DLL_EXPORT
#define YOUR_DLL_API Q_DECL_EXPORT
#else
#define YOUR_DLL_API Q_DECL_IMPORT
#endif

class YOUR_DLL_API YourPluginClass : public QObject, public YourInterface
{
    Q_OBJECT
    Q_INTERFACES(YourInterface)
    Q_PLUGIN_METADATA(IID "com.yourdomain.YourInterface" FILE "plugin_metadata.json")
    // 类实现
};

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