常见 SPMT 问题和错误疑难解答Troubleshooting common SPMT issues and errors

本文介绍了使用 SharePoint 迁移工具 (SPMT) 时可能遇到的常见问题和错误。This article describes common issues and errors you may encounter when using the SharePoint Migration Tool (SPMT).

备注

有关 SPMT 安装问题的帮助, 请参阅:SPMT 安装问题疑难解答For help on SPMT installation issues, see: Troubleshooting SPMT installation issues

常见错误消息Common error messages

消息Message 具体操作Do this
无法连接到你提供的网站We are unable to connect to the site you provided 请检查该列表是否存在,或你是否可以在计算机的源网站和目标网站中访问它。Check if the list exists or if you can access it in the source site and target site from your computer.

确认你已使用对网站具有访问权限的帐户登录 SPMT。Confirm you have signed into SPMT with an account that has access to the site.

确认你输入的 URL 正确无误,并且采用正确的格式。Confirm the URL you entered is correct and follows the proper format.
例如,https://contoso.sharepoint.com/teams/SiteTitleExample: https://contoso.sharepoint.com/teams/SiteTitle
无效的源文件夹Invalid source folder 确认你输入的路径正确无误,并且采用正确的格式Confirm the path you entered is correct and follows the proper format

确认 SPMT 用户对该文件夹具有读取访问权限Confirm the user of SPMT has read access to the folder
无法创建或更新网站The site cannot be created or updated 确认你有权创建网站,并且该 URL 有效Confirm that you have permissions to create the site and that the URL is valid

如果该网站存在,请确认你是网站集管理员If the site exists, confirm you are the site collection administrator

如果仍然失败,请手动创建网站,并将迁移工具指向此新创建的网站。If it still fails, create the site manually and point the migration tool to this newly created site.
扫描文件失败: 文件夹名称无效Scan file failure: The folder name is invalid 请参阅 OneDrive 和 SharePoint 中的无效文件名和文件类型See Invalid file names and file types in OneDrive and SharePoint
扫描文件失败:目标路径太长Scan file failure: Target path is too long 请参阅 OneDrive 和 SharePoint 中的无效文件名和文件类型See Invalid file names and file types in OneDrive and SharePoint


对于 OneDrive、OneDrive for Business 和 SharePoint,整个路径(包括文件名)包含的字符必须少于 400 个。The entire path, including the file name, must contain fewer than 400 characters for OneDrive, OneDrive, and SharePoint.
扫描文件失败: 磁盘空间不足,无法打包文件Scan File Failure: Not enough disk space to pack the file 可用于迁移工作文件夹的磁盘空间对于源文件大小而言太小。The disk space available for the migration working folder is too small for the size of your source file. 增大工作文件夹的大小,然后重试。Enlarge your size of your working folder try again.
打包失败:无法打开文件Packaging failure: Cannot open file 由于不存在源,打包失败。Packaging failed due to non-existing source. 检查是否可以访问源根文件夹。Check if you can access the source root folder.
已创建重复任务。A duplicate task has already been created. 用于执行批量迁移的 CSV 文件不可具有重复项。The CSV file used to do bulk migration cannot have duplicate entries. 删除重复的行,然后重试。Remove the duplicate line(s) and try again.
未迁移父文件夹The parent folder was not migrated 未迁移父文件夹,因此该文件夹下的所有项都将无法迁移。The parent folder was not migrated, therefore all items under the folder will fail to migrate. 检查父文件夹,然后重试迁移。Check your parent folder and retry your migration.
任务编号,参数 1。源路径应不为空Task #, parameter 1. The source path should not be empty 确认 CSV 文件的源路径列拥有值。Confirm that the source path column in the CSV file has a value.
任务编号,参数 4。目标 URL 是无效的 URLTask #, parameter 4. The target URL is an invalid URL 确认 CSV 文件的目标 URL 列拥有值并且有效。Confirm that the target url column in the CSV file has a value and is valid.
任务编号,参数 5。目标列表应不为空Task #, parameter 5. The target list should not be empty 确认 CSV 文件的目标列表列拥有值。Confirm that the target list column in the CSV file has a value.

SPMT 错误代码SPMT error codes

错误代码Error Code 建议的操作Recommended action
0x0201000D0x0201000D 检查列表是否存在,或能否在源网站和目标网站中访问列表。Check if the list exists or if you can access it in the source site and target site.
0x020500080x02050008 无法访问本地存储。Unable to access your local storage. 请重启迁移。Restart your migration.
0x020100230x02010023 源列表模板不受支持。Your source list template is not supported. 请尝试使用其他模板。Please try another.
0x0201000C0x0201000C 先检查凭据,再重新输入用户名和密码。Check your credentials and then reenter your username and password.
0x020100170x02010017 必须是网站集管理员。You must be a site collection admin.
0x020600090x02060009 1 - 无法创建网站集,因为 URL 已被使用或无效。1 - The site collection cannot be created because the URL is already in use or an invalid URL.
2 - 无法创建网站集,因为 URL 包含无效字符。2 - The site collection cannot be created because the URL contains invalid character.
3 - 无法创建或更新网站集。3 - The site collection cannot be created or updated.
0x020600070x02060007 1 - 无法创建网站集,因为 URL 已被使用或无效。1 - The site collection cannot be created because the URL is already in use or an invalid URL.
2 - 无法创建网站集,因为 URL 包含无效字符。2 - The site collection cannot be created because the URL contains invalid character.
0x020100180x02010018 1 - 先检查凭据,再重试。1 - Check your credentials and then try again.
2 - 无法访问 SharePoint。2 - A problem occurred accessing SharePoint. 请先检查凭据,再重试。Check your credentials and try again.
3 - 无法访问 SharePoint。3 - A problem occurred accessing SharePoint. 请先检查凭据和网络连接,再重试。Check your credentials and your network connection and try again.
4 - 无法访问 SharePoint。4 - A problem occurred accessing SharePoint. 请先检查凭据和网站 URL 是否正确,再重试。Check your credentials and your site URL for accuracy and try again.
5 - 无法访问 SharePoint。5 - A problem occurred accessing SharePoint. 请先检查凭据和 URL 格式,Check your credentials and the format of your URL. 再重试。Retry.
6 - 无法访问 SharePoint。6 - A problem occurred accessing SharePoint. 请先检查凭据,再重试。Check your credentials and try again. 如果此问题一再出现,请创建支持案例。If the problem continues, please create a support case.
7 - 无法访问 SharePoint。7 - A problem occurred accessing SharePoint. 请检查凭据,并尝试在浏览器中打开网站。Check your credentials and try opening your site in a browser.
0x0204000A0x0204000A 无法创建包文件。Cannot create package file. 必须关闭 SPMT 工作文件夹 %appdata%\Microsoft\MigrationToolStorage 中的所有文件和文件夹。All files and folders in the SPMT working folder, %appdata%\Microsoft\MigrationToolStorage, must be closed. 请重启迁移。Restart your migration.
0x020300010x02030001 1 - 检查凭据,1 - Check your credentials. 并重启迁移。Restart your migration.
2 - 检查凭据,2 - Check your credentials. 并重启迁移。Restart your migration.
3 - 检查凭据和网络连接,3 - Check your credentials and your network connection. 并重启迁移。Restart your migration.
4 - 检查凭据和网站 URL,4 - Check your credentials and your site URL. 并重启迁移。Restart your migration.
5 - 检查凭据和 URL 格式,5 - Check your credentials and the format of your URL. 并重启迁移。Restart your migration.
6 - 检查凭据,并重启迁移。6 - Check your credentials and restart your migration. 如果此问题一再出现,请创建支持案例。If this continues, please a support case.
7 - 检查凭据,尝试在浏览器中打开网站,7 - Check your credentials and try opening your site in a browser. 并重启迁移。Restart your migration.
0x020100080x02010008 确认用户映射文件的路径和格式是否正确,以及你是否有权访问此文件。Confirm the path and format of the user mapping file and that you have permission to access it.
0x020500010x02050001 必须关闭 SPMT 工作文件夹 %appdata%\Microsoft\MigrationToolStorage 中的所有文件和文件夹。All files and folders in the SPMT working folder, %appdata%\Microsoft\MigrationToolStorage, must be closed. 请重启迁移。Restart your migration.
0x020100020x02010002 检查网络状态。Check your network status. 如果可以在浏览器中访问源网站,请创建支持案例。If you can access the source sites from a browser, then create a support case.
0x020100100x02010010 确保源列表和目标列表的模板相同。Make sure the source list and target list have the same template.
0x0204000D0x0204000D 在迁移期间,必须关闭 SPMT 工作文件夹 %appdata%\Microsoft\MigrationToolStorage 中的所有文件和文件夹。All files and folders in the SPMT working folder, %appdata%\Microsoft\MigrationToolStorage, must be closed during migration. 请重新开始迁移。Restart your migration.
0x020400120x02040012 本地计算机上的临时存储空间太小。The temporary storage on your local computer is too low. SPMT 会缓存工作文件夹中的包。SPMT caches the package on the working folder. 请扩展临时存储空间,然后重试。Expand your temporary storage and retry.
0x020300030x02030003 具有唯一权限的项过多。There are too many items with unique permissions. 通过减少唯一权限的数目来简化权限列表。Simplify your permissions list by reducing the number of unique permissions. 请重试迁移。Retry your migration.
0x020500010x02050001 本地存储文件已损坏。Local storage file is corrupted. 迁移过程中触碰或修改过工作文件夹。The working folder was touched or modified during the migration. 请重试迁移。Retry your migration.
0x020800010x02080001 包中的文件在上传时已更改或遭删除。The file in the package has been changed or deleted while uploading. 必须关闭 SPMT 工作文件夹 %appdata%\Microsoft\MigrationToolStorage 中的所有文件和文件夹。All files and folders in the SPMT working folder, %appdata%\Microsoft\MigrationToolStorage, must be closed. 请重启迁移。Restart your migration.
0x020100060x02010006 源 SharePoint 网站未定义任何角色定义。The source SharePoint site does not have any defined role definitions. 请检查你的角色在访问源网站时是否存在。Check to see if your role exists when accessing source site.
0x020400090x02040009 无法创建包,因为找不到目录。The package can’t be created because the directory cannot be found. 必须关闭 SPMT 工作文件夹 %appdata%\Microsoft\MigrationToolStorage 中的所有文件和文件夹。All files and folders in the SPMT working folder, %appdata%\Microsoft\MigrationToolStorage, must be closed. 请重启迁移。Restart your migration.
0x020100200x02010020 在 SPMT 设置中禁用迁移版本历史记录,或在 SPO 中启用版本控制。Disable migrating version history in SPMT settings or enable versioning in SPO.
0x0201000E0x0201000E 检查全局设置是否已筛选掉目标路径中的特殊字符,或路径中是否包含不受支持的字符。Check if the global setting has filtered out special characters in the target path or if the path has unsupported characters.
0x020100160x02010016 找不到 SharePoint Server 用户。We are unable to find your SharePoint Server user. 请确保你是网站集管理员。Make sure you are a site collection admin.
0X0201000F0X0201000F 网站 URL 无效。Invalid site URL. 检查网站 URL 是否有效。Check if the site URL is valid. 尝试通过浏览器访问 URL。Try to access the URL via a browser.
0x02070010x0207001 你无权访问任务文件夹。You do not have access to the task folder. 检查是否可以访问 %appdata%\Microsoft\MigrationToolStorage。Check if you can access %appdata%\Microsoft\MigrationToolStorage.
0x014100100x01410010 由于列表项上缺少依赖项而失败。A failure occurred because of missing dependencies on list items. 有关详细信息,请查看 FailureSummaryReport.csv。Check the FailureSummaryReport.csv for details. 检查迁移范围是否已包含依赖项。Check if the dependencies have been included in your migration scope.
0x015100010x01510001 无法上传程序包。Packages failed to upload. 如果已自定义 Azure 存储,请检查是否可以访问 Azure 存储,并检查是否可以访问目标网站。If you have customized Azure Storage, check if you can access the Azure Storage and check if you can access the target site. 再次尝试迁移。Try migrating again.
0x015100010x01510001 无法将作业上传到服务器:迁移期间的文件上传失败。Failed to Upload the Job to Server: Upload file failed during migration.
0x020700090x02070009 无法上传多个程序包。Several packages failed to upload. 暂停任务并检查你的网络连接。Pause the task and check your network connection.
0x017100090x01710009 由于作业结束失败而失败;程序包中的某些项目失败。A failure occurred due to job end failures; some items failed in the package. 重新开始迁移。Restart migration.
0x017100090x01710009 服务器处理文件时出现错误或超时:包中的部分项目尚未迁移。Errors or timeout for Server Processing the file: Not all the items in the package have been migrated.
0x016100010x01610001 Azure 容器已过期。The Azure container is expired. 重试迁移任务。Retry migration task.
0x017100060x01710006 服务器处理文件时出现错误或超时:作业严重错误。Errors or timeout for Server Processing the file: Job Fatal Error.
0x017100040x01710004 服务器处理文件时出现错误或超时。Errors or timeout for Server Processing the file. 查找文件夹名称失败。Fail to look up folder name. 该项目可能存在于同一网站集中的其他列表或网站中。The item may exist in other list or site in the same site collection. 或项目在回收站中。Or the item is in the recycle bin.
0x0131000F0x0131000F 无法读取文件。Failed to Read the file. 文件已签出。File is checked out.
错误Error 原因Reason 操作Action
此导航节点包含无效的 URL:找不到此 URL 指向的对象。This navigation node contains an invalid URL: cannot find the object this URL points to. SharePoint 将在创建导航节点之前验证 URL。SharePoint will validate the URL before it creates the navigation node. 如果此 URL 表示 SharePoint 对象,则无法找到该对象。If the URL represents a SharePoint object and the object cannot be found. SharePoint 将拒绝此错误的节点创建查询。SharePoint will reject the node creation query with this error. 如果 URL 的目标已被删除、移动、尚未迁移、已在上一个任务中迁移(当前作业中无法识别 URL 映射),则可能会发生这种情况。This can happen if the target of the URL was deleted, moved, not migrated yet, migrated in previous task where the URL mapping cannot be recognized in current job. 在多个任务之间使用相同的 URL 映射。Use the same URL mapping between multiple tasks. 例如:For example:

任务 1:http://domain/original_path/site -> http://domain/new_path/siteTask 1:  http://domain/original_path/site -> http://domain/new_path/site

任务 2:http://domain/original_path/site2 -> http://domain/new_path/site2Task 2: http://domain/original_path/site2 -> http://domain/new_path/site2.

运行另一个任务,以迁移指向先前未迁移的对象的导航节点。Run another task to migrate Navigation nodes pointing to objects that were not migrated previously. 已在目标网站中手动创建节点。Manually created the node in target site.
导航设置是高度自定义的设置。The navigation settings are highly customized. 目前它不受支持。Currently it's not supported. 仅当其值与预定义模板匹配时,才能迁移全局站点导航和当前站点导航。Global and current site navigation can only be migrated if its value matches a predefined template. 否则,该值将被视为 高度自定义值 且不会迁移。Otherwise, the value will be recognized as highly customized and won’t get migrated. 更改全局导航和当前导航以使用其中一个预定义模板。Change the global and current navigation to use one of the predefined templates. 请参阅 “站点设置”->“外观”->“导航”See Site settings -> Look and Feel -> Navigation. 手动编辑目标网站上的设置。Manually edit the setting on target site.
无法获取目标术语库 ID。Could not get target Term Store ID. 无法更新 Web 导航设置的分类提供程序。The taxonomy provider of web navigation settings cannot be updated. 由于全局和/或当前站点导航设置设置为“托管导航”,因此,术语存储扫描程序无法获取目标术语库 ID。As the global and/or current site navigation settings is set to “Managed Navigation”, the term store scanner was unable to get the target term store ID. 如果未正确配置托管元数据服务,则会发生这种情况。This can happen if Managed Metadata Services is not properly configured. 有关详细信息,请参阅 SPMT 托管元数据迁移Learn more at SPMT Managed Metadata Migration.
Web 导航设置的分类提供程序术语集 ID 无效。The taxonomy provider term set ID of web navigation settings is invalid. 由于全局或当前站点导航设置现在设置为“托管导航”,因此术语库扫描程序无法映射术语集 ID。As the global or current site navigation settings are set to “Managed Navigation”, the term store scanner could not map the term set ID. 确认源网站上的设置有效,并且已成功迁移术语集。Confirm that the setting on the source site is valid and the term set was successfully migrated.
若要更新 Web 导航设置,需要以下权限:添加和自定义网页。To update web navigation settings, you need following permissions: Add and Customize Pages. 用于迁移的 SharePoint 帐户不具有编辑网站导航设置的权限。The SharePoint account used for migration doesn’t have permission to edit site navigation settings. 向此帐户授予“添加和自定义网页”权限。Grant “Add and Customize Pages” permission to this account.

分类错误Taxonomy errors

错误Error 原因Reason 操作Action
由于权限问题,迁移术语库失败。Migrate term store failed due to permission issue. 当前用户不是术语库管理员。The user is not a term store admin. 在 SharePoint 管理中心,选择“经典功能”,然后在“术语库”下方选择“打开”。In the SharePoint Admin Center, select Classic features, and then under Term store, select Open. 选择要迁移的术语库,然后将当前用户添加为术语库管理员。Select the term store you want to migrate, then add the current user as a Term Store administrator.
由于缺少工作语言,迁移术语库失败。Migrate term store failed due to lack of working languages. 并非所有源术语库的工作语言都存在于目标术语库中。Not all working languages of source term store exist in the target term store. 转到 SharePoint 网站设置。Go to SharePoint site setting. 在“网站管理”下方,选择“术语库管理”。Under Site Administration, select Term store management. 选择要更新的术语库,选择源术语库中存在的所有语言并将其添加到目标工作语言面板。Select the term store you want to update, select, and add all the languages existing in source term store to the target working language panel.
由于默认术语库不存在,迁移术语库失败。Migrate term store failed due to default term store does not exist. 本地 SP 上没有默认的网站集术语库。There isn't a default site collection term store at SP on-prem. 转到 SharePoint Server(本地)管理中心,在“应用程序管理”下方管理服务应用程序,编辑 Managed Metadata Service 连接的属性。Go to SharePoint Server (on-premises) Central Administration, manage service application under Application Management, edit the properties of Managed Metadata Service Connection. 选择“此服务应用程序是列特定术语集的默认存储位置”。Select the This service application is the default storage location for column specific term sets.
由于存在多个默认术语库,迁移术语库失败。Migrate term store failed due to several default term stores exist. 本地 SP 上存在多个默认网站集术语库。There are several default site collection term stores existing at SP on-prem. 转到 SharePoint OnPrem 管理中心,在“应用程序管理”下方管理服务应用程序,选择一个 Managed Metadata Service 连接作为默认术语库。Go to SharePoint OnPrem Central Administration, manage service application under Application Management, choose one Managed Metadata Service Connection as default term store. 取消选择其他 Managed Metadata Service 连接的“此服务应用程序是列特定术语集的默认存储位置”。Deselect This service application is the default storage location for column specific term sets of other Managed Metadata Service Connections.
由于其源术语不存在,迁移固定术语失败。Migrate pinned term failed due to its source term does not exist. 在某些情况下,固定术语位于全局术语集内(适用于连接到此 Managed Metadata Service 应用程序的所有网站),并且源术语位于本地术语集内(适用于此网站集的用户)。In some cases, the pinned term is in global term set (available for all sites connecting to this Managed Metadata Service Application), and the source term is in local term set (available for users of this site collection). 由于 SPMT 将先迁移全局术语,然后迁移本地术语,因此在尝试创建固定术语时,源术语尚未迁移。Because SPMT will migrate the global terms first, then migrate the local ones, when trying to create the pinned term, the source term has not been migrated yet. 重新迁移,将第二次创建固定术语,因为之前已迁移源术语。Migrate again, and the pinned term will be created for the second time, as the source term has been migrated before.

Web 部件错误Web part errors

错误Error 原因Reason 操作Action
不支持迁移的 Web 部件Migration not supported web part 目前,SPMT 不支持此 Web 部件。Currently, SPMT does not support this web part. 查看目前支持的 Web 部件列表:SPMT 支持的 Web 部件Check the list of currently supported web parts: SPMT supported web parts
由于缺少引用列表,迁移失败Migration failed due to referring list is missing 该列表尚未添加到任务列表中。The list has not been added to the task list. 检查 Web 部件和引用列表,确保其处于迁移范围内。Check your web part and the referring list to ensure it is in your migration scope.
由于页面已被自定义,迁移失败Migration failed due to page being customized SPMT 目前不支持迁移自定义页面。SPMT currently does not support customized page migration. 使用 SharePoint Designer 还原页面的模板页面并重新启动迁移。Restore the page’s template page by using SharePoint Designer and restart your migration.
由于页面迁移失败,迁移失败Migration failed due to page migration failed 无法迁移页面以及该页面上的所有 Web 部件。Migration of the page failed, and all the web parts on that page. 再次尝试迁移失败的页面。Retry migrating the failed page. 如果页面迁移成功,则该页面上的所有 Web 部件都将成功迁移。If the page succeeds, then all the web parts on that page will successfully migrate.
由于 Web 部件不安全,并且服务器设置为“NoScript”,迁移失败Migration failed due to it is an unsafe web part and the server setting ‘NoScript’ 在目标 SharePoint 网站中启用“NoScript”设置后,Web 部件将被认为不安全,因为它们可以执行 JavaScript 脚本或其他代码。When the setting NoScript is turned on in the target SharePoint site, the web parts are considered to be unsafe as they could have the ability to execute JavaScript scripts or other code. 系统将阻止迁移 Web 部件。Web parts will be blocked from migrating. 在目标 SharePoint 网站上关闭“NoScript”设置,以便取消阻止这些 Web 部件。Turn off the NoScript setting on the target SharePoint site so that these web parts will be unblocked. 重要说明:如果关闭此设置,你的网站可能会面临风险。Important: Your site may be at risk if you turn off the settings. 有关详细信息,请参阅此链接。See this link for more info.
由于 XML 定义无效,迁移失败Migration failed due to invalid XML definition XsltListView Web 部件和 ListView Web 部件包含 XML 定义,它对于迁移这些 Web 部件至关重要。The XsltListView web part and ListView web part contain an XML definition that is critical for the migration of these web parts. 有时,升级问题或服务器错误会导致 XML 定义无效。Sometimes the XML definition is invalid because of upgrading issues or server errors. 从 SharePoint Server 源页面中删除失败的 Web 部件。Delete the failed web part from the SharePoint Server source page. 重新添加它并再次尝试迁移。Re-add it and try the migration again.
由于程序集名称无效,迁移失败Migration failed due to invalid assembly name Web 部件的程序集名称对 SPMT 迁移 Web 部件至关重要。The assembly name of the web part is critical for SPMT to migrate the web part. 如果无法从其 SOAP 响应中分析 Web 部件的程序集,则迁移将失败。If the assembly of the web part cannot be parsed from its SOAP response the migration fails. 检查此 Web 部件是否为受支持的“开箱即用”(OOTB) Web 部件。Check whether this web part is a supported “out-of-the box” (OOTB) web part. 如果它受支持,请提交 bug 报告,我们将进行调查。If it is supported, please file a bug and we will investigate. 但是,如果是第三方 Web 部件,则它不受支持。However, if is a third-party web part, it is not supported.
由于 Web 部件连接失败,迁移失败。Migration failed due to web part connection failure. 该 Web 部件连接到另一个无法迁移的 Web 部件,导致两者都失败。The web part is connected to another web part that failed to migrate, causing both to fail. 确保已成功迁移连接的 Web 部件。Make sure the connected web part is migrated successfully. 请重试迁移。Retry your migration.
由于无法映射用户,迁移失败Migration failed due to unable to map user 如果“用户”字段是 Web 部件的属性,则 SPMT 会尝试将源 Web 部件上的用户(通常是本地用户)映射到目标 SharePoint 网站上的用户。If the User field is a property of the web part, SPMT will attempt to map the user on the source web part (usually an on-premises user) to a user on the target SharePoint site. 当 SPMT 无法映射到用户时会发生此错误。This error occurs when SPMT cannot map to the user. 确认已使用 Azure Active Directory 将所有本地用户同步到 SharePoint。Confirm that Azure Active Directory is used to sync all on-premises users to SharePoint. 有关详细信息,请参阅此链接。See this link for more info.