Qt如何在DLL与可执行文件间管理QObject类并解决LNK链接错误

• QObject子类没有使用次数限制，该错误和使用次数无关，完全是动态库符号导出导入的配置错误导致的。
• 最常见的触发原因是多个动态库共用了同一个导出宏：你当前的DLL_DECL_SPEC宏依赖DLL_DECL编译标记，编译DLL1时会定义DLL_DECL，所以Class1被正确标记为导出符号，主程序链接DLL1时可以正常找到Class1的所有符号；但如果编译DLL2时也定义了DLL_DECL标记（比如DLL2自己的导出逻辑也复用了这个同名宏），那么DLL2编译时引入Class1头文件，DLL_DECL_SPEC会被解析为导出标记而非导入标记，导致DLL2会尝试在自身模块内查找Class1的静态成员（包括Q_OBJECT宏生成的staticMetaObject），最终触发未定义符号错误。
• 小概率原因是CMake链接配置的作用域错误，DLL2对DLL1的链接没有用PUBLIC声明，导致符号没有被正确传递到DLL2的编译上下文。

1. 拆分各动态库的专属导出宏，不要共用同一个宏定义：
   DLL1的导出宏改为专属版本：

   #if defined(DLL1_DECL)
   #define DLL1_DECL_SPEC Q_DECL_EXPORT
   #else
   #define DLL1_DECL_SPEC Q_DECL_IMPORT
   #endif
   

   DLL2的导出宏用独立的专属版本：

   #if defined(DLL2_DECL)
   #define DLL2_DECL_SPEC Q_DECL_EXPORT
   #else
   #define DLL2_DECL_SPEC Q_DECL_IMPORT
   #endif
   

   对应修改类的声明：

   // Class1声明
   class DLL1_DECL_SPEC Class1: public QObject
   {
       Q_OBJECT
       // ... 其余逻辑
   };
   
   // Class2声明
   class DLL2_DECL_SPEC Class2: public QObject
   {
       Q_OBJECT
       // ... 其余逻辑
   };
   

2. 修改CMake配置，给每个动态库单独加私有编译定义，避免宏冲突：

   # 仅在编译DLL1时定义DLL1_DECL
   target_compile_definitions(DLL1 PRIVATE DLL1_DECL)
   # 仅在编译DLL2时定义DLL2_DECL
   target_compile_definitions(DLL2 PRIVATE DLL2_DECL)
   # DLL2公开链接DLL1，保证符号正确传递
   target_link_libraries(DLL2 PUBLIC DLL1)
   # 主程序链接两个动态库
   target_link_libraries(Main PRIVATE DLL1 DLL2)
   

3. 完全删除build目录的编译缓存（包括自动生成的moc文件），重新执行CMake生成和编译流程，避免旧缓存的脏数据干扰。

内容的提问来源于stack exchange，提问作者Tx.Yang