ブログ一覧に戻る

公開日:

WooCommerce 10.9系でWC_Email::send_notificationのTypeErrorが出るときの解決方法

WooCommerce 10.9.0以降で注文メール送信時にWC_Email::send_notification()のTypeErrorが出る状態から、10.9.3以降への更新、メール送信コールバック確認、決済後の注文確認までやった事例をご紹介します。

発生したケース

WooCommerce 10.9.0以降で、注文メール送信時にFatal Errorが発生するケースがありました。

このケースが厄介なのは、決済処理のあとにエラーが出る可能性がある点です。購入者から見ると「エラーになったから注文できていない」と見える一方で、決済や注文作成は途中まで進んでいる可能性があります。

ログには、次のようなTypeErrorが出ていました。

Fatal error:
Uncaught TypeError:
WC_Email::send_notification(): Return value must be of type bool, null returned

場所:
woocommerce/includes/emails/class-wc-email.php

このケースでは、単なるメール未着ではなく、WooCommerceの注文メール送信処理で、戻り値の型が合わずにFatal Errorになっている問題として判断しました。

WooCommerce注文メール送信時のTypeError発生箇所

今回の事例の対応状況

今回は、WooCommerceを10.9.3以降へ更新し、注文メール送信時のTypeErrorを解消できた事例です。

WooCommerce GitHub Issueで報告され、WC_Email::send_notification() がbool以外の戻り値を受けたときにFatal Errorになる問題として修正PRがマージされています。WooCommerce 10.9.3のリリースノートでも、このFatal Errorの修正が明記されています。

このケースの解決方法

このケースで有効な解決方法は、WooCommerceを10.9.3以降へ更新することです。

あわせて、メール送信系プラグイン、SMTPプラグイン、独自コード、テーマの functions.php、mu-plugin などで woocommerce_mail_callback を変更していないか確認します。メール送信コールバックが null などbool以外を返すと、WooCommerce 10.9.0以降の型チェックでFatal Errorになりやすいためです。

解決の筋:
1. WooCommerce 10.9.0以降で発生しているか確認する
2. Fatal Errorの戻り値エラーが `WC_Email::send_notification()` か確認する
3. WooCommerceを10.9.3以降へ更新する
4. SMTP/メール送信系プラグインや独自コードのメールコールバックを確認する
5. 決済後の注文、メール送信、二重注文の有無を確認する

決済後に出るエラーでは、画面表示の復旧だけで終わらせません。注文、決済、メール、在庫、顧客への案内まで確認してから復旧完了と判断します。

開発中に気付いたこと

このケースでは、WC_Email::send_notification() の細かい実装を読者が深く理解する必要はありません。

保守現場で重要なのは、次の流れです。

WooCommerce 10.9.0以降でメール送信処理が厳格になった
戻り値としてboolが期待される場所に、メール送信コールバックから `null` などが返るとFatal Errorになります。
決済後の画面で落ちる可能性がある
購入者は失敗したように見えても、決済や注文が作られている場合があります。
メールプラグインや独自コードも確認対象になる
WooCommerce本体だけでなく、`woocommerce_mail_callback` を触るコードがないか確認します。

WooCommerce決済後エラーで確認する注文・決済・メールの関係

保守現場ではこう判断する

ログや確認結果判断した内容
決済後にエラー画面が出る注文と決済が進んでいないとは限らない
send_notification() のTypeErrorWooCommerceメール送信処理を疑う
null returned が出ているメール送信コールバックの戻り値を確認する
SMTPプラグインを利用中メール送信のフックやログを確認する
注文確認メールが届かないメール未着だけでなくFatal Errorを確認する

決済プラグインの障害と違い、このケースでは「メールだけの問題」と見えても、購入者体験と注文管理に影響します。注文が作られているのに購入者が再試行すると、二重注文や二重決済の問い合わせにつながります。

具体的な解決手順

WooCommerceメール送信Fatal Error復旧手順

[ ] データベースとwp-contentをバックアップする
[ ] WooCommerceのバージョンを確認する
[ ] PHPエラーログで `WC_Email::send_notification()` と `null returned` を確認する
[ ] WooCommerceを10.9.3以降へ更新する
[ ] SMTP/メール送信プラグインを最新版へ更新する
[ ] `woocommerce_mail_callback` を変更している独自コードを確認する
[ ] テスト注文で注文作成、決済、メール送信を確認する
[ ] エラー発生時刻の注文に二重決済や未処理注文がないか確認する

独自コードを確認するときは、次のような場所を見ます。

確認する場所:
- テーマの functions.php
- mu-plugins
- Code Snippets系プラグイン
- SMTP/メールログ系プラグイン
- WooCommerceメールカスタマイズ用の独自プラグイン

やってはいけない対応

NG理由
メール未着だけとして扱うFatal Errorなら注文処理や購入者画面にも影響します
決済後エラーの注文確認をしない二重決済、未処理注文、在庫差分を見落とします
WooCommerceだけ更新してメールプラグインを放置するコールバック側が原因で再発する可能性があります
顧客へ「注文は失敗」と断定する決済だけ通っているケースがあります

顧客向け通知例

WooCommerceの注文メール送信処理でFatal Errorが発生していることを確認しました。

今回のエラーは、注文メール送信時の戻り値がWooCommerce側の想定と合わず、処理が停止している可能性があります。決済後にエラーが表示された場合でも、注文や決済が途中まで進んでいることがあるため、該当時間帯の注文と決済履歴を確認します。

まずWooCommerceを10.9.3以降へ更新し、あわせてSMTP/メール送信系プラグインと独自コードを確認します。復旧後、テスト注文で注文作成、決済、メール送信、ログを確認します。

公式情報

WooCommerceには注文受付、注文処理、完了、返金などのトランザクションメール機能があります。このケースでは、WooCommerce 10.9.0以降のメール送信処理で、戻り値の型が合わずFatal Errorになる問題がGitHub Issueで報告され、修正PRがマージされ、10.9.3で修正が案内されています。

確認環境

確認対象:
- WordPress:
- WooCommerce: 10.9.0以降 / 10.9.3以降
- PHP:
- SMTP/メール送信プラグイン:
- 決済プラグイン:
- 確認画面: チェックアウト / 注文詳細 / WooCommerceメール設定 / PHPエラーログ

復旧確認チェック

復旧確認:
[ ] Fatal Errorが消えている
[ ] テスト注文が作成される
[ ] 決済ステータスが正常に反映される
[ ] 管理者宛メールが届く
[ ] 購入者宛メールが届く
[ ] WooCommerceログとPHPエラーログに同じTypeErrorが出ていない
[ ] 障害発生時間帯の注文に二重決済や未処理注文がない

NexraOneでできること

NexraOneはWooCommerceメールを送信するツールではありません。ただし、決済後や注文メール送信時のFatal Errorは、外形監視だけでは気付きにくい障害です。

トップページが正常でも、チェックアウト完了時や注文メール送信時だけ落ちることがあります。NexraOne AgentでWordPress内部の異常を監視できると、保守担当者は購入導線に近いエラーを早く確認し、注文と決済の照合作業へ移れます。

あわせて確認したい記事

WooCommerce更新後にFatal Errorが出るときの確認方法 と、WordPress Fatal Errorの原因と確認方法 を確認してください。更新前の確認には、プラグイン更新前の確認チェックリスト が近いです。

まとめ

WooCommerce 10.9系で WC_Email::send_notification() のTypeErrorが出る場合、このケースではWooCommerceを10.9.3以降へ更新することが解決方法です。

あわせて、SMTP/メール送信系プラグインや woocommerce_mail_callback を変更している独自コードを確認してください。決済後のエラーでは、画面復旧だけでなく、注文、決済、メール、二重注文の有無まで確認してから復旧完了と判断します。

※本記事では、公開されている事例や保守現場での知見をもとに、実務で確認すべきポイントを整理しています。

この記事を書いた人

uehiro
uehiroWebアプリケーションエンジニア

2019年よりWeb制作・システム開発に従事。WordPress・PowerCMS・Movable TypeのCMS構築・運用支援のほか、Next.js・Astro・Nuxt.jsを活用したヘッドレスCMS・モダンWeb開発に携わる。約150件の制作・運用支援実績を持ち、現在はWordPress監視サービス「NexraOne」の開発・運営を担当。

WordPress Monitoring Service

WordPressサイトの異常に、
早く気づける体制を作りませんか?

死活監視、WP-Cron、Fatal Error、SSL・ドメイン期限、更新検知をまとめて確認。
3サイトまで無料でWordPress監視を始められます。

ブログ一覧に戻る

合わせてこんな記事も読まれています

WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること

2026-11-13

wp-maintenance

WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること

WordPressの表示速度の改善(高速化)を業者に頼むと、公開価格は1サイト1万円前後から6万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、スコア保証の読み方、頼む前に自社で確かめておくことを整理します。

WordPressのサーバー移転を業者に頼む費用|1万円台から10万円近くまで、料金に入る作業と見積もりで確かめること

2026-11-11

wp-maintenance

WordPressのサーバー移転を業者に頼む費用|1万円台から10万円近くまで、料金に入る作業と見積もりで確かめること

WordPressのサーバー移転を頼むと、移転先のサーバー会社の代行は1サイト1万円台(税込)、移転作業を受けている専門業者や制作会社は3万円前後から、プランや容量によって10万円近くまでが公開価格です。2026年11月に料金ページを確認し、金額の差がどの作業から生まれるか、見積もりで確かめる点、サーバー会社の移行ツールで足りるサイトの見分け方をまとめました。

WordPressのテーマ変更の費用相場|業者に頼むと3万円台から、金額が変わる作業と見積もりで確かめること

2026-11-09

wp-maintenance

WordPressのテーマ変更の費用相場|業者に頼むと3万円台から、金額が変わる作業と見積もりで確かめること

公開中のWordPressサイトのテーマ変更を業者に頼むと、公開価格は3万円台(税別)から、デザインを作り直すと10万円を超えます。2026年11月に料金ページを確認し、金額の差がどの作業から生まれるか、見積もりで確かめる点、自社で切り替えてよいサイトの見分け方をまとめました。

最新記事はこちら

WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること

2026-11-13

wp-maintenance

WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること

WordPressの表示速度の改善(高速化)を業者に頼むと、公開価格は1サイト1万円前後から6万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、スコア保証の読み方、頼む前に自社で確かめておくことを整理します。

WordPressのサーバー移転を業者に頼む費用|1万円台から10万円近くまで、料金に入る作業と見積もりで確かめること

2026-11-11

wp-maintenance

WordPressのサーバー移転を業者に頼む費用|1万円台から10万円近くまで、料金に入る作業と見積もりで確かめること

WordPressのサーバー移転を頼むと、移転先のサーバー会社の代行は1サイト1万円台(税込)、移転作業を受けている専門業者や制作会社は3万円前後から、プランや容量によって10万円近くまでが公開価格です。2026年11月に料金ページを確認し、金額の差がどの作業から生まれるか、見積もりで確かめる点、サーバー会社の移行ツールで足りるサイトの見分け方をまとめました。

WordPressのテーマ変更の費用相場|業者に頼むと3万円台から、金額が変わる作業と見積もりで確かめること

2026-11-09

wp-maintenance

WordPressのテーマ変更の費用相場|業者に頼むと3万円台から、金額が変わる作業と見積もりで確かめること

公開中のWordPressサイトのテーマ変更を業者に頼むと、公開価格は3万円台(税別)から、デザインを作り直すと10万円を超えます。2026年11月に料金ページを確認し、金額の差がどの作業から生まれるか、見積もりで確かめる点、自社で切り替えてよいサイトの見分け方をまとめました。