Qt6.5.2中QSceneLoader加载GLB文件报错：无合适导入插件

问题详情 #

使用Qt6.5.2版本，通过QSceneLoader加载GLB格式3D模型时触发以下错误：

Qt3DRenderer.SceneLoaders: class Qt3DCore::QEntity *__cdecl Qt3DRender::Render::LoadSceneJob::tryLoadScene(enum Qt3DRender::QSceneLoader::Status &,const class QList &,const class std::function<void __cdecl(class Qt3DRender::QSceneImporter *)> &) Found no suitable importer plugin for QUrl("file:///D:/Work/2023/Box.glb")

已确认Qt安装目录下存在assimpsceneimport.dll、gltfsceneexport.dll、gltfsceneimport.dll等插件，代码可正常加载.dae文件，尝试GLTF 1.0和2.0版本的GLB模型均出现相同错误，运行代码如下：

int main(int ac, char **av)
{
    QApplication app(ac, av);
    Qt3DExtras::Qt3DWindow view;
    view.defaultFrameGraph()->setClearColor(Qt::black);

    // Root entity
    Qt3DCore::QEntity *sceneRoot = new Qt3DCore::QEntity();

    // Scene camera set here

    // Scene loader
    Qt3DCore::QEntity *sceneLoaderEntity = new Qt3DCore::QEntity(sceneRoot);
    Qt3DRender::QSceneLoader *sceneLoader = new Qt3DRender::QSceneLoader(sceneLoaderEntity);
    sceneLoaderEntity->addComponent(sceneLoader);

    QUrl sourceFileName = QUrl::fromLocalFile("D:/Work/2023/Box.glb");
    sceneLoader->setSource(sourceFileName);

    view.setRootEntity(sceneRoot);
    view.show();

    return app.exec();
}

解决方案 #

• 指定插件加载路径：程序运行时可能无法自动定位Qt3D插件目录，手动添加路径：
  在main函数开头加入：

  QCoreApplication::addLibraryPath("你的Qt安装路径/6.5.2/对应编译器架构/plugins");
  

  例如MSVC 64位环境示例：

  QCoreApplication::addLibraryPath("C:/Qt/6.5.2/msvc2019_64/plugins");
  

• 检查插件依赖：gltfsceneimport.dll依赖Qt3D相关核心库，确保这些依赖文件（如Qt3DRender.dll、Qt3DCore.dll）存在于程序运行目录，或系统可搜索到。可使用Dependency Walker工具排查缺失的依赖项。

• 验证GLB文件有效性：用Blender等工具打开GLB文件，确认文件未损坏、格式符合标准。

• 确认项目模块链接：

  • 若使用qmake，确保.pro文件包含：

    QT += 3dcore 3drender 3dextras
    

  • 若使用CMake，确保链接对应模块：

    find_package(Qt6 REQUIRED COMPONENTS 3DCore 3DRender 3DExtras)
    target_link_libraries(你的项目名 PRIVATE Qt6::3DCore Qt6::3DRender Qt6::3DExtras)
    

• 手动注册插件：若自动加载失败，强制注册GLTF导入插件：

  #include <Qt3DRender/QSceneImporter>
  #include <QtPlugin>
  Q_IMPORT_PLUGIN(GLTFSceneImportPlugin)
  

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