SPFx应用添加至SharePoint站点报错：同版本已存在找不到删除项

报错提示：已安装具有相同版本号的此应用的另一个版本。你必须删除该应用以及站点回收站中的对应项才能安装此版本。

操作步骤 #

• 首先连接到目标 SharePoint 站点的PnP PowerShell，命令参考：Connect-PnPOnline -Url <你的站点URL> -Interactive
• 查询站点范围内残留的应用实例，执行命令：Get-PnPApp -Scope Site，在返回结果中找到对应目标应用，记录其Id字段值
• 强制删除残留应用实例，执行命令：Uninstall-PnPApp -Identity <你记录的应用Id> -Scope Site -Force
• 清理站点回收站中UI不可见的隐藏残留项，执行命令：Clear-PnPRecycleBinItem -All -Force 提示：该操作会清空站点所有回收站内容，如有需保留的文件请提前备份
• 验证应用残留是否清除完成，重新执行Get-PnPApp -Scope Site，确认结果中无目标应用后，即可正常上传安装新版本应用

补充说明 #

如果你的应用是租户级部署的场景，将上述所有命令中的-Scope Site参数替换为-Scope Tenant即可，执行租户级操作需要你拥有 SharePoint 全局管理员权限

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