2026 Cloudflare Email Serviceのローカル送信テストはどう行う？

症状：Wrangler devでは送信処理が動いたのに、受信箱にメールが届かず、テストが成功したのか判断できません。
最短の進め方は、まずローカル模擬で送信ロジックと本文を確認し、実際の受信が必要な場合だけ遠隔バインディングに切り替えることです。実送信先は自社製品専用のテスト受信先に限定します。

Cloudflare Workersでメール機能を開発している方は、模擬送信と実送信の境界を確認できます。
メール回帰を担当するQAエンジニアは、ローカルで完了できる検査と受信証拠が必要な検査を分けられます。
AI開発支援ツールなどで自社製品を素早く作っている方は、誤送信を避けながらリリース前の確認を進められます。

最終更新：2026年10月22日。確認対象はCloudflareのローカル送信テスト手順とWranglerの環境別バインディング設定です。設定や制限は変更される可能性があるため、作業時にも公式ページを再確認してください。

最初に選ぶのは、ローカル模擬か実際の受信かです

Cloudflare Email Serviceのローカル送信テストでは、標準のローカル実行はメールを受信者へ配達する操作ではありません。Cloudflareの説明では、送信内容はコンソールまたはローカルファイルに記録されます。遠隔バインディングを使うと実際の送信になるため、確認したいことに応じて経路を選びます。

「送信処理を通った」という記録と「受信箱に届いた」という結果は別の証拠です。ローカル記録だけで、実配送まで成功したと判定しないでください。

準備段階では設定と送信先を分けます

まず、自社Workerの開発環境でメール送信バインディングが設定されているか確認します。Cloudflareの設定例では、send_emailの下にバインディング名を定義します。構成ファイルの形式や環境ごとの指定は、送信バインディングの公式設定と環境別設定の説明に合わせてください。

Wranglerの環境別設定では、バインディングの扱いが環境ごとに変わる場合があります。開発用と本番用の設定を並べて確認し、どの環境で実送信が有効になるかを明確にしてから起動します。

実際のテスト宛先を選ぶ段階では、テスト用メールアドレスの選び方も参考になります。テストの目的が一時的な受信確認なのか、あとから返信や長期の参照が必要なのかを先に決めておくと、宛先の選択を誤りにくくなります。

ローカル実行では生成内容を検査します

準備ができたら、ローカル開発サーバーを起動し、自社Workerのメール送信処理を呼び出します。Cloudflareの手順にあるとおり、標準のローカル実行で出力されるのは送信内容の記録です。受信者にメールが届いたことを示す結果ではありません。

進め方は次のとおりです。

• 開発環境の構成ファイルで送信バインディングを確認します。
• npx wrangler devでローカル開発サーバーを起動します。
• 自社アプリの登録、パスワード再設定、通知など、確認対象の処理を実行します。
• コンソールまたは公式手順に沿ったローカルファイルで、生成されたメールを確認します。
• 件名、本文、期待する案内やリンクの内容をチェックし、テスト結果を記録します。

ここでは、本文の文言やアプリ側の分岐を見ます。メールが届かなかったときも、まずローカル記録が生成されたかを確認すれば、送信処理の未実行と実際の受信問題を切り分けやすくなります。Wranglerの動作や出力先を調べるときは、Cloudflareのローカル開発ドキュメントを基準にしてください。

実際の受信が必要なら、遠隔バインディングへ切り替えます

受信箱に届くことまで確認する段階では、遠隔バインディングを有効にします。Cloudflareの説明では、この設定は模擬記録ではなく、実際の受信者への送信につながります。設定名や指定方法は、Email ServiceのWorkers API資料と現在のバインディング設定を照合してください。

遠隔設定へ切り替える前に、実行環境、送信操作、宛先を確認します。テスト用の操作であっても、指定した宛先にメールが送られる可能性があります。

誤送信を防ぐため、開発用の遠隔設定は本番設定と分け、送信先を専用のテストアドレスに制限します。自社アプリのテストデータに、実ユーザーやチームの日常アドレスを入れないことも重要です。Cloudflareのメール送信の開始手順も参照し、アカウントや送信元に関する条件を実行前に確認してください。

受信後は、成功を示す証拠を分けて残します

実送信後は専用のテスト受信箱を開き、メールが届いたか、件名と本文が自社の処理に合っているかを確認します。記録には環境名、実行した処理、送信先の区分、確認結果を残してください。送信呼び出しの成功だけでは、受信箱での確認を代替できません。

一時的な受信先は、確認したメールへの返信や長期間の保管が必要なテストには向かないことがあります。継続的に追跡するQAでは、管理されたテスト用メールアドレスや社内のメール別名を使う方法も検討してください。メール転送を使う場合は、転送先と利用条件の確認も先に行うと、試験後の管理方法を決めやすくなります。

FAQ：模擬記録と実受信の境界

ローカル模擬のメールは外部へ送信されますか

標準のローカル実行では、メールは実際の宛先へ送られず、内容がコンソールまたはローカルファイルに記録されます。そのため、本文や送信ロジックを確認する用途には使えますが、実際の受信を確かめるには遠隔バインディングを使った別の確認が必要です。

Wrangler devで生成した内容はどこを見ますか

ローカル開発サーバーを起動して自社の送信処理を実行し、Cloudflareのローカル開発手順に記載されたコンソールまたはファイルを確認します。件名、本文、期待する構造を照合してください。出力場所や設定は変更されることがあるため、作業時の公式資料を優先します。

実際のテスト受信先が必要になるのはいつですか

外部にメールが送られることや、テスト用受信箱に表示されることが合格条件に含まれる場合です。本文の生成確認だけならローカル模擬で十分ですが、実送信を試す際は専用アドレスを指定します。受信したメールの内容と実行環境も記録すれば、あとから結果を追いやすくなります。

遠隔バインディングで誤送信を防ぐには

本番とは分離した設定に遠隔バインディングを置き、宛先を専用のテストアドレスに限定します。テスト用の操作だけで送信が動くことを確かめ、実ユーザーのアドレスをテストデータに含めないでください。送信前には環境名と宛先を読み合わせ、受信確認後も結果を記録します。

今週はローカル検査から受信確認へ進めます

今週の作業では、まずWranglerのローカル記録で送信処理とメール内容を確認し、実受信が受け入れ条件に含まれる場合だけ遠隔バインディングに切り替えます。受信先には、返信や長期保管の必要性に合った専用アドレスを選びます。

一時的な受信確認にSendTmpを使う場合は、現在の画面で登録要否や受信条件を確認してからテスト先として選んでください。登録不要で即時に使える受信先が利用できれば、主メールを開発用サービスへ渡さずに受信確認を進められ、テスト通知で主メールの受信箱が埋まるのも避けやすくなります。