GitHub Actions Email Tests Need a Fast Runbook

说明与用途

在 GitHub Actions 中，邮件验证测试经常以模糊的超时结束。实施包含唯一临时邮箱、结构化收据和清理的五步工作流程，可消除不明确的失败并保持环境整洁。

问题

Email verification tests in GitHub Actions often fail with vague timeouts, making it hard to diagnose whether the issue is API slowness, inbox state, or retry logic.

结果

Tests now fail with clear, actionable evidence, reduce debugging time, and prevent orphaned disposable addresses.

工作流

• Create a unique test address before the browser action
• Record the address and a UTC trigger timestamp in a JSON receipt
• Poll only for messages newer than the trigger timestamp
• Save a redacted message summary as an artifact on failure
• Delete or expire the inbox in a final cleanup step

证据

The test output usually says something less useful: timeout waiting for email.

来源

For parallel jobs, start with isolated verification inboxes.

来源