将Gmail邮箱迁移至其他服务商遇授权及适配问题求助

一、OfflineIMAP适配Gmail的授权方案 #

Gmail取消「允许不安全应用」选项后，OfflineIMAP仍可正常适配，需采用以下两种合规授权方式：

• 应用专用密码（App Password）：前提是账号已开启两步验证（2FA）。登录Google账号安全设置页，生成针对OfflineIMAP的专用密码，替换配置文件中原账号密码即可。
• OAuth2认证配置：OfflineIMAP支持OAuth2，需在Google Cloud Console创建项目并启用Gmail API，生成客户端ID、密钥，再通过OAuth授权流程获取刷新令牌，最终在配置文件中添加相关参数，示例如下：

  [Repository Gmail]
  type = IMAP
  remotehost = imap.gmail.com
  remoteport = 993
  ssl = yes
  remoteuser = your@gmail.com
  auth_mechanisms = XOAUTH2
  oauth2_client_id = 你的客户端ID
  oauth2_client_secret = 你的客户端密钥
  oauth2_refresh_token = 你的刷新令牌
  

  可借助OfflineIMAP自带的oauth2_helper工具完成令牌获取流程。

二、Wix自定义域名Gmail账号（Google Workspace）迁移失败排查 #

客户的xy@hisdomain.com属于Google Workspace账号（Wix仅代为管理订阅），迁移失败可从以下维度排查：

1. Workspace账号IMAP权限验证：登录Google Workspace管理后台，进入「应用」-「Google Workspace」-「Gmail」-「用户设置」，确认该账号的IMAP访问已被管理员启用，无全局限制。
2. Evolution备份的Maildir完整性检查：验证备份的Maildir目录结构是否标准，可使用maildir-utils工具扫描：

   mu index --maildir=/path/to/evolution-backup-dir
   

   若扫描报错，说明备份文件损坏，需重新导出。
3. OfflineIMAP配置适配调整：Workspace账号的IMAP服务器仍为imap.gmail.com，但必须使用上述两种授权方式（不可用原账号密码），且配置文件中remoteuser需填写完整邮箱地址xy@hisdomain.com。
4. 网络连通性测试：确认迁移环境可正常访问imap.gmail.com，可通过telnet验证端口连通性：

   telnet imap.gmail.com 993
   

内容的提问来源于stack exchange，提问作者jerg