下文介绍了如何排查在设置或安装 Google Workspace Migrate 平台时可能遇到的问题。
登录时出错
登录平台时，您可能会收到以下错误消息：
You have created a new client application that uses libraries for user authentication or authorization that will soon be deprecated. New clients must use the new libraries instead; existing clients must also migrate before these libraries are deprecated
请升级到 Google Workspace Migrate 2.3.4.0 版或更高版本，然后重试。有关详情，请参阅升级软件。
排查平台配置问题
在登录 Google Workspace Migrate 时，如果您收到 Platform is not configured correctly（平台配置不正确）的消息，请执行以下操作：
- 打开服务主机日志。按照查看服务主机日志中的步骤操作。
- 滚动至日志底部，并查看是否有潜在问题。
- 按照以下常见问题的排查步骤进行操作。
| 消息 | 问题排查步骤 |
| Client is unauthorized to retrieve access tokens using this method, or client not authorized for any of the scopes requested. | 如果您已手动设置服务帐号，请检查是否已完成全网域授权步骤并授权手动创建服务帐号中列出的范围。 |
|
确认您使用的是手动安装平台中列出的正确 OAuth 客户端 ID。
您需要在任务的第 8 步中输入 OAuth 客户端 ID。 |
| Platform is not configured correctly. | 检查平台服务器，查看是否已为云访问安全代理 (CASB) 提供程序安装了代理。
如果安装了代理，请将其移除，让流量恢复正常传输。有关详情，请参阅第三方 CASB 设置指南（适用于 Google Workspace）。 |
更换平台
如果您需要更换平台实例（例如，由于硬件故障），则必须拥有在设置 Google Workspace Migrate 时使用的加密密钥和密码。必须使用加密密钥才能访问数据库。如果没有，平台将无法恢复您的迁移数据。
如果您没有加密密钥，请重设 Google Workspace Migrate 设置。
方法 1：我有加密密钥如需设置新平台，请执行以下操作：
- 下载并安装平台。
有关详情，请参阅安装和设置平台。
- 打开 Chrome 浏览器，并使用 http(s)://<本地主机>:<端口> 格式输入 Google Workspace Migrate 平台的网址。
- 使用您在授权服务帐号客户端 ID 时所用的同一个管理员帐号登录平台。
- 点击 Get started（开始使用）。
- 点击 I want to recover previous migration data（我想恢复之前的迁移数据）。
- 在 Password（密码）字段中，输入您的加密密钥密码。
- 点击 Upload CSV file（上传 CSV 文件）以上传加密密钥，或是将文件拖放到方框中。
- 点击 Recover key（恢复密钥）。
- 使用您在首次设置 Google Workspace Migrate 时使用的数据库设置，完成配置数据库设置中的步骤。
- 使用您首次设置 Google Workspace Migrate 时使用的回拨地址和节点，然后继续完成设置流程。
完成恢复过程后，您的新平台就可以访问迁移数据了。
如果您没有该密钥，请重设 Google Workspace Migrate 设置：