使用托管SP站点本地工作台加载Image Carousel WebPart遇组件加载失败求助

针对你遇到的Manifest not found for component id "0d910c1c-13b9-4e1c-9aa4-b008c5e42d7d" and version "16.14.0"错误，提供以下解决步骤：

• 检查依赖版本匹配性
  这个组件ID对应@pnp/spfx-controls-react里的ImageCarousel控件，其版本号与SPFx核心库版本对齐。打开项目根目录的package.json，确认@microsoft/sp-core-library、@microsoft/sp-webpart-base的版本，确保@pnp/spfx-controls-react的版本与之一致。如果版本不匹配，执行如下命令安装对应版本的控件包：

  npm install @pnp/spfx-controls-react@<你的SPFx核心版本号>
  

  例如你的SPFx核心版本是1.14.0，就执行npm install @pnp/spfx-controls-react@1.14.0

• 清理缓存并重新构建项目

  1. 停止当前运行的gulp serve（按Ctrl+C）
  2. 删除项目下的node_modules文件夹、package-lock.json文件
  3. 执行npm install重新安装所有依赖
  4. 执行gulp clean清理构建缓存
  5. 重新运行gulp serve

• 确认控件Manifest注册配置
  检查项目config/config.json中的externals节点，确保包含如下配置（如果没有则手动添加）：

  "@pnp/spfx-controls-react": "node_modules/@pnp/spfx-controls-react/lib/index.js"
  

  通常安装控件包时会自动配置，但手动修改过配置的话需要确认这一点。

• 验证站点SPFx运行时兼容性
  托管SP站点的工作台需要支持对应版本的SPFx运行时。16.14.0对应SPFx v1.14版本，若站点不支持该版本，可选择：

  • 降级项目的SPFx版本到站点兼容的版本
  • 联系管理员升级站点的SPFx运行时环境

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