ブログ一覧に戻る

公開日:

Mollie Payments for WooCommerce更新後にCould not derive plugin pathでCritical Errorになるときの直し方

Mollie Payments for WooCommerce更新後、BitnamiやAKSなどシンボリックリンクを含む環境で Could not derive plugin path が出た状態から、WP_PLUGIN_DIR、WP_PLUGIN_URL、修正版確認までやった事例をご紹介します。

発生したケース

Mollie Payments for WooCommerceを更新したあと、サブサイトや管理画面でCritical Errorになるケースがありました。

ログには、Mollie Paymentsがプラグインの絶対パスからURLを導出しようとした際に、Could not derive plugin path という例外が出ていました。

Uncaught RuntimeException:
Could not derive plugin path

場所:
wp-content/plugins/mollie-payments-for-woocommerce/lib/payment-gateway/src/PaymentGatewayModule.php

このケースでは、決済設定そのものではなく、Bitnami、AKS、Docker、Bedrockのように実体パスとWordPressが認識するプラグインパスがずれる環境で、プラグインのパス解決に失敗している問題と判断しました。

Mollie Paymentsのplugin pathエラー確認フロー

このケースの解決方法

このケースで解決につながる対応は、Mollie Payments for WooCommerceを修正版へ更新することです。すぐに更新できない場合は、ステージングで WP_PLUGIN_DIR と WP_PLUGIN_URL を実体パスに合わせる回避策を検証します。

具体的な解決手順:
1. Mollie Paymentsのバージョンとエラーログを控える
2. Bitnami、AKS、Docker、Bedrockなど、実体パスがずれる構成か確認する
3. ステージングでMollie Paymentsを修正版へ更新する
4. すぐ更新できない場合は `WP_PLUGIN_DIR` / `WP_PLUGIN_URL` の固定を検証する
5. カート、チェックアウト、Mollie決済ボタン、Webhookを確認する

WP_PLUGIN_DIR や WP_PLUGIN_URL の固定はサイト全体へ影響します。本番では、まず修正版更新を優先し、定数変更は副作用を確認してから採用します。

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

決済プラグインでFatal Errorが出ると、決済APIキーやWebhookを疑いたくなります。ただし Could not derive plugin path が出ている場合、先に見るのはサーバー上のパス構成です。

状態判断
Could not derive plugin path が出るパス解決エラーを疑う
Bitnami、AKS、Docker環境シンボリックリンクや実体パス差を確認
WP_PLUGIN_DIR と実パスが異なるWordPressの認識パスと実体パスの不一致を疑う
更新直後に発生Mollie Paymentsの該当バージョン差を確認
決済導線に関係する応急復旧後にテスト決済まで確認

このエラーでは、Mollieの決済機能を深く調べる前に、プラグインファイルのURLを作る処理が正しく動いているかを確認します。

具体的な解決手順

Mollie Payments plugin path確認

[ ] エラーログに PaymentGatewayModule.php が出ているか確認する
[ ] Bitnami、Docker、AKS、Bedrockなど特殊な配置か確認する
[ ] WP_PLUGIN_DIR の値を確認する
[ ] 実際のプラグイン配置パスを確認する
[ ] シンボリックリンクの有無を確認する
[ ] Mollie Paymentsのバージョンを確認する
[ ] 8.1.4以降など修正版へ更新できるか確認する
[ ] 応急対応として WP_PLUGIN_DIR / WP_PLUGIN_URL 固定が必要か検証する

Could not derive plugin path は、決済APIの認証失敗ではありません。Mollie Paymentsが支払い方法のスクリプトを登録する過程で、プラグインファイルのパスとURLを結びつけられずに落ちています。

実際の復旧手順

  1. エラーログとMollie Paymentsのバージョンを控える
  2. FTP/SFTPまたはコンテナ内で実際のプラグイン配置パスを確認する
  3. WP_PLUGIN_DIR と WP_PLUGIN_URL の値を確認する
  4. Bitnamiやコンテナのシンボリックリンク構成を確認する
  5. ステージングでMollie Paymentsを修正版へ更新する
  6. すぐ更新できない場合、wp-config.php で WP_PLUGIN_DIR を実体パスへ揃える回避策を検証する
  7. 公開ページ、カート、チェックアウト、Mollie決済ボタンを確認する
  8. テスト決済、Webhook、注文ステータス更新まで確認する

WP_PLUGIN_DIR や WP_PLUGIN_URL の固定は、環境全体に影響します。本番へ入れる前に、他のプラグイン、管理画面、静的アセット読み込みに副作用がないか確認します。

やってはいけない対応

NG理由
決済APIキーを先に再発行するログ上は認証ではなくパス解決の問題
本番で WP_PLUGIN_DIR を即固定する他プラグインのURL生成に影響する可能性がある
決済プラグインを停止したまま放置する購入導線が止まる
表示確認だけで復旧完了にする決済、Webhook、注文ステータスまで確認が必要

顧客向け通知例

Mollie Payments for WooCommerce更新後に、サイトまたは管理画面でCritical Errorが出る状態を確認しました。

ログ上では、決済APIの認証ではなく、サーバー上のプラグイン配置パスとWordPressが認識しているプラグインパスの差により、Mollie Paymentsが必要なスクリプトURLを導出できない可能性があります。

まず環境のパス設定、シンボリックリンク、Mollie Paymentsの修正版を確認します。復旧後はカート、チェックアウト、テスト決済、Webhook、注文ステータス更新まで確認します。

公式情報

Mollie Payments for WooCommerceは、WooCommerceにMollie決済を追加するプラグインです。環境依存のパス問題では、配布元、サポート事例、WordPressのプラグインパス定数を確認します。

確認環境

確認対象:
- WordPress:
- WooCommerce:
- Mollie Payments for WooCommerce:
- サーバー構成: Bitnami / Docker / AKS / 通常構成
- WP_PLUGIN_DIR:
- WP_PLUGIN_URL:
- シンボリックリンク:

復旧確認チェック

復旧確認:
[ ] 公開ページと管理画面が表示される
[ ] Mollie Paymentsの設定画面が開ける
[ ] チェックアウトでMollie決済方法が表示される
[ ] テスト決済で注文が作成される
[ ] Webhookと注文ステータス更新が動く
[ ] WP_PLUGIN_DIR / WP_PLUGIN_URL変更の副作用がない
[ ] 修正版へ更新できたか記録した

NexraOneでできること

NexraOneはMollie Paymentsのパス解決を修正するツールではありません。ただし、Fatal Errorを検知できると、決済プラグイン更新後にサイトや管理画面が落ちたタイミングを把握しやすくなります。

決済プラグインの障害では、公開ページが表示されるだけでは不十分です。チェックアウト、決済、Webhook、注文ステータスまで復旧確認に含める必要があります。

あわせて確認したい記事

WooCommerce PayPal Payments 4.0.4更新後にplugins.phpでArgumentCountErrorになるときの確認方法 と、WooCommerce有効時にREST API endpointが400 Bad Requestになるときの確認方法 を確認してください。更新前の運用は、プラグイン更新前の確認チェックリスト が近いです。

まとめ

Mollie Payments for WooCommerce更新後に Could not derive plugin path が出る場合、決済APIキーよりも先に、Bitnamiやコンテナ環境のプラグインパス解決を確認します。

修正版への更新、WP_PLUGIN_DIR / WP_PLUGIN_URL の確認、テスト決済、Webhook、注文ステータス更新まで見てから復旧と判断してください。

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

この記事を書いた人

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社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。