公開日:
更新日:
WooCommerce 10.5の更新中にAbilities APIのFatal Errorが出たときの原因と直し方
WooCommerceを10.5系へ更新したときに「Failed opening required」で vendor/wordpress/abilities-api 内のファイルが見つからないというFatal Errorがログやメールに出るのは、更新の途中や、ファイルが新旧混ざって置かれたときに起きるものとissueで説明されています。一度だけなら様子見でよい場合と、WooCommerceのフォルダを消して入れ直す手順、確かめることをまとめました。
WooCommerceを10.5系へ更新したときに、Failed opening required というFatal Errorで vendor/wordpress/abilities-api の中のファイルが見つからないと、エラーログやWordPressからのメールに出ることがあります。WooCommerceのGitHubのissueでは、更新の途中でファイルが入れ替わっている最中に読み込みが走ったときや、更新でWooCommerceのフォルダの中に古いファイルと新しいファイルが混ざってしまったときに出ると説明されています。
報告を見る限り、エラーは更新の途中に一度出て、そのあとは公開ページも管理画面も普通に動いている例がほとんどです。その場合はWooCommerceのサポートも「無視してよい」と回答しています。更新が終わったあとも同じエラーがログに出続けるなら、ファイルが混ざったままなので、WooCommerceのフォルダを丸ごと消して入れ直します。
エラーの内容
WooCommerceのGitHubに立てられたissue(#63167)や、WordPress.orgのサポートフォーラムの報告では、次のような内容のエラーが出ています。
PHP Fatal error: Uncaught Error: Failed opening required
'.../wp-content/plugins/woocommerce/vendor/wordpress/abilities-api/includes/rest-api/endpoints/class-wp-rest-abilities-run-controller.php'
(class-wp-rest-abilities-init.php の25行目から)
abilities-api は、プラグインが「このサイトでできる操作」を決まった形で登録し、外部のツールやAIエージェントから呼び出せるようにするWordPressの仕組み(Abilities API)で、WooCommerceはそのライブラリを vendor フォルダに同梱しています。エラーは、このライブラリの初期化ファイルがREST APIの経路を登録するときに、読み込むはずのファイルが見つからないという意味です。
報告は10.5.0への更新のときに多く、10.5.1から10.5.2へ更新したときに出たという報告もあります。issueに載っているエラーの経路では、更新の処理(update.php)の途中で、WooCommerceの管理画面の処理がREST APIを先読みしたところで止まっています。報告者は、更新のあともサイトと管理画面は普通に動いていたと書いています。
なぜファイルが見つからなくなるのか
Abilities APIのライブラリは、0.4の版でファイル名が変わり、新しい名前には -v1-(class-wp-rest-abilities-v1-run-controller.php など)が付いています。issueのコメントでは、原因として次の2つが挙がっています。
1つめは、更新の道具が新しいプラグインのファイルを既存のフォルダに上書きで混ぜた場合です。古い初期化ファイルが残り、名前が変わる前のファイルを読みに行ってしまいます。コメントでは、サーバー会社の管理ツール(Softaculousなど)での更新や、FTPでファイルを上書きしたときに起きやすく、WordPressの更新機能では起きないはずだと書かれています。この場合は、ファイルが混ざったままなので、同じエラーが続けて出ます。
2つめは、更新の途中でREST APIの先読みが走った場合です。別のコメントでは、WordPressの「更新」画面から更新して、このエラーが一度だけ出て、そのあとは再発しなかったという再現の結果が載っています。ファイルの入れ替えが終わる前に読み込みが走ったことによるもので、更新が終われば出なくなります。
どちらも、WooCommerceの設定や、ほかのプラグインとの相性の問題ではなく、サーバーに置かれたWooCommerceのファイルの状態の問題です。
直し方
WooCommerceのサポートがフォーラムで案内している手順は、WooCommerceのフォルダを消して入れ直すことです。商品、注文、顧客、設定はデータベースに入っているので、プラグインのフォルダを消しても消えません。
- サイトのバックアップを取る(ファイルとデータベースの両方)
- 管理画面に入れるなら、WooCommerceを無効化する
wp-content/plugins/woocommerceのフォルダを削除する- WordPress.orgのWooCommerceのページからzipを取り直し、「プラグイン」→「新規プラグインを追加」→「プラグインのアップロード」で入れて有効化する
- 管理画面、商品一覧、注文一覧が開くかを確かめる
WooCommerceに依存するプラグイン(決済や配送の拡張など)が有効になっていると、WooCommerceの「無効化」が押せないことがあります。フォーラムでは、その場合は依存するプラグインを先に無効化するか、FTPで入れ直すよう案内されています。
zipをFTPで上げる場合は、既存のフォルダに上書きするのではなく、古いフォルダを消してから新しいフォルダを置いてください。上書きでは、今回の原因になった古いファイルが残ります。
一度だけ出て、いまは普通に動いている場合
WooCommerceのサポートは、10.5.2へ更新したときに一度だけこのエラーが出たという報告に対して、開発チームの見解として「更新中に一度だけ出て、サイトが普通に動いているなら無視してよい」と回答しています。
ただ、これは同じエラーが続けて出ていない場合の話です。PHPのエラーログを開き、更新した時刻のあとも同じエラーが何度も出ているなら、ファイルが混ざったままの可能性が高いので、上の手順で入れ直します。サーバー会社の管理ツールやFTPの上書きでいつも更新しているサイトは、次の更新でまたファイルが混ざるかもしれないので、WordPressの管理画面から更新するように変えておくと、少なくとも続けて出るほうは避けられます。
直ったら今の版まで上げる
この記事を書き直した2026年11月12日時点で、WordPress.orgで配布されているWooCommerceの最新版は11.2.2です(WordPress 7.0以上、PHP 7.4以上が必要)。10.5系のまま止めているサイトでは、入れ直したあと、ステージング環境で最新版への更新を試してから本番を上げます。
WooCommerceは商品、カート、決済に関わるので、本番で何度も上書き更新を試すより、ステージングで同じ手順を通してから本番に入れるほうが、どの時点で壊れたかを追えます。ステージングで更新を試す手順は別の記事にまとめています。
WordPressのステージング環境で更新を試す方法|本番の前にどこまで確かめるか関連記事
直ったあとに確かめること
管理画面が開いただけでは、お店として動いているかは分かりません。次の画面と操作まで通しておきます。
[ ] 管理画面とWooCommerceの設定画面が開ける
[ ] 商品一覧、注文一覧が開ける
[ ] 公開ページで商品をカートに入れ、チェックアウト画面まで進める
[ ] 決済のテスト(テストモードやサンドボックス)が通る
[ ] PHPのエラーログに abilities-api のFatal Errorが新しく出ていない
[ ] /wp-json/ が500エラーにならない
お客さまへの連絡の例
WooCommerceの更新中に、プラグインの内部ファイルが見つからないというエラーの通知が出ました。更新の途中で読み込みが走ったか、WooCommerceのファイルが新しいものと古いものが混ざって置かれたことが原因で、商品や注文のデータには影響していません。
エラーが続けて出ていないかを確かめ、必要ならWooCommerceを入れ直したうえで、管理画面、商品と注文の一覧、カートからチェックアウト、決済のテストまで通ることを確かめてご報告します。
同じAbilities APIまわりのエラー
Rank Mathでも、Abilities APIの関数 wp_get_abilities() が見つからないというFatal Errorが出ています。こちらはファイルの混在ではなく、WordPress 6.9より前の版で新しい関数を呼んでいたのが原因です。
Rank Mathでwp_get_abilities()のFatal Errorが出るときの原因と直し方関連記事
更新直後に気づくには
今回のエラーは、更新の途中にエラーログやWordPressからのメールに出るだけで、公開ページは普通に表示されていることが多いので、表示だけを見る監視では気づけません。WooCommerceを自動更新しているサイトや、サーバーの管理ツールでまとめて更新しているサイトでは、更新のあとにエラーログに新しいFatal Errorが出ていないか、管理画面やREST APIが応答しているかまで確かめておくと、ファイルが混ざったまま次の更新を迎えることを避けられます。
Fatal Errorのログの見方は、別の記事でまとめています。
WordPressでエラーが出たときの確認順|表示・症状別の原因と直し方関連記事
更新する前に確かめておくことは、こちらのチェックリストにあります。
出典
よくある質問
- WooCommerce 10.5の更新後に出るAbilities APIのFatal Errorは何が原因ですか?
- WooCommerceのGitHubのissueのコメントでは、更新の道具が新しいプラグインのファイルを既存のフォルダに上書きで混ぜたため、古いファイルと新しいファイルが混在し、古い初期化ファイルが名前の変わったファイルを読みに行って止まったと説明されています。WordPressの更新画面から更新したときも、更新の途中でREST APIの先読みが走ると一度だけ出る、という再現結果も書かれています。
- どうすれば直りますか?
- バックアップを取ってから、wp-content/plugins/woocommerce のフォルダを消し、WordPress.orgから取り直したWooCommerceを入れ直します。WooCommerceのサポートは、商品や注文のデータはデータベースにあるのでフォルダを消しても残ると案内しています。
- エラーが一度だけ出て、そのあとサイトが普通に動いている場合も対応が要りますか?
- WooCommerceのサポートは、開発チームの見解として、更新中に一度だけ出てサイトが普通に動いているなら無視してよいと回答しています。ただ、ファイルが新旧混ざったままなら同じエラーが続けて出るので、更新した時刻のあともエラーログに出ていないかを確かめ、続けて出ているなら入れ直します。
※本記事では、公開されている事例や保守現場での知見をもとに、実務で確認すべきポイントを整理しています。
この記事を書いた人
WordPress Monitoring Service
WordPressサイトの異常に、
早く気づける体制を作りませんか?
死活監視、WP-Cron、Fatal Error、SSL・ドメイン期限、更新検知をまとめて確認。
3サイトまで無料でWordPress監視を始められます。
合わせてこんな記事も読まれています
2026-11-18
wp-maintenance
WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方
WordPressには決まったサポート期限がなく、正式に保守されているのは最新版だけです。古い版へのセキュリティ修正は好意で出ているもので、2026年11月時点で4.7以降に届いています。PHPが古いサイトが6.9系で止まる理由、修正が届かない版、更新を先送りできないサイトの見分け方を、WordPress.orgの公式情報をもとに整理します。
2026-11-16
wp-maintenance
WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること
WordPressのセキュリティ対策を業者に頼むと、1回の設定は2万円台から、月額の運用は5,500円から3万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。
2026-11-13
wp-maintenance
WordPressの高速化を業者に頼む費用|料金の差が出る作業と、見積もりで確かめること
WordPressの表示速度の改善(高速化)を業者に頼むと、公開価格は1サイト1万円前後から6万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、スコア保証の読み方、頼む前に自社で確かめておくことを整理します。
最新記事はこちら
2026-11-20
wp-guide
ACF PROのライセンス管理|キーの入れ方、ステージングの数え方、サイト移転と期限切れのとき
ACF PROのライセンスキーは「ACF」→「Updates」か、wp-config.phpのACF_PRO_LICENSEで有効にします。開発・ステージング環境がサイト数に数えられないURLの条件、サイトを移転したときの再有効化、期限が切れたときにできなくなること、旧ライセンス(買い切り)とComposerでの入れ方をまとめました。
2026-11-18
wp-maintenance
WordPressのサポート期限はいつまで?古いバージョンに修正が届く範囲と、更新を先送りできないサイトの見分け方
WordPressには決まったサポート期限がなく、正式に保守されているのは最新版だけです。古い版へのセキュリティ修正は好意で出ているもので、2026年11月時点で4.7以降に届いています。PHPが古いサイトが6.9系で止まる理由、修正が届かない版、更新を先送りできないサイトの見分け方を、WordPress.orgの公式情報をもとに整理します。
2026-11-16
wp-maintenance
WordPressのセキュリティ対策を業者に頼む費用|1回の設定と月額の運用で変わる料金、見積もりで確かめること
WordPressのセキュリティ対策を業者に頼むと、1回の設定は2万円台から、月額の運用は5,500円から3万円台まで幅があります。2026年11月に国内4社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。
