常见 SPMT 问题和错误疑难解答
本文介绍了使用 SharePoint 迁移工具 (SPMT) 时可能遇到的常见问题和错误。
注意
有关 SPMT 安装问题的帮助, 请参阅:SPMT 安装问题疑难解答
常见错误消息
消息 | 具体操作 |
---|---|
无法连接到你提供的网站 | 请检查该列表是否存在,或你是否可以在计算机的源网站和目标网站中访问它。 确认你已使用有权访问站点的帐户登录到 SPMT。 确认输入的 URL 正确并遵循正确的格式。 示例:<垃圾邮件><>https://< 垃圾邮件><>contoso.sharepoint.com/teams/SiteTitle<垃圾邮件><> |
无效的源文件夹 | 确认输入的路径正确,并遵循正确的格式 确认 SPMT 的用户对文件夹具有读取访问权限。 |
无法创建或更新网站 | 确认您有权创建网站,并且 URL 有效 如果网站存在,请确认您是网站集管理员 如果网站仍然失败,请手动创建网站并将迁移工具指向此新创建的网站。 |
扫描文件失败: 文件夹名称无效 | 请参阅 OneDrive 和 SharePoint 中的无效文件名和文件类型。 |
扫描文件失败:目标路径太长 | 请参阅 OneDrive 和 SharePoint 中的无效文件名和文件类型。 OneDrive、OneDrive 和 SharePoint 的整个路径(包括文件名)必须包含少于 400 个字符。 |
扫描文件失败: 磁盘空间不足,无法打包文件 | 可用于迁移工作文件夹的磁盘空间对于源文件大小而言太小。 增大工作文件夹的大小,然后重试。 |
打包失败:无法打开文件 | 由于不存在源,打包失败。 检查是否可以访问源根文件夹。 |
已创建重复任务。 | 用于执行批量迁移的 CSV 文件不能包含重复条目。 删除重复的行,然后重试。 |
未迁移父文件夹 | 父文件夹未迁移,因此文件夹下的所有项目都无法迁移。 检查父文件夹,然后重试迁移。 |
任务 #,参数 1。 源路径不应为空 | 确认 CSV 文件的源路径列拥有值。 |
任务 #,参数 4。 目标 URL 无效 | 确认 CSV 文件的目标 URL 列拥有值并且有效。 |
任务 #,参数 5。 目标列表不应为空 | 确认 CSV 文件的目标列表列拥有值。 |
将此内容迁移到 OneDrive 需要管理员权限。 | 检查用于迁移内容的帐户是否对目标 OneDrive 具有权限。 |
SPMT 错误代码
错误代码 | 建议的操作 |
---|---|
0x0201000D | 检查列表是否存在,或能否在源网站和目标网站中访问列表。 |
0x02050008 | 无法访问本地存储。 请重启迁移。 |
0x02010023 | 不支持源列表模板。 添加其他模板。 |
0x0201000C | 先检查凭据,再重新输入用户名和密码。 |
0x02010017 | 必须是网站集管理员。 |
0x02060009 | 1 - 无法创建网站集,因为 URL 已在使用中或 URL 无效。 |
2 - 无法创建网站集,因为 URL 包含无效字符。 | |
3 - 无法创建或更新网站集。 | |
0x02060007 | 1 - 无法创建网站集,因为 URL 已在使用中或 URL 无效。 |
2 - 无法创建网站集,因为 URL 包含无效字符。 | |
0x02010018 | 1 - 先检查凭据,再重试。 |
2 - 访问 SharePoint 时出现问题。 请先检查凭据,再重试。 | |
3 - 无法访问 SharePoint。 请先检查凭据和网络连接,再重试。 | |
4 - 无法访问 SharePoint。 请先检查凭据和网站 URL 是否正确,再重试。 | |
5 - 无法访问 SharePoint。 请先检查凭据和 URL 格式, 再重试。 | |
6 - 无法访问 SharePoint。 请先检查凭据,再重试。 如果问题仍然存在,请创建支持案例。 | |
7 - 无法访问 SharePoint。 请检查凭据,并尝试在浏览器中打开网站。 | |
0x0204000A | 无法创建包文件。 必须关闭 SPMT 工作文件夹 %appdata%\Microsoft\MigrationToolStorage 中的所有文件和文件夹。 请重启迁移。 |
0x02030001 | 1 - 检查凭据, 并重启迁移。 |
2 - 检查凭据, 并重启迁移。 | |
3 - 检查凭据和网络连接, 并重启迁移。 | |
4 - 检查凭据和网站 URL, 并重启迁移。 | |
5 - 检查凭据和 URL 格式, 并重启迁移。 | |
6 - 检查凭据,并重启迁移。 如果消息仍然存在,请创建支持案例。 | |
7 - 检查凭据,尝试在浏览器中打开网站, 并重启迁移。 | |
0x02010008 | 确认用户映射文件的路径和格式是否正确,以及你是否有权访问此文件。 |
0x02050001 | 必须关闭 SPMT 工作文件夹 %appdata%\Microsoft\MigrationToolStorage 中的所有文件和文件夹。 请重启迁移。 |
0x02010002 | 检查网络状态。 如果可以在浏览器中访问源网站,请创建支持案例。 |
0x02010010 | 确保源列表和目标列表的模板相同。 |
0x0204000D | 在迁移期间,必须关闭 SPMT 工作文件夹 %appdata%\Microsoft\MigrationToolStorage 中的所有文件和文件夹。 请重启迁移。 |
0x02040012 | 本地计算机上的临时存储空间太小。 SPMT 会缓存工作文件夹中的包。 请扩展临时存储空间,然后重试。 |
0x02030003 | 具有唯一权限的项过多。 通过减少唯一权限的数目来简化权限列表。 请重试迁移。 |
0x02050001 | 本地存储文件已损坏。 迁移过程中触碰或修改过工作文件夹。 请重试迁移。 |
0x02080001 | 包中的文件在上传时已更改或遭删除。 必须关闭 SPMT 工作文件夹 %appdata%\Microsoft\MigrationToolStorage 中的所有文件和文件夹。 请重启迁移。 |
0x02010006 | 源 SharePoint 网站没有任何定义的角色定义。 请检查你的角色在访问源网站时是否存在。 |
0x02040009 | 无法创建包,因为找不到目录。 必须关闭 SPMT 工作文件夹 %appdata%\Microsoft\MigrationToolStorage 中的所有文件和文件夹。 请重启迁移。 |
0x02010020 | 在 SPMT 设置中禁用迁移版本历史记录,或在 SPO 中启用版本控制。 |
0x0201000E | 检查全局设置是否已筛选掉目标路径中的特殊字符,或路径中是否包含不受支持的字符。 |
0x02010016 | 我们无法找到您的 SharePoint Server 用户。 确保你是网站集管理员。 |
0X0201000F | 网站 URL 无效。 检查网站 URL 是否有效。 尝试通过浏览器访问 URL。 |
0x0207001 | 你无权访问任务文件夹。 检查是否可以访问 %appdata%\Microsoft\MigrationToolStorage。 |
0x01410010 | 由于列表项上缺少依赖项而失败。 有关详细信息,请查看 FailureSummaryReport.csv。 检查迁移范围是否已包含依赖项。 |
0x01510001 | 无法上传程序包。 如果已自定义 Azure 存储,请检查是否可以访问 Azure 存储,并检查是否可以访问目标网站。 再次尝试迁移。 |
0x01510001 | 无法将作业上传到服务器:迁移期间的文件上传失败。 |
0x02070009 | 无法上传多个程序包。 暂停任务并检查你的网络连接。 |
0x01710009 | 由于作业结束失败而失败;程序包中的某些项目失败。 重新开始迁移。 |
0x01710009 | 服务器处理文件时出现错误或超时:包中的部分项目尚未迁移。 |
0x01610001 | Azure 容器已过期。 重试迁移任务。 |
0x01710006 | 服务器处理文件时出现错误或超时:作业严重错误。 |
0x01710004 | 服务器处理文件时出现错误或超时。 查找文件夹名称失败。 该项目可能存在于同一网站集中的其他列表或网站中。 或项目在回收站中。 |
0x0131000D | 无法获取所有列表项版本;工具发送请求来提取项版本,但不会返回任何内容。 当公共文件和 .aspx 文件之间的下载链接不同时,可能会发生此错误。 这种情况在 4.x 版本中已修复。 |
0x0131000F | 无法读取文件。 文件已签出。 |
0x0111000A | 扫描文件失败: 文件大小超过限制。 有关当前限制,请参阅 发行说明:SharePoint 迁移工具 (SPMT) 。 |
导航错误
错误 | Reason | 操作 |
---|---|---|
此导航节点包含无效的 URL:找不到此 URL 指向的对象。 | SharePoint 在创建导航节点之前验证 URL。 如果 URL 表示 SharePoint 对象,但找不到该对象,SharePoint 将拒绝创建节点的查询并显示此错误。 如果在当前作业中无法识别 URL 映射的上一个任务中删除、移动、尚未迁移或迁移 URL 的目标,则找不到对象。 | 在多个任务之间使用相同的 URL 映射。 例如: 任务 1:http:domain/new_path/site//domain/original_path/site -> http:// Task 2:http://。 domain/new_path/site2domain/original_path/site2 -> http:// 运行另一个任务来迁移指向以前未迁移的对象的导航节点。 已在目标网站中手动创建节点。 |
导航设置是高度自定义的设置。 目前它不受支持。 | 仅当其值与预定义模板匹配时,才能迁移全局站点导航和当前站点导航。 否则,该值被识别为 高度自定义 ,并且不会迁移。 | 更改全局导航和当前导航以使用其中一个预定义模板。 请参阅 网站设置 -> 外观 -> 导航。 手动编辑目标网站上的设置。 |
无法获取目标术语库 ID。 无法更新 Web 导航设置的分类提供程序。 | 由于全局和/或当前网站导航设置设置为“托管导航”,因此术语库扫描程序无法获取目标术语库 ID。 如果未正确配置托管元数据服务,术语库扫描程序将无法获取目标术语库 ID。 | 有关详细信息,请参阅 SPMT 托管元数据迁移。 |
Web 导航设置的分类提供程序术语集 ID 无效。 | 由于全局或当前网站导航设置设置为“托管导航”,因此术语库扫描程序无法映射术语集 ID。 | 确认源网站上的设置有效,并且已成功迁移术语集。 |
若要更新 Web 导航设置,需要以下权限:添加和自定义网页。 | 用于迁移的 SharePoint 帐户不具有编辑网站导航设置的权限。 | 向此帐户授予“添加和自定义网页”权限。 |
分类错误
错误 | Reason | 操作 |
---|---|---|
由于权限问题,迁移术语库失败。 | 用户不是术语库管理员。 | 在 SharePoint 管理中心,选择“经典功能”,然后在“术语库”下方选择“打开”。 选择要迁移的术语库,然后将当前用户添加为术语库管理员。 |
由于缺少工作语言,迁移术语库失败。 | 并非所有源术语库的工作语言都存在于目标术语库中。 | 转到 SharePoint 网站设置。 在“网站管理”下方,选择“术语库管理”。 选择要更新的术语库,选择源术语库中存在的所有语言并将其添加到目标工作语言面板。 |
由于默认术语库不存在,迁移术语库失败。 | 本地 SP 上没有默认的网站集术语库。 | 转到 SharePoint Server(本地)管理中心,在“应用程序管理”下方管理服务应用程序,编辑 Managed Metadata Service 连接的属性。 选择“此服务应用程序是列特定术语集的默认存储位置”。 |
由于存在多个默认术语库,迁移术语库失败。 | 本地 SP 上存在多个默认网站集术语库。 | 转到 SharePoint OnPrem 管理中心,在“应用程序管理”下方管理服务应用程序,选择一个 Managed Metadata Service 连接作为默认术语库。 取消选择其他 Managed Metadata Service 连接的“此服务应用程序是列特定术语集的默认存储位置”。 |
由于其源术语不存在,迁移固定术语失败。 | 在某些情况下,固定术语位于全局术语集内(适用于连接到此 Managed Metadata Service 应用程序的所有网站),并且源术语位于本地术语集内(适用于此网站集的用户)。 SPMT 将首先迁移全局术语,然后迁移本地术语。 如果源术语位于本地集中,并且固定的术语位于全局集中,则不会在 SPMT 尝试迁移固定的全局术语之前迁移本地源术语。 | 由于源本地术语已在上一操作中迁移,因此请再次迁移以包含固定的全局术语。 |
Web 部件错误
错误 | Reason | 操作 |
---|---|---|
不支持迁移的 Web 部件 | 目前,SPMT 不支持此 Web 部件。 | 检查当前支持的 Web 部件列表: SPMT 支持的 Web 部件。 |
由于缺少引用列表,迁移失败 | 尚未将列表添加到任务列表。 | 检查 Web 部件和引用列表,确保它位于迁移范围内。 |
由于页面已被自定义,迁移失败 | SPMT 目前不支持自定义页面迁移。 | 使用 SharePoint Designer 还原页面的模板页面并重新启动迁移。 |
由于页面迁移失败,迁移失败 | 无法迁移页面以及该页面上的所有 Web 部件。 | 再次尝试迁移失败的页面。 如果页面迁移成功,则该页面上的所有 Web 部件都将成功迁移。 |
由于 Web 部件不安全,并且服务器设置为“NoScript”,迁移失败 | 在目标 SharePoint 网站中启用“NoScript”设置后,Web 部件将被认为不安全,因为它们可以执行 JavaScript 脚本或其他代码。 系统将阻止迁移 Web 部件。 | 关闭目标 SharePoint 网站上的 NoScript 设置,以便取消阻止这些 Web 部件。 重要说明:如果关闭此设置,你的网站可能会面临风险。 有关详细信息,请参阅 允许或阻止自定义脚本。 |
由于 XML 定义无效,迁移失败 | XsltListView Web 部件和 ListView Web 部件包含 XML 定义,它对于迁移这些 Web 部件至关重要。 有时,升级问题或服务器错误会导致 XML 定义无效。 | 从 SharePoint Server 源页中删除失败的 Web 部件。 重新添加它并再次尝试迁移。 |
由于程序集名称无效,迁移失败 | Web 部件的程序集名称对 SPMT 迁移 Web 部件至关重要。 如果无法从其 SOAP 响应中分析 Web 部件的程序集,则迁移将失败。 | 检查此 Web 部件是否为受支持的“开箱即用”(OOTB) Web 部件。 如果受支持,请提交 bug,我们将进行调查。 但是,如果 Web 部件是第三方 Web 部件,则不支持它。 |
由于 Web 部件连接失败,迁移失败。 | 该 Web 部件连接到另一个无法迁移的 Web 部件,导致两者都失败。 | 确保已成功迁移连接的 Web 部件。 请重试迁移。 |
由于无法映射用户,迁移失败 | 如果“用户”字段是 Web 部件的属性,则 SPMT 会尝试将源 Web 部件上的用户(通常是本地用户)映射到目标 SharePoint 网站上的用户。 当 SPMT 无法映射到用户时,会发生此错误。 | 确认Microsoft Entra ID 用于将所有本地用户同步到 SharePoint。 |