リリース前メールラボ

開発・QA向けメールテストチェックリスト

テストケースごとに専用アドレスを用意し、実際の送信を実行します。到着時間、テンプレートの言語、認証コード、リンク先の4項目で結果を確認しましょう。

再現可能な基準を作る

合格基準を決めてから送信する

メールが「届いたように見える」だけでは、確認は完了しません。許容できる遅延、認証コードの有効期間、リンクの環境、テンプレートの言語、モバイル表示を明確にしておけば、失敗時にどの項目が基準から外れたのか把握できます。

テスト用IDを分離する

テストごとに新しいアドレスを使い、過去のメールや認証コード、既読状態の影響を避けます。

送信フローを実行する

実際のUIまたはAPIで操作を完了し、キューを回避してメールサービスを直接呼び出さないようにします。

内容を確認する

差出人、件名、変数、プレーンテキスト版、ボタンのリンク、ローカライズを確認します。

証跡を保存する

不具合の再検証に備え、イベント時刻、message ID、スクリーンショット、環境を記録します。

主要テストマトリクス

成功・再送・期限切れ・異常系を網羅する

初回の成功だけをテストしてはいけません。メール認証はレート制限、状態遷移、セキュリティポリシーと連動するため、境界ケースで重複送信や誤ったテンプレートが見つかりやすくなります。

フロー最低限のケース内容の確認状態の確認
登録確認初回、メールアドレス重複、リンク期限切れ宛名、確認ボタン、環境ドメイン1回のみ使用、期限切れメッセージ
ログイン認証コード正しいコード、誤ったコード、再送、レート制限6桁コード、有効期間、デバイスに関する案内旧コードの無効化、クールダウンのカウントダウン
パスワードリセット存在するアカウントと存在しないアカウントセキュリティ文言、リセットリンクアカウント列挙対策、リンクの無効化
ワークフロー通知成功、失敗、一部成功タスク名、数値、対象環境重複排除、再試行、遅延
表示とアクセシビリティ

本文テストはデスクトップのスクリーンショットだけでは不十分

狭い画面での折り返し

幅320~390pxで長い件名、ボタンの文言、認証コードのブロック、URLを確認し、重要な情報が横方向に切れないようにします。

プレーンテキスト版

画像を無効にするか text/plain 版を表示し、認証コード、リンク、サポート情報が完全かつ分かりやすく残っていることを確認します。

言語と文字方向

アカウントの言語とテンプレートの言語を1対1で対応させ、日付、句読点、変数がデフォルトの英語のままになっていないか確認します。

不具合記録の項目

次のエンジニアが再現できるようにする

メールの問題は、業務アプリ、キュー、プロバイダー、受信システムにまたがります。タイムスタンプと一意の識別子がなければ、チームは推測を繰り返すしかありません。

受信診断を開く
テストID完全なメールアドレス、アカウントの言語、環境、テストケース番号。
時間の証跡操作時刻、タスクのキュー投入時刻、プロバイダーの受信時刻、最終到着時刻。
メッセージの証跡message ID、テンプレートのバージョン、件名、重要な変数。実際のパスワードは記録しません。
期待値と実績どの合格基準から外れたのかを具体的に記載し、「メールがおかしい」だけで終わらせないようにします。