Selenium中使用Gmail API获取激活邮件异常，第三个用户无匹配邮件

问题背景 #

在应用内创建测试用户后，通过Gmail API拉取指定主题的激活邮件完成自动注册，前两个用户的流程正常，第三个用户创建后始终查询不到对应邮件。

核心原因 #

1. 查询参数缺失过滤规则 #

Gmail API默认仅查询主收件箱内的邮件，如果第三封激活邮件被Gmail自动分类到「促销」「社交」等非收件箱标签，就会查询不到；另外前两封处理过的旧邮件如果没有归档，相同主题的多封邮件可能导致新邮件被排到列表靠后位置甚至下一页，默认仅查第一页就会漏。

2. 固定等待时间不足 #

批量发送的触发类邮件容易出现接收延迟，固定5秒等待不足以覆盖所有场景，第三封邮件可能在查询之后才送达收件箱。

3. 潜在翻页逻辑bug #

现有代码中isMailExist方法调用的getMessages翻页逻辑存在问题：翻页时没有携带原始的主题查询条件，导致翻页后查询范围变成所有邮件，无法正确匹配目标邮件。

修复方案 #

• 优化查询参数，补充过滤规则：将查询字符串修改为subject:"Fairjob Registration" in:inbox is:unread -category:promotions -category:social，显式限定仅查询收件箱内未读、不属于促销/社交分类的目标主题邮件，同时给主题加引号保证完全匹配。
• 替换固定等待为轮询查询：将固定5秒等待改为最多轮询10次、每次间隔3秒的查询逻辑，直到查到符合条件的邮件或超时，适配邮件接收延迟的场景。
• 显式指定排序规则：在查询参数中增加order:desc，强制按邮件接收时间倒序排列，保证最新的邮件始终在列表第一位，直接取index 0即可拿到最新的激活邮件。
• 修复翻页逻辑bug：修改getMessages方法，将查询query作为入参传入，翻页时同步携带query参数，保证多页查询时过滤条件一致。
• 处理完成后归档旧邮件：每次激活成功后调用Gmail API将对应邮件标记为已读或归档，避免旧邮件占用查询结果，减少后续查询的干扰。

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