A Small Schema for Reliable Email Fixtures

说明与用途

为临时邮箱创建轻量级合同，提升测试可靠性，消除竞争条件并简化错误诊断。

问题

Email tests often fail due to shared inbox state, race conditions, and lack of clear ownership, leading to flaky builds and unclear failure reasons.

结果

Tests become deterministic, failures are traceable to specific fixtures, and cleanup is reliable, reducing flaky CI runs.

工作流

• 1. Generate a unique owner label from CI runId and worker index.
• 2. Call mailbox service to create a disposable address with TTL.
• 3. Return an EmailFixture object containing address, owner, runId, createdAt, expiresAt, expectedSubject, and purpose.
• 4. In the test, trigger the email sending action.
• 5. Poll or wait for the email, filtering by fixture.createdAt and expectedSubject.
• 6. Verify message ownership using owner/runId metadata before extracting links or tokens.
• 7. Log safe identifiers (message id, timestamp, subject) and a reason for acceptance/rejection.
• 8. In a finally block, delete the mailbox if supported or mark as released; write a structured receipt with owner, purpose, observed message ids, selected id, and cleanup result.
• 9. On retry, create a new fixture or document why reuse is safe.
• 10. Use the receipt for debugging and failure analysis.

证据

Email tests often fail for reasons that have nothing to do with the email itself.

来源

Treat each disposable email fixture as a short-lived test resource with an owner, a purpose, and a receipt.

来源

Cleanup belongs in a finally block so it runs after both passing and failing tests.

来源