GWMME 问题排查

Google Workspace Migration for Microsoft Exchange

如果您在使用 Google Workspace Migration for Microsoft Exchange (GWMME) 时遇到问题,可以使用该产品的测试、报告和日志功能来排查问题。如需详细的帮助信息,请参阅下文中的问题排查部分,了解 GWMME 常见迁移问题的解决办法。

试用日志分析器

此工具在您提交日志后的一段时间内即可确定大部分问题。

您可以在计算机的以下位置找到 GWMME 跟踪日志:C:\Users\*用户名*\AppData\Local\Google\Google Apps Migration\Tracing\ExchangeMigration

如需查看 GWMME 跟踪日志文件的示例,请参阅下文中的查看日志部分。

使用 GWMME 排查问题

GWMME 产品的测试和报告功能可帮助您排查迁移问题。

方法 说明 更多信息
诊断测试 如要找出配置或用户列表方面的问题,请在迁移数据前先运行诊断测试。此实用程序会在发现错误时向您发出提醒,并在输出屏幕上显示相关信息。 GWMME 管理员指南中的“Migrating data”(迁移数据)一章
迁移报告

运行迁移后,请检查迁移报告,了解是否发生了错误、发生错误的原因以及哪些用户受到了影响。

注意:报告数据存储在本地计算机上的 Microsoft Windows 用户配置文件中。只有运行了 GWMME 的 Windows 用户才能查看报告。

GWMME 管理员指南中的“Migration reports”(迁移报告)一章

排查问题

下文就常见的迁移问题提供了具体说明和建议的解决方法供您参考。

解决迁移问题 | 解决迁移失败问题 | 解读错误消息 | Google Workspace 服务与 GWMME

解决迁移问题

无法创建管理员的 Exchange 配置文件

此问题可能由以下原因造成:

  • Exchange 服务器未运行。
  • 网络问题导致客户端计算机与 Exchange 服务器无法连接。如需验证连接,请在客户端计算机上 ping 服务器。
  • 您使用的 Exchange 服务器名称或管理员用户名有误。如要验证此信息,请执行以下操作:
    1. 在客户端计算机上,点击控制面板 然后邮件,为您要用于迁移的管理员账号创建 Microsoft Outlook 配置文件。
    2. 进入 GWMME,在第 1 步“Server Details”(服务器详细信息)屏幕上,执行以下操作:
      • 主机名/IP 地址字段中,输入配置文件中的 Exchange 主机名。
      • Admin username(管理员用户名)字段,输入配置文件中的用户名。

如果您是从托管的服务器迁移数据,则管理员账号的配置文件必须使用默认设置才能连接到服务器。如果您修改了控制面板 然后邮件 然后配置文件名称 然后属性 然后电子邮件账号 然后配置文件名称 然后更改电子邮件账号 然后更多 设置下的任何设置,都会导致连接失败。

Exchange 服务器未能识别我用于迁移的管理员用户名

请确认您输入的管理员用户名和密码正确无误。

如果问题仍然存在,请确认您输入的 Exchange 服务器名称是否正确:

  1. 在客户端计算机上,点击控制面板 然后邮件,为您要用于迁移的管理员账号创建一个 Outlook 配置文件。
  2. 进入 GWMME,在第 1 步“Server Details”(服务器详细信息)屏幕上,执行以下操作:
    • 主机名/IP 地址字段中,输入配置文件中的 Exchange 主机名。
    • Admin username(管理员用户名)字段,输入配置文件中的用户名。

GWMME 启动后很快崩溃

如果 GWMME 在启动后很快崩溃,请确保您是在客户端计算机上运行 GWMME,而不是在 Exchange 服务器上运行 GWMME。在服务器上运行该实用程序会导致其崩溃。有关详情,请参阅相关 Microsoft 文档。

如果您认为 GWMME 可能是由于负载平衡问题而崩溃,请参阅 GWMME 管理员指南中的“Prepare your Windows client machines”(准备 Windows 客户端计算机)一节。

杀毒软件或插件引发的问题

在迁移过程中,计算机上运行的其他进程(例如杀毒、搜索或备份软件)偶尔会打断 GWMME 对数据库文件的访问。如果日志文件包含以下错误代码,则表明发生了这样的问题:

0x80040109
Fail:While stamping the message

虽然邮件已经迁移,但 GWMME 未保存迁移成功这一状态信息。如果重新运行迁移时选中了仅迁移新数据选项,GWMME 就会尝试重新迁移这些邮件。这不会造成邮件重复,但可能会导致日历活动或联系人重复。

解决迁移失败问题

单个用户迁移失败

如果迁移某个用户失败,请确认以下事项:

  • 用户文件中的用户名或 SMTP 地址格式正确。
  • 用户在全局地址列表 (GAL) 中未被隐藏。
  • 用户在 Exchange 服务器上拥有账号。
  • 用户已登录 Google Workspace,接受服务条款并创建好 Google Workspace 账号。

由于 OAuth 错误而导致迁移失败

下列问题排查措施应该可以解决所有的 GWMME OAuth 验证错误:

  • 确保您已按照为您的账号授权 GWMME 中的说明为网域正确授权该软件。
  • 确认 CSV 文件中所列的 Google Workspace 用户和密码正确无误。CSV 文件中出现任何错误都可能导致迁移失败。有关详情,请参阅为迁移创建 CSV 文件
  • 在运行 GWMME 的计算机上,确认系统时钟所设定的时间正确无误。如果计算机的时钟有误差,系统在执行 OAuth 验证检查时会向 Google 服务器发送错误的本地时间戳,进而导致迁移失败。请将您的计算机与互联网时间服务器同步。
  • 确保用于对 GWMME 进行身份验证的 Google Workspace 超级用户账号是有效账号,且 GWMME 配置中输入的用户名正确无误。

由于 Google Workspace 用户不存在而导致迁移失败

GWMME 不会在 Google Workspace 中配置用户。在迁移数据之前,请先创建 Google Workspace 用户账号。

解读错误消息

检查网络或 TLS 问题日志

如果您遇到网络连接错误(例如,网络超时、连接遭拒等)或 SSL/TLS 问题(例如,安全连接问题),则日志会显示该工具尝试连接的 IP 地址。如果存在安全连接问题,日志会显示相关原因(例如,证书名称不符、证书过期、CRL 检查失败等)和证书详细信息(例如,Google 证书或 HTTPS 检查代理)。这样应该能显著减少利用网络捕获排查问题的需要,主日志(文件名为 Trace-*.log)和授权日志(位于“Identity”文件夹中)也同样能发挥相同的作用。

授权日志示例

[2022-09-21T03:59:46:ERROR:windows_http.cc(331)] TLS connection failure. See details below. [Status: 0x00010000. Status Info: 0x00000001]
[2022-09-21T03:59:46:ERROR:windows_http.cc(340)] Certificate details:
---Validity--
Valid from: 2017-09-13 17:23:55 UTC
Valid until: 2017-12-06 17:10:00 UTC
---Subject---
US
California
Mountain View
Google Inc
*.googleapis.com
---Issuer----
US
Google Inc
Google Internet Authority G2
-------------
[2022-09-21T03:59:46:ERROR:windows_http.cc(282)] WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED: Certification revocation checking has been enabled, but the revocation check failed to verify whether a certificate has been revoked. The server used to check for revocation might be unreachable.
[2022-09-21T03:59:46:ERROR:windows_http.cc(197)] Error from API WinHttpSendRequest with WinHTTP proxy. Will try direct (without proxy). Code: 0x00002f8f
[2022-09-21T03:59:46:ERROR:windows_http.cc(107)] Network connection destination details: 216.58.194.170:443 (sfo07s13-in-f170.1e100.net)

在此示例中,计算机当前日期的年份被改为 2022,导致系统误认为证书已过期。每个日志行的开头显示了当前日期,而证书的“Valid from”和“Valid until”日期与当前日期不匹配。错误标记 WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED 表明系统未能检查证书吊销情况。

最后一个日志行的“Network connection destination details”后面显示了目的地 IP 地址和已解析的主机名。这是 1e100.net address,代表 Google。

跟踪日志示例

注意:此日志示例来自 GWMMO。如果 GWMME、密码同步或 GWSMO 遇到网络连接/TLS 问题,也会生成类似的跟踪日志条目。

2017-09-21T04:10:04.356-03:00 1a20 E:Network ClientMigration!WinHttp::HandleCallback @ 2025 ()> Secure connection failure. Status: 0x00010000. Info 0x00000009
2017-09-21T04:10:04.356-03:00 1a20 E:Network ClientMigration!WinHttp::HandleCallback @ 2030 ()> Failure details:
WINHTTP_CALLBACK_STATUS_FLAG_CERT_REV_FAILED: Certification revocation checking has been enabled, but the revocation check failed to verify whether a certificate has been revoked. The server used to check for revocation might be unreachable.
WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA: The function is unfamiliar with the Certificate Authority that generated the server's certificate.
Certificate details:
---Validity--
Valid from: 2016-09-20T04:08:45.000Z
Valid until: 2022-09-20T04:08:45.000Z
---Subject---
Created by http://www.fiddler2.com
DO_NOT_TRUST
*.google.com
---Issuer----
Created by http://www.fiddler2.com
DO_NOT_TRUST
DO_NOT_TRUST_FiddlerRoot
-------------
2017-09-21T04:10:04.356-03:00 1a20 E:Network ClientMigration!WinHttp::HandleCallback @ 2071 ()> Error result 5, hr = 0x80072f8f. Setting event 0000000000001638.
2017-09-21T04:10:04.356-03:00 1a20 E:Network ClientMigration!WinHttp::HandleCallback @ 2076 ()> Network connection destination details: 127.0.0.1:8888 (COMPUTERNAME)

在此示例中,用户安装了 Fiddler 并将其用于执行 HTTPS 解密(这表示该工具使用的是自己的证书),但其证书已从 Windows 受信证书列表中移除,因此不受系统信任。请注意,由于 Fiddler 是代理工具,因此会连接到 127.0.0.1 而不是 Google。错误标记包含 WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA,这表示证书授权机构 (CA). 不受系统信任。另请注意,该证书并非由 Google 颁发。

迁移失败,发生 0x80070005 错误

输出屏幕或跟踪日志文件中出现类似于以下内容的错误消息:

E:Generic ExchangeMigration!SetPropertyGuid @ 641 (user@example.com)> Failed with 0x80070005, last successful line = 637.

造成此问题的原因通常是用户账号没有所需权限。如要解决此问题,请务必在 Exchange 中为用户账号授予代理接收权限。

如果账号拥有代理接收权限,但错误仍然存在,则说明您的 Exchange 环境可能还要求用户账号具备代理发送权限。

从 Exchange 2010 迁移时出现 GWMME 0x80004005 错误

部分用户无法从 Exchange 2010 迁移数据,而且跟踪日志文件中显示“Failed with 0x80004005”错误消息。这类日志还包含以下信息:

  • 对 Exchange 2010 的随机 MAPI 调用。
  • Exchange Server 2010 客户端访问服务器上的远程过程调用 (RPC) 客户端访问日志中显示“BufferTooSmall”错误。

这是 Exchange 2010、Outlook 2007 和 Outlook 2010 的已知问题。您可能需要更新至 Exchange 2010 SP2 RU3。有关详情,请参阅有关 MAPI 调用失败错误的 Microsoft 文档。

邮件未上传且出现 0x8004106a 错误

如果日志中多次出现 HTTP 错误代码 500、502 和 503,且邮件上传失败并显示错误代码 0x8004106a,则可能是目标邮箱出了问题。这通常是由于负载过高造成的。

如要解决此问题,请确保目标邮箱未被过度使用。您可以:

  • 停用所有同步客户端(如 IMAP、POP、移动设备和邮件客户端)。
  • 一次仅从一个来源迁移邮件。

Google Workspace 服务和 GWMME

迁移后的 Google 日历活动不能正常更新

如果出现以下问题,则说明您的用户配置有误:

  • 系统未与参加者共享对日历活动的修改。
  • 日历通知和更新未在参加者的日历中生效。

迁移任何账号之前,都请先在 Google Workspace 中配置您的所有用户,即使您只想执行部分迁移也是如此。如果有任何网域别名或昵称,也请务必添加到 Google Workspace 中。接下来,如要解决此问题,请删除相应用户以组织者或邀请对象身份参与的所有活动,然后重新创建这些活动。

迁移联系人和日历时,出现 403 错误和问题

默认情况下,GWMME 每秒会迁移 25 位用户。此迁移速度超过了 Contacts API 和 Calendar API 的默认每秒查询次数 (QPS)。

如要解决此问题,在迁移联系人和日历时:

  • 请勿同时迁移电子邮件
  • 请将迁移速度降到每秒 4 - 8 位用户。

只有部分邮件迁移失败

如有部分邮件迁移失败,可能是由于这些邮件超出了 Gmail 规定的大小限制,或这些邮件中包含被 Gmail 屏蔽的附件类型。有关详情,请参阅 Gmail 中屏蔽的文件类型

您可能还需要移除文件夹大小限制,并确保文件夹会在 IMAP 中显示。如需了解详情,请参阅为用户启用和停用 POP 和 IMAP

Gmail 中的邮件数量与我的源账号不符

Google Workspace 会估算迁移完毕后您收件箱中的邮件数量。该估算值并非绝对值。因此,您的 Gmail 收件箱中显示的邮件数量可能与旧收件箱中的邮件数量不同。

如果您认为在迁移过程中遗漏了一些邮件,请检查:

  • 相应邮件(含附件)的大小是否超过 25 MB。您无法迁移大小超过 25 MB 的邮件。有关详情,请参阅通过 Gmail 邮件发送附件
  • Gmail 是否屏蔽了邮件中的附件。Gmail 会屏蔽某些类型的附件,如可执行文件。有关详情,请参阅 Gmail 中屏蔽的文件类型
  • 数据迁移范围是否涵盖相应邮件所在的文件夹,或相应邮件的收发日期。

邮件丢失或者迁移后的邮件显示错误的发件人或收件人

Exchange 或 PST 文件在迁移过程中,可能会发生邮件丢失或者迁移后邮件的发件人或收件人错误的情况。这可能是由于邮件发件人或收件人的 SMTP 地址缺失,系统因此改用了 Exchange X.500 地址。如果未创建全局地址列表 (GAL) 配置文件,或者已将用户从 GAL 中移除,则可能会出现此问题。

GWMME 发现 X.500 地址后会怎样

GWMME 发现 X.500 地址后,会寻找已在迁移服务器上注册且拥有相同 X.500 Exchange 组织名称的 MAPI 邮件配置文件。如果找到该 MAPI 邮件配置文件,则 GWMME 会根据该文件中的地址簿注册信息来解析 X.500 地址。

如果 GWMME 未在 Exchange 地址簿中找到此信息,则会尝试将 X.500 地址转换为 SMTP 地址。为此,GWMME 会考虑 X.500 地址的最后一个 CN 值,并将其用作电子邮件地址用户名。例如,X.500 地址 /O=ExchangeOrg/OU=CA/CN=RECIPIENTS/CN=EX_ALIAS 会转换成 SMTP 电子邮件地址 ex_alias@example.com。

如何使用 Exchange 地址簿来解析 X.500 地址

  1. 在运行迁移的服务器上创建(非缓存模式)MAPI 邮件配置文件。
  2. 确保在用于运行 PST 迁移的服务器上设置了 MAPI 邮件配置文件。
  3. MAPI 邮件配置文件必须连接到原始 Exchange 服务器,GWMME 才可以使用 GAL 正确解析收件人。
  4. 使用当前登录的用户或服务账号来设置 MAPI 邮件配置文件,以避免身份验证错误。

重要提示

测试并确认您已正确设置迁移。如果问题仍然存在,重新迁移并不会更新已迁移到您的 Google 账号的数据。请删除电子邮件数据,将其从“已删除邮件”中移除,然后再重新迁移。

Gmail 中的邮件显示错误日期

经过迁移的邮件可能会显示迁移日期和时间,而不是原始邮件的日期和时间。

这很可能是因为原始邮件的日期标头不符合 RFC 5322 规范。如果一封邮件的日期标头格式有误,Gmail 会为该邮件采用迁移的时间和日期。

我收到了类似“用户既不是活动参加者,也不是活动组织者”警告消息

您在为用户导入活动时,如果此用户既不是活动的原始组织者,也不是活动的初始参加者,就会出现这种情况。

不过,不论是否出现类似警告消息,活动都会成功迁移到 Google Workspace,并且 Google Workspace 目标用户会在 Google 日历中显示为该活动的参加者。因为 Google 日历不支持为身份不是组织者或参加者的用户列出日历活动,所以需要这样处理。


Google、Google Workspace 以及相关标志和徽标是 Google LLC 的商标。其他所有公司名和产品名是其各自相关公司的商标。