公開日:
WooCommerceのログ削除処理でftp_nlist() Fatal Errorになるときの直し方
WooCommerceのログ削除処理 wc_cleanup_logs() 実行時に、FTPExt filesystem環境で ftp_nlist() のFatal Errorが出た状態から、ファイルシステム方式、Action Scheduler、ログ削除の影響確認までやった事例をご紹介します。
発生したケース
WooCommerceのスケジュール処理中に、サイトのエラーログへ ftp_nlist() のFatal Errorが出るケースがありました。
公開ページや注文画面がすぐ落ちるとは限りません。ところが、WooCommerceのログ削除処理 wc_cleanup_logs() が走ったタイミングで、WordPressのファイルシステムAPIがFTPExt方式を使い、FTP接続がない状態でファイル確認を行って落ちていました。
PHP Fatal error:
Uncaught TypeError:
ftp_nlist(): Argument #1 ($ftp) must be of type FTP\Connection, null given
場所:
wp-admin/includes/class-wp-filesystem-ftpext.php
関連処理:
wc_cleanup_logs()
Automattic\WooCommerce\Internal\Admin\Logging\FileV2\File->is_readable()
このケースでは、WooCommerceの注文データや商品データの問題ではなく、WooCommerceログ削除処理とWordPressファイルシステム方式の組み合わせで起きる問題と判断しました。
このケースの解決方法
このケースで解決につながる対応は、WooCommerceを修正版へ更新し、ログ削除処理がFTPExt方式でFatal Errorにならないか確認することです。すぐに更新できない場合は、ファイルシステム方式を direct に切り替えられる環境か、サーバー管理者へ確認します。
具体的な解決手順:
1. Action Schedulerのhook名とエラー時刻を控える
2. `wc_cleanup_logs()` と `ftp_nlist()` のFatal Errorか確認する
3. WooCommerceを修正版へ更新できるかステージングで検証する
4. 必要に応じて `FS_METHOD` やFTP関連定数を確認する
5. direct方式へ切り替えられるかサーバー管理者へ確認する
6. 更新後にログ削除ジョブが再失敗しないか確認する
この問題は注文データではなく、ログ削除時のファイル操作方式で落ちていると判断します。注文や決済を直接触る前に、Action Schedulerとファイルシステム方式を確認します。
保守現場ではこう判断する
ftp_nlist() が出ている場合、WooCommerce本体の画面だけを見るのではなく、サーバーのファイル操作方式を確認します。
| 状態 | 判断 |
|---|---|
wc_cleanup_logs() が出る | WooCommerceログ削除処理を確認 |
WP_Filesystem_FTPext が出る | 直接ファイル操作ではなくFTP方式を使っている |
FTP\Connection, null given | FTP接続が初期化されないままファイル確認している |
| Action Scheduler経由で発生 | バックグラウンド処理の再発を確認する |
| セキュリティ方針でdirect方式不可 | サーバー設定変更だけで片付けない |
このエラーは「ログ削除だから軽い」とは判断しません。Fatal Errorがバックグラウンド処理で繰り返されると、Action Schedulerの失敗、管理画面のノイズ、監視通知の増加につながります。
具体的な解決手順
WooCommerce FTPExtログ削除エラー確認
[ ] debug.logまたはサーバーログで wc_cleanup_logs() が出ているか確認する
[ ] wp-admin/includes/class-wp-filesystem-ftpext.php が出ているか確認する
[ ] DISALLOW_FILE_MODS、FS_METHOD、FTP_* 定数を確認する
[ ] WooCommerce > ステータス > スケジュール済みアクションを確認する
[ ] wc_cleanup_logs 関連の失敗回数と実行間隔を確認する
[ ] WooCommerceのログ保存先と権限を確認する
[ ] WooCommerce更新で修正済みか確認する
[ ] direct方式へ変更できるか、セキュリティ要件と合わせて判断する
ftp_nlist() の一般的な機能を深く理解する必要はありません。重要なのは、WooCommerceのログ削除処理がファイルの存在確認を行うとき、WordPress側がFTPExt方式を使い、FTP接続がない状態で処理が進んでいることです。
実際の復旧手順
- エラーが出ているAction Schedulerのhook名と時刻を控える
- WooCommerceログ削除処理で落ちているか確認する
FS_METHODやFTP関連定数を確認する- WooCommerceの修正版へ更新できるかステージングで検証する
- direct方式へ切り替えられる環境か、サーバー管理者へ確認する
- すぐ切り替えられない場合は、失敗ジョブの再実行間隔とログ増加を監視する
- 更新後に
wc_cleanup_logs()が再失敗しないか確認する - WooCommerceログ、注文、決済、メール処理に副作用がないか確認する
セキュリティポリシーでFTP方式を使っているサイトでは、安易に FS_METHOD を direct に変えるのは避けます。ファイル権限や運用ルールを確認してから判断します。
やってはいけない対応
| NG | 理由 |
|---|---|
| 失敗したActionだけ削除して終わる | 次回のログ削除で再発する |
FS_METHOD を本番で即変更する | サーバーのセキュリティ方針に反する可能性がある |
| WooCommerceログを全削除する | 調査材料を失う |
| 注文・商品データを疑って先に触る | ログ上の原因はファイルシステム処理側 |
顧客向け通知例
WooCommerceのバックグラウンド処理でFatal Errorが出ている状態を確認しました。
ログ上では、注文や商品データではなく、WooCommerceのログ削除処理がファイル確認を行う際に、サーバーのファイルシステム方式と噛み合わずエラーになっている可能性があります。
まずAction Schedulerの失敗状況、WooCommerceログ、サーバーのファイル操作方式を確認します。修正版への更新またはサーバー設定の見直しを検証環境で確認してから本番反映します。
公式情報
WooCommerceはWordPress向けのECプラットフォームで、ログ管理やバックグラウンド処理にもAction Schedulerを利用します。今回のようなサーバー依存の問題では、WooCommerce公式配布元とGitHub issueを確認します。
- WooCommerce - WordPress.org
- WooCommerce GitHub issue: FTP-based file system compatibility issue
- Action Scheduler
確認環境
確認対象:
- WordPress:
- WooCommerce:
- PHP:
- FS_METHOD:
- FTP関連定数:
- Action Schedulerの失敗hook:
- WooCommerceログ保存先:
復旧確認チェック
復旧確認:
[ ] wc_cleanup_logs() のFatal Errorが再発していない
[ ] Action Schedulerに同じ失敗ジョブが増えていない
[ ] WooCommerceログが正常に記録・削除される
[ ] 注文、決済、メール送信に副作用がない
[ ] ファイルシステム方式の変更有無を記録した
[ ] セキュリティ方針と復旧方法に矛盾がない
NexraOneでできること
NexraOneはWooCommerceのファイルシステム処理を修正するツールではありません。ただし、Fatal ErrorやWP-Cron、バックグラウンド処理の異常を監視できると、公開ページが表示されていても裏側でWooCommerceの定期処理が失敗している状態に気付きやすくなります。
ECサイトでは、トップページが200を返すことだけでは足りません。注文・決済・メールだけでなく、ログ削除やスケジュール処理も保守対象に含める必要があります。
あわせて確認したい記事
WooCommerceのAction Schedulerでpast-due actionsが増えるときの確認方法 と、WordPressのWP-Cronが止まったときの確認チェックリスト を確認してください。Fatal Error全般は、WordPress Fatal Errorの原因と確認方法 が近いです。
まとめ
WooCommerceのログ削除処理で ftp_nlist() のFatal Errorが出る場合、注文データよりも先に、WooCommerceログ削除、Action Scheduler、WordPressファイルシステム方式を確認します。
失敗ジョブを削除するだけで終わらせず、WooCommerce更新、FTPExt接続、サーバー設定、ログ削除の再実行まで確認してください。
※本記事では、公開されている事例や保守現場での知見をもとに、実務で確認すべきポイントを整理しています。
この記事を書いた人
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社の料金ページを確認し、金額の差がどの作業から生まれるか、改ざんされたあとの復旧が料金に入っているか、見積もりで確かめることを整理します。
