本文介绍了使用 SharePoint 迁移工具 (SPMT) 时可能遇到的常见问题和错误。
注意
有关 SPMT 安装问题的帮助，请参阅： 排查 SPMT 安装问题。
常见错误消息
| 邮件 | 建议的操作 |
|---|---|
| 无法连接到你提供的网站 | 请检查该列表是否存在，或你是否可以在计算机的源网站和目标网站中访问它。
确认你已使用有权访问站点的帐户登录到 SPMT。 确认输入的 URL 正确并遵循正确的格式。 示例：<垃圾邮件><>https://< 垃圾邮件><>contoso.sharepoint.com/teams/SiteTitle<垃圾邮件><> |
| 无效的源文件夹 | 确认输入的路径正确，并遵循正确的格式 确认 SPMT 的用户对文件夹具有读取访问权限。 |
| 无法创建或更新网站 | 确认你有权创建网站，并且 URL 有效。
如果网站存在，请确认你是网站集管理员。 如果仍然失败，请手动创建站点，并将迁移工具指向此新创建的站点。 |
| 扫描文件失败: 文件夹名称无效 | 请参阅 OneDrive 和 SharePoint 中的无效文件名和文件类型。 |
| 扫描文件失败：目标路径太长 | 请参阅 OneDrive 和 SharePoint 中的无效文件名和文件类型。
对于 OneDrive、OneDrive for Business 和 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 设置中禁用迁移版本历史记录或在 Microsoft 365 的 SharePoint 中启用版本控制。 |
| 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/sitedomain/original_path/site -> http:// 任务 2：http://。 domain/new_path/site2domain/original_path/site2 -> http:// 运行另一个任务来迁移指向以前未迁移的对象的导航节点。 已在目标网站中手动创建节点。 |
| 导航设置是高度自定义的设置。 目前它不受支持。 | 仅当其值与预定义模板匹配时，才能迁移全局站点导航和当前站点导航。 否则，该值被识别为 高度自定义 且不会迁移。 | 更改全局导航和当前导航以使用其中一个预定义模板。 请参阅 网站设置 -> 外观 -> 导航。 手动编辑目标网站上的设置。 |
| 无法获取目标术语库 ID。 无法更新 Web 导航设置的分类提供程序。 | 由于全局和/或当前网站导航设置设置为“托管导航”，因此术语库扫描程序无法获取目标术语库 ID。 如果未正确配置托管元数据服务，术语库扫描程序将无法获取目标术语库 ID。 | 有关详细信息，请参阅 SPMT 托管元数据迁移。 |
| Web 导航设置的分类提供程序术语集 ID 无效。 | 由于全局或当前网站导航设置设置为“托管导航”，因此术语库扫描程序无法映射术语集 ID。 | 确认源网站上的设置有效，并且已成功迁移术语集。 |
| 若要更新 Web 导航设置，需要以下权限： 添加和自定义页面。 | 用于迁移的 SharePoint 帐户不具有编辑网站导航设置的权限。 | 授予对此帐户的“添加和自定义页面”权限。 |
分类错误
| 错误 | Reason | 操作 |
|---|---|---|
| 由于权限问题，迁移术语库失败。 | 用户不是术语库管理员。 | 在 SharePoint 管理中心，选择“经典功能”，然后在“术语库”下方选择“打开”。 选择要迁移的术语库，然后将当前用户添加为术语库管理员。 |
| 由于缺少工作语言，迁移术语库失败。 | 并非所有源术语库的工作语言都存在于目标术语库中。 | 转到 SharePoint 网站设置。 在“网站管理”下方，选择“术语库管理”。 选择要更新的术语库，选择源术语库中存在的所有语言并将其添加到目标工作语言面板。 |
| 由于默认术语库不存在，迁移术语库失败。 | 本地 SharePoint Server 没有默认网站集术语库。 | 转到 SharePoint Server 的管理中心站点，在“应用程序管理”下管理服务应用程序，并编辑托管元数据服务连接的属性。 选择“ 此服务应用程序是列特定术语集的默认存储位置 ”选项。 |
| 由于存在多个默认术语库，迁移术语库失败。 | 本地 SharePoint 中存在多个默认网站集术语库。 | 转到 SharePoint Server 的管理中心站点，在“应用程序管理”下管理服务应用程序，并选择一个托管元数据服务连接作为默认术语库。 在其他托管元数据服务Connections中，取消选择“此服务应用程序是列特定术语集的默认存储位置”选项。 |
| 由于其源术语不存在，迁移固定术语失败。 | 在某些情况下，固定术语位于全局术语集内（适用于连接到此 Managed Metadata Service 应用程序的所有网站），并且源术语位于本地术语集内（适用于此网站集的用户）。 SPMT 首先迁移全局术语，然后迁移本地术语。 如果源术语位于本地集中，而固定的术语位于全局集中，则不会在 SPMT 尝试迁移固定的全局术语之前迁移本地源术语。 | 由于源本地术语已在上一作中迁移，因此请再次迁移以包含固定的全局术语。 |
Web 部件错误
| 错误 | Reason | 操作 |
|---|---|---|
| 不支持迁移的 Web 部件 | 目前，SPMT 不支持此 Web 部件。 | 检查当前支持的 Web 部件列表： SPMT 支持的 Web 部件。 |
| 由于缺少引用列表，迁移失败 | 该列表不会添加到任务列表。 | 通过检查 Web 部件和引用列表，确保 Web 部件在迁移范围内。 |
| 由于页面已被自定义，迁移失败 | SPMT 目前不支持自定义页面迁移。 | 使用 SharePoint Designer 还原页面的模板页面并重新启动迁移。 |
| 由于页面迁移失败，迁移失败 | 无法迁移页面以及该页面上的所有 Web 部件。 | 再次尝试迁移失败的页面。 如果页面成功，则该页面上的所有 Web 部件都会成功迁移。 |
| 由于 Web 部件不安全，并且服务器设置为“NoScript”，迁移失败 | 在目标 SharePoint 网站中启用“NoScript”设置后，Web 部件将被认为不安全，因为它们可以执行 JavaScript 脚本或其他代码。 阻止 Web 部件迁移。 | 关闭目标 SharePoint 网站上的 NoScript 设置，以便取消阻止这些 Web 部件。 重要提示：如果关闭设置，您的网站可能会面临风险。 有关详细信息，请参阅 允许或阻止自定义脚本。 |
| 由于 XML 定义无效，迁移失败 | XsltListView Web 部件和 ListView Web 部件包含对这些 Web 部件的迁移至关重要的 XML 定义。 有时，升级问题或服务器错误会导致 XML 定义无效。 | 从 SharePoint Server 源页中删除失败的 Web 部件。 再次添加它，然后再次尝试迁移。 |
| 由于程序集名称无效，迁移失败 | Web 部件的程序集名称对 SPMT 迁移 Web 部件至关重要。 如果无法从其 SOAP 响应中分析 Web 部件的程序集，则迁移将失败。 | 检查此 Web 部件是否是受支持的现成 Web 部件。 如果受支持，我们会在提交 bug 时进行调查。 但是，如果 Web 部件是第三方 Web 部件，则不支持它。 |
| 由于 Web 部件连接失败，迁移失败。 | 该 Web 部件连接到另一个无法迁移的 Web 部件，导致两者都失败。 | 确保已成功迁移连接的 Web 部件。 请重试迁移。 |
| 由于无法映射用户，迁移失败 | 如果“用户”字段是 Web 部件的属性，则 SPMT 会尝试将源 Web 部件上的用户 (通常是本地用户) 映射到目标 SharePoint 网站上的用户。 当 SPMT 无法映射到用户时，会发生此错误。 | 确认使用 Microsoft 365 帐户将所有本地用户同步到 SharePoint。 |