QML文件缓存问题：不同构建时间插件调用公共.qrc资源版本异常

核心原因 #

QML引擎的类型注册、单例实例、组件缓存均以模块URI + 类型/单例名称为全局唯一标识，若多个版本的公共组件使用相同的模块URI声明（即qmldir文件首行的module xxx字段一致），首次加载的类型/单例/组件会被全局缓存，后续同标识的组件不会重新加载，就会出现版本串用的问题。

可落地的解决步骤 #

• 第一步：保证每个版本的模块URI唯一
  每个qrc前缀路径下需放置独立的qmldir文件，且qmldir首行的模块名和对应前缀保持一致：
  /Comp1Common/qmldir首行写module Comp1Common，/Comp2Common/qmldir首行写module Comp2Common，不要使用统一的module Common这类重复名称。修改后import Comp1Common和import Comp2Common会被识别为完全独立的模块，类型注册不会互相覆盖。
• 第二步：针对性绕过QML缓存
  若修改模块URI后普通组件仍存在缓存复用问题，可选择以下两种方式之一绕过缓存：
  1. 全局禁用QML缓存：在QML引擎初始化前添加环境变量

     qputenv("QML_DISABLE_DISK_CACHE", "1");
     QQmlApplicationEngine engine;
     

  2. 针对特定资源加无缓存参数：动态加载组件时给URL添加唯一查询参数

     // timestamp可替换为当前插件的构建时间戳，保证每个版本的URL唯一
     QUrl compUrl("qrc:/Comp1Common/Drawer.qml?timestamp=123456");
     

• 第三步：单例隔离处理
  若使用qmldir声明的单例仍有串用问题，可改为C++侧按模块单独注册单例：

  // 注册Comp1模块的单例
  qmlRegisterSingletonType<CommonComp>("Comp1Common", 1, 0, "Comp", [](QQmlEngine*, QJSEngine*) -> QObject* {
      return new Comp1VersionComp();
  });
  // 注册Comp2模块的单例
  qmlRegisterSingletonType<CommonComp>("Comp2Common", 1, 0, "Comp", [](QQmlEngine*, QJSEngine*) -> QObject* {
      return new Comp2VersionComp();
  });
  

• 补充：构建自动化优化
  若插件数量多/构建版本频繁，可在构建脚本中自动生成带插件唯一标识/构建时间戳的qrc前缀，同步修改对应qmldir的module字段和插件内的import语句，无需人工维护每个版本的前缀，避免人为错误。

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