本页由英文自动翻译。

阅读英文版
Proxy Mail QA

别再用 Gmail 作为测试验证码的收件箱

一开始很简单:一个团队 Gmail 账号,每个测试用一个加号地址,再加一个读取验证码的脚本。几个月后,测试在周一早上失败,因为令牌过期了;两次运行读到了对方的验证码;还得有人手动登录来修复。

更新于

用真实的 Gmail 账号作为测试收件箱,一开始能用。下面是它通常会出问题的地方。

会在哪里出问题

  • 令牌会过期。 同意屏幕处于 Testing 状态的 OAuth 应用拿到的刷新令牌会在 7 天后过期。流水线会一直失败,直到有人登录并复制一个新令牌进去。
  • 受限权限范围。 读取邮件需要 Gmail 的受限权限范围之一。把应用移出 Testing 状态可能需要通过 Google 的验证,某些用途还需要安全评估,这对一个测试辅助工具来说代价太大。
  • 所有运行共用一个收件箱。 加号地址(qa+run123@gmail.com)让每个测试有自己的地址,但每封邮件仍然进入同一个邮箱。并行运行会读到彼此的验证码,重试也可能取到上一次尝试的验证码。
  • 固定等待和脆弱的解析。 脚本用 sleep 轮询,再用正则表达式取出验证码,而市场团队哪天改了邮件模板,它就会失效。
  • 流程里需要人。 当 Google 要求确认登录时,测试无法回应,只能由拿着手机的人来处理。

改为每个测试一个地址

Proxy Mail QA 为每个测试提供自己的地址和收件箱,然后等待某个时间之后到达的邮件:

import { ProxyMailQA } from 'proxymail-qa';
const qa = new ProxyMailQA(); // reads PROXYMAIL_QA_API_KEY
const { address } = await qa.createAddress({ label: 'sign-up test' });
const since = new Date();
// …fill in the sign-up form with `address` and submit…
const { value: code } = await qa.waitForCode(address, { since });
  • 无需续期令牌。 API 密钥 不会在一周后过期。把它存放在你的 CI secrets 中。
  • 不会冲突。 每个地址只属于一个测试,所以并行运行永远看不到彼此的邮件。
  • 无需正则表达式。 验证码或链接会直接返回,并附带到达时间。
  • 无需固定休眠。 邮件一到,等待就会返回,而 since 确保不会返回更早的验证码。

迁移过来

  1. 把注册步骤中的 Gmail 地址换成 createAddress 提供的新地址。
  2. 用 waitForCode 或 waitForLink 替换收件箱轮询和正则表达式。
  3. 从 CI 中删除 Gmail 凭据,以及续期令牌的任务。

Playwright、Cypress 和 pytest 指南展示了在各个框架中的相同步骤。

在你的下一次注册测试中试试

免费版,无需信用卡。创建一个地址,看着验证码或链接送达。

免费创建账号打开应用

常见问题

为什么我的 Gmail 令牌一周后就失效了?

如果你的 Google Cloud 项目的 OAuth 同意屏幕处于 Testing 状态,Google 会在 7 天后让刷新令牌过期(除非应用只请求姓名、邮箱和个人资料,而这些无法读取邮件)。发布应用可以避免这一点,但 Gmail 的读取权限范围受限,所以已发布的应用可能需要先通过 Google 的验证。

我不能直接用 IMAP 加应用专用密码吗?

应用专用密码要求账号开启两步验证,而且组织的 Google Workspace 管理员可以关闭它。即使能用,所有测试仍然共用一个收件箱,还得从别人的邮件里找出自己的那封。

Gmail 的加号地址能让每个测试都有自己的地址。这还不够吗?

它让每个测试有自己的地址,而不是自己的收件箱。所有邮件仍然进入同一个邮箱,所以脚本得去搜索正确的邮件,而一封迟到的邮件可能会被匹配到错误的测试。有些注册表单也不接受带 + 的地址。

那再开一个专门用于测试的 Gmail 账号呢?

Google 可能会阻止由自动化软件控制的浏览器登录,新账号也可能被要求验证手机号。无论哪种情况,都需要有人介入,而这个账号又会变成共用的收件箱。

你的应用是用 AI 工具构建的?选择你的工具

对本页有疑问?

可以用任何语言提问。文档可以立即回答,你也可以把问题发给 Proxy Mail QA 团队,他们会用英文回复。