使用新版数据迁移服务设置和迁移电子邮件数据时，您可能会遇到一些问题，本文介绍了解决方法。
本页内容
如需了解 Exchange Online 电子邮件迁移，请参阅排查 Exchange Online 电子邮件迁移（Beta 版）问题。
排查从 Google Workspace 迁移数据时遇到的问题
如果您在从 Google Workspace 迁移电子邮件数据时遇到问题，请先按照如下步骤排查。
1. 检查超级用户的电子邮件地址
请确保您输入了来源网域的 Google Workspace 超级用户的正确且有效的电子邮件地址。
如果您在尝试访问授权请求时收到错误消息，则表示电子邮件已发送给来源网域中的非超级用户。如需解决此问题，请在目标网域的 Google 管理控制台中点击断开连接，然后使用来源账号的有效超级用户电子邮件地址创建新连接。如需了解详情，请参阅请求授权。
2. 确认超级用户已表示同意
如果您是来源账号的超级用户，并且需要验证您是否已同意授权，请执行以下操作：
- 前往来源账号中的“全网域委托”设置。
检查“数据迁移（新）”是否被列为客户端。
如需详细了解全网域委托，请参阅使用全网域授权功能控制 API 访问权限。
如果没有作为客户端列出，请点击通过授权请求电子邮件发送的同意链接进行授权。
如果客户端 ID 条目缺失或者您找不到授权请求电子邮件，请退出迁移并为来源账号重新授权。
如需了解详情，请参阅请求授权。
3. 检查电子邮件链接是否有效
授权同意链接将在 24 小时后过期。如果来源账号的超级用户未在该时间范围内表示同意，请点击重新发送电子邮件，向其发送刷新后的链接。
排查从 IMAP 服务器迁移时遇到的问题
1. 检查与 IMAP 服务器的连接
- 请确保 IMAP 服务器托管在端口 993 上，并且连接到 Google IP 地址范围。
- 请确认 IMAP 服务器使用 IMAP over SSL (IMAPS)。
2. 检查用户凭据
请确保输入的是来源用户的正确用户名和密码。如果您要从使用应用专用密码进行身份验证的 IMAP 服务器迁移数据，请在迁移映射中使用应用专用密码。有关详情，请参阅创建和上传迁移映射信息。
3. 验证用户现有的 IMAP 连接数量
如果用户已有 IMAP 连接，有可能会发生 IMAP 服务器连接数量达到上限的情况，此时就无法连接新版数据迁移服务。如需进行问题排查，请移除用户的其他 IMAP 连接，然后重试。
排查从单个用户的 Gmail 账号迁移时遇到的问题
如果您在从 Gmail 账号迁移单个用户的数据时遇到问题，请先按照如下步骤排查。
1. 检查用户的电子邮件地址
请确保您输入的 Gmail 地址正确且有效。此 Gmail 地址可以是个人用户的电子邮件地址，也可以是您 Google Workspace 账号下的用户电子邮件地址。
如果您尝试从其他 Google Workspace 账号迁移用户的 Gmail 数据，请按照从 Google Workspace 账号迁移电子邮件中介绍的步骤操作。
2. 验证用户是否已同意迁移
在 Google 管理控制台中，点击验证授权，并确保您收到已连接通知，这表示连接已获授权。如果用户拒绝了请求，您会收到授权遭拒消息。
如果用户在批准请求后又拒绝了该请求，连接会从已连接状态切换为授权遭拒状态。在这种状态下，您将无法开始迁移。如果用户在迁移已在进行期间撤消同意，迁移最终会停止，并且迁移报告会显示错误，指出用户拒绝了授权请求。
3. 检查电子邮件链接是否有效
授权同意链接将在 24 小时后过期。如果来源账号的用户未在该时间范围内表示同意，请点击重新发送电子邮件，向其发送刷新后的链接。
4. 确保应用访问权限未受限制
如果要在您的 Google Workspace 账号下的两位用户之间迁移 Gmail 数据，而来源用户的账号因违反贵组织的政策被屏蔽，并因此无法同意迁移，则“数据迁移（新）”应用可能会被屏蔽。如需解决此问题，请确保“数据迁移（新）”在“应用访问权限控制”中列为受信任的应用。如需了解详情，请参阅控制哪些第三方应用和内部应用可以访问 Google Workspace 数据。
注意：“数据迁移（新）”的应用 ID 为 375035952210-rgm6j1o8apj8smnt390s0sqp3g3a6ksj.apps.googleusercontent.com。
常规问题排查帮助
上传地图时出错
如果您设置从 Google Workspace 进行迁移，则在上传迁移映射信息时可能会收到以下错误之一：
| 错误消息 | 问题排查步骤 |
|---|---|
| 条目已经存在 | 您多次添加了来源电子邮件地址。检查迁移映射信息中是否存在重复的源用户（可以多次列出目标用户）。 |
| 必须设置目标 Gmail 账号实体 | 缺少目标电子邮件地址。请检查 CSV 文件中是否缺少目标用户。 |
| Gmail 账号实体的电子邮件 ID 必须已设置且必须有效 | 请确保文件中的电子邮件地址已设置，且使用有效的电子邮件地址格式。 |
迁移未能开始
请确保目标网域超级用户启动了迁移。新版数据迁移服务需要超级用户权限，因为在开始迁移数据之前，此服务会在目标网域中授予全网域授权。
迁移完成，但存在失败内容
点击导出迁移报告，然后使用该报告确定未能迁移的内容及其失败原因。如需了解详情，请参阅了解电子邮件迁移报告。
解决问题，然后运行增量迁移。
缺少消息
如果您在迁移后找不到某些邮件，请按照下面的问题排查步骤操作。
第 1 步：确保没有错误标记邮件
从源账号获取缺失邮件的邮件 ID。
如需详细了解如何查找邮件 ID，请参阅通过完整标头跟踪电子邮件。
在目标账号中，使用 Gmail 搜索运算符 rfc822msgid: 搜索该邮件 ID。
如需详细了解如何使用搜索运算符，请参阅在 Gmail 中优化搜索结果。
如果找不到相应邮件，请继续执行下一步。
第 2 步：查看迁移报告
- 导出迁移报告。如需了解详情，请参阅导出报告。
- 使用邮件 ID 搜索缺失的邮件。
- 如果邮件在报告中显示为失败，请参阅解决常见错误消息所对应的问题，找到对应的错误代码。
- 按照说明排查错误消息对应的问题。
迁移标签时出错
如果您在迁移标签时收到错误消息，可能是因为遇到了以下问题：
- 对于从 Google Workspace 或 Google 账号（例如个人 Gmail 账号）进行的迁移，系统会迁移与标签关联的邮件，但该邮件会处于警告状态。
- 对于从 IMAP 服务器进行的迁移，如果父标签未迁移，系统会跳过相应邮件。
- 如果源账号包含超过 6,000 个标签，则需要进行增量迁移。
如需排查问题，请尝试运行增量迁移。如果问题仍然存在，请执行以下操作：
- 选择相应选项：
- 解决标签问题。如需排查标签问题，请参阅了解电子邮件迁移报告。
- 移除标签。
- 运行增量迁移。
退出迁移失败
在尝试断开用户连接或退出 Gmail 迁移时，您可能会遇到“退出迁移失败。请重试”的错误。检查 Gmail 源账号，如果该账号已中止或删除，请前往恢复已暂停的用户。