常见 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。