ブログ一覧に戻る

公開日:

Braintree for WooCommerceでWooCommerce Memberships依存が早く読み込まれFatal Errorになるときの直し方

Payment Plugins Braintree for WooCommerceでWooCommerce Memberships依存が早く読み込まれ、get_option() on nullになった状態から、読み込み順と依存関係を確認した事例をご紹介します。

発生したケース

Payment Plugins Braintree for WooCommerceを有効化しているWooCommerceサイトで、Fatal Errorが発生するケースがありました。

ログには、Braintreeプラグイン側のクエリ処理で get_option() を呼ぼうとした対象がnullになっている内容が出ていました。

Fatal error:
Call to a member function get_option() on null

場所:
wp-content/plugins/woo-payment-gateway/includes/class-wc-braintree-query.php

Payment Plugins Braintree for WooCommerceは、WooCommerceでBraintree決済を扱うための決済プラグインです。今回のケースでは、WooCommerce Membershipsも同時に使われており、依存するWooCommerceオブジェクトやMemberships関連の初期化より早いタイミングでBraintree側の処理が走っている可能性がありました。

BraintreeとWooCommerce Membershipsの読み込み順確認フロー

このケースの解決方法

このケースで有効だった対応は、Braintreeプラグインを一時停止して復旧を確認し、直前に動いていたBraintreeバージョンへ戻すことです。そのうえで、WooCommerce Memberships、WooCommerce本体、Braintreeの更新組み合わせをステージングで確認します。

具体的な解決手順:
1. Braintreeプラグインを一時停止して復旧するか確認する
2. WooCommerce Membershipsを一時停止して再現差を見る
3. Braintree、Memberships、WooCommerce本体のバージョンを確認する
4. 直前に動いていたBraintreeバージョンへ戻す
5. テーマや独自コードで早いタイミングのフックがないか確認する
6. カート、チェックアウト、Braintree決済、会員価格を確認する

この問題はBraintreeの決済設定値ではなく、WooCommerceやMembershipsが初期化される前にBraintree側の処理が走る読み込み順の問題と推測しました。

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

この症状は、決済設定の入力ミスではなく、プラグインの読み込み順と依存関係の問題と推測しました。

状態判断
get_option() on null期待するオブジェクトがまだ初期化されていない
Braintree側のファイルで落ちる決済プラグインを原因候補にする
Membershipsも有効会員制価格や権限連携を確認
WooCommerce初期化前に発火読み込み順を疑う
決済プラグインで発生購入導線の確認が必須

今回は get_option() の機能を深く理解する必要はありません。重要なのは、nullに対してメソッドを呼んでいることです。つまり、プラグインが期待した依存オブジェクトを受け取れていない状態です。

具体的な解決手順

Braintree + Memberships確認

[ ] Braintreeプラグインのバージョンを確認する
[ ] WooCommerce Membershipsのバージョンを確認する
[ ] WooCommerce本体のバージョンを確認する
[ ] Fatal Errorの発生画面を記録する
[ ] Braintree停止で復旧するか確認する
[ ] Memberships停止で再現差を見る
[ ] 標準テーマで再現するか確認する
[ ] 決済、会員価格、制限コンテンツを確認する

決済プラグインと会員制プラグインが絡む場合、単にFatal Errorが消えればよいわけではありません。会員ランク、割引、購入制限、決済処理のすべてを確認します。

実際の復旧手順

  1. バックアップを取る
  2. Braintreeプラグインを一時停止して復旧するか確認する
  3. WooCommerce Membershipsを一時停止して再現差を見る
  4. Braintree、Memberships、WooCommerce本体を更新できるか確認する
  5. 直前に動いていたBraintreeバージョンへ戻す
  6. テーマや独自コードで早いタイミングのフックがないか確認する
  7. カート、チェックアウト、Braintree決済、会員価格を確認する

このケースで復旧と判断できるのは、Fatal Errorが消えるだけではありません。会員ユーザーと非会員ユーザーの両方で、価格、購入制限、Braintree決済が正常に動く状態です。

やってはいけない対応

NG理由
決済設定だけを変更する読み込み順問題なら解決しない
Membershipsを本番で即停止する会員制価格や閲覧制限が崩れる
決済プラグインを削除して終わりにする決済設定とWebhook確認が必要
非会員だけで購入テストする会員制プラグインの影響を見落とす

顧客向け通知例

Braintree決済プラグインの処理中にFatal Errorが出る状態を確認しました。

ログ上では、決済プラグインが必要なWooCommerce関連オブジェクトを取得できないタイミングで処理している可能性があります。WooCommerce Membershipsとの組み合わせも確認対象です。

検証環境でBraintree、WooCommerce Memberships、WooCommerce本体のバージョン差と読み込み順を確認します。復旧後は非会員・会員の両方でカート、チェックアウト、決済、会員価格を確認します。

公式情報

Braintree決済と会員機能が絡む注文詳細エラーでは、決済プラグイン、WooCommerce本体、会員機能の責務を分けて確認します。配布元とWooCommerce公式ページを先に確認します。

注文詳細画面が落ちる場合でも、注文データそのものが壊れているとは限りません。決済メタ情報や会員権限の表示処理で落ちている可能性を先に切り分けます。

復旧確認チェック

復旧確認:
[ ] 注文詳細画面が開ける
[ ] Braintree決済メタ情報が表示される
[ ] WooCommerce Membershipsの会員権限が崩れていない
[ ] 決済済み、返金済み、保留中の注文をそれぞれ確認した
[ ] 注文データや会員データを削除せずに復旧できた

NexraOneでできること

NexraOneは決済プラグインの読み込み順を自動修正するツールではありません。ただし、Fatal Errorを検知できると、決済や会員機能に関わる障害がいつ発生したかを記録できます。

会員制ECでは、公開ページの死活だけでなく、ログイン後の価格、購入制限、決済導線まで確認対象にする必要があります。

あわせて確認したい記事

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

まとめ

Braintree for WooCommerceで get_option() on null が出る場合、決済設定ではなく読み込み順と依存関係を疑います。

WooCommerce Membershipsのような会員制プラグインと併用している場合は、Fatal Errorの復旧だけでなく、会員価格、購入制限、Braintree決済まで確認してください。

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

この記事を書いた人

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-18

wp-maintenance

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

WordPressには決まったサポート期限がなく、正式に保守されているのは最新版だけです。古い版へのセキュリティ修正は好意で出ているもので、2026年11月時点で4.7以降に届いています。PHPが古いサイトが6.9系で止まる理由、修正が届かない版、更新を先送りできないサイトの見分け方を、WordPress.orgの公式情報をもとに整理します。

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

2026-11-16

wp-maintenance

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

WordPressのセキュリティ対策を業者に頼むと、1回の設定は2万円台から、月額の運用は5,500円から3万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。

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

2026-11-13

wp-maintenance

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

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

最新記事はこちら

ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき

2026-11-20

wp-guide

ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき

ACF PROのライセンスキーは「ACF」→「Updates」か、wp-config.phpのACF_PRO_LICENSEで有効にします。開発・ステージング環境がサイト数に数えられないURLの条件、サイトを移転したときの再有効化、期限が切れたときにできなくなること、旧ライセンス(買い切り)とComposerでの入れ方をまとめました。

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

2026-11-18

wp-maintenance

WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方

WordPressには決まったサポート期限がなく、正式に保守されているのは最新版だけです。古い版へのセキュリティ修正は好意で出ているもので、2026年11月時点で4.7以降に届いています。PHPが古いサイトが6.9系で止まる理由、修正が届かない版、更新を先送りできないサイトの見分け方を、WordPress.orgの公式情報をもとに整理します。

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

2026-11-16

wp-maintenance

WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること

WordPressのセキュリティ対策を業者に頼むと、1回の設定は2万円台から、月額の運用は5,500円から3万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。