Web・開発

WordPress Cron が動作しない?スケジュールされたタスクと投稿の遅延を修正する方法

WordPress Cron Not Working? How to Fix Scheduled Tasks and Missed Posts

WordPress のスケジュール投稿が公開されない?WP-Cron の問題を診断し、スケジュールイベントを確認し、ループバックエラーを修正し、信頼できるサーバーの cron ジョブを段階的に設定する方法を学びましょう。

WordPress Cron が動作しない?スケジュールされたタスクと投稿未公開の修正方法

9:00 AM に WordPress の記事を予約投稿した。9:30 になってもまだ表示されない。

あるいは、WooCommerce のメールが届くのが遅い、予約バックアップが開始されない、プラグインがバックグラウンドタスクの期限超過を報告している、ということもあるだろう。

これらの問題にはしばしば共通点がある。WordPress の組み込みタスクスケジューリングシステム、WP-Cron だ。

WP-Cron は、ホスティングサーバーのタスクスケジューラへのアクセスを必要とせずに動作するため便利である。しかし、従来のシステム cron ジョブとは異なり、バックグラウンドで継続的に実行されるわけではない。

このガイドでは、WP-Cron の仕組み、タスクの遅延原因の特定方法、必要に応じてデフォルトのトリガー仕組みを信頼性の高いサーバー cron ジョブに置き換える方法について学ぶ。

共有ホスティングとコマンドラインアクセス可能なサーバーの両方について解説する。

1. WP-Cron の実際の仕組み

従来の Linux cron デーモンは、Web サイトのトラフィックとは独立してスケジュールを確認する。

WP-Cron は異なる仕組みで動作する。WordPress は通常の Web サイト活動中にスケジュールされたタスクを確認し、適切な場合に wp-cron.php へのリクエストを発行しようとする。

つまり、スケジュールイベントが正確な予定時刻に実行される保証はない。

最終訪問者が午後 10 時の Web サイトを想像してみよう。午前 2 時にバックアップがスケジュールされているが、夜間に訪問者はない。

バックアップが開始されるのは、WordPress がスケジューリングシステムをトリガーする別のリクエストを受信するまでかもしれない。

2 つのスケジューリング方法の違い

デフォルトの WP-Cron: 訪問者のリクエスト → WordPress がイベントを確認 → 期限のタスクが開始される。WordPress のリクエストに依存する。

サーバー cron: サーバースケジューラ → 5 分ごとに実行 → 期限のタスクが開始される。訪問者のトラフィックとは独立して動作する。

サーバー cron ジョブは、WordPress がスケジュールイベントを保存する方法を変更しない。単に、それらを確認し実行するより予測可能な方法を提供するだけである。

2. 何かを変更する前に症状を認識する

WordPress の操作が遅延するすべてが WP-Cron によって引き起こされるわけではない。

まず実際の症状を特定することから始める。

症状 考えられる説明
予約投稿に「スケジュールを逃しました」と表示される Cron トリガーの遅延または失敗
予約メールが遅れて届く Cron の遅延、キュー処理、またはメール配信の問題
自動バックアップが開始されない イベントの欠落、cron の失敗、またはバックアッププラグインのエラー
WooCommerce アクションが保留のまま Action Scheduler の処理問題
Site Health がループバックエラーを報告する WordPress が独自の URL を信頼性を持ってリクエストできない
Web サイトを訪問した後にのみタスクが実行される トラフィック依存の cron トリガー

重要な区別は、決して開始されないタスクと開始はするが失敗するタスクの違いである。

WP-Cron をサーバースケジューラに置き換えると、前者の問題は解決するかもしれない。しかし、壊れたプラグイン、利用できないデータベース、または機能しないメールサービスを自動的に修復するわけではない。

3. まず WordPress のサイトヘルスを確認する

設定ファイルに触れる前に、WordPress の管理画面を開く。

  1. ツール → サイトヘルス に移動する。
  2. ステータス タブを開く。
  3. スケジュールイベントまたはループバックリクエストに関連する警告を探す。
  4. 変更を行う前に正確なメッセージを記録する。

ループバックリクエストとは、WordPress が自分の Web サイトに対して行うリクエストのことである。

これらのリクエストが失敗すると、スケジュールされたタスクが正しくトリガーされない可能性がある。

一般的な原因には、間違った Web サイト URL、DNS 解決の問題、SSL 証明書の問題、HTTP 認証、ファイアウォールの制限、プラグインやテーマの競合が含まれる。

例: パスワードで保護されたステージングサイト

例えば、以下のような WordPress ステージング環境を作成したとする:

https://staging.example.com

ステージングサイトは HTTP ベーシック認証を必要とする。

WordPress は独自の wp-cron.php エンドポイントにリクエストを試みるが、リクエストが認証されていないためサーバーは HTTP 401 を返す。

問題は必ずしもスケジュールタスク自体ではない。タスクをトリガーするはずのリクエストが拒否されている。

このような場合、公開 HTTP ループバック経路を回避するサーバーサイドの CLI スケジューラを使用するか、WordPress の内部リクエストが正しく機能するよう環境を設定できる。

ステージングサイトからパスワード保護を cron を動作させるためだけに削除しないでください。

4. WP-CLI でスケジュールタスクを調べる

SSH アクセス権があり WP-CLI がインストールされている場合、スケジューラを直接調べることができる。

まず、WordPress のインストールディレクトリに移動する。

cd /path/to/wordpress

次に、スケジュールイベントを一覧表示する:

wp cron event list

フック名、次回の予定実行時刻、繰り返し間隔などの情報が表示される。

マシンが読み取れる出力を得るには:

wp cron event list --fields=hook,next_run_gmt,recurrence --format=json

何に注目すべきか?

次回の実行時刻が過去のイベントに注目する。

期限切れのイベントは有用な警告兆候だが、1 つの期限切れイベントだけではスケジューラ全体が壊れているとは言い切れない。

複数の無関係なフックが期限切れになっていないか確認する。その場合、グローバルなトリガー仕組みを調査する。

Illustration of the article's main concept

1 つのプラグインのイベントのみが影響を受けている場合は、まずそのプラグインを調べる。

期限のタスクを手動で実行する

ステージング環境、または本番環境での影響を確認した上で、実行する:

wp cron event run --due-now

これは WordPress に対し、現在期限のイベントを実行するよう依頼する。

注意:このコマンドは実際の処理を実行する。予約コンテンツを公開したり、メッセージを送信したり、バックアップを開始したり、e コマース操作をトリガーしたりする可能性がある。

無害な診断プレビューではない。

正常に完了してもタスクが後で再び期限切れになる場合、問題はタスクのコールバックではなく自動トリガー仕組みである可能性がある。

5. トラフィック依存の WP-Cron をサーバー cron ジョブに置き換える

スケジュールタスクが重要な本番 Web サイトでは、サーバー cron ジョブがより良い選択肢となることが多い。

目的は明確だ:

  • WordPress が通常のページリクエストで自動的に WP-Cron を起動しようとするのを止める。
  • サーバーに定期的に期限のイベントを処理するよう依頼する。

ステップ 1: wp-config.php を編集する

wp-config.php のバックアップを作成する。

編集を中止するよう指示する行の前に、この設定を追加する:

define('DISABLE_WP_CRON', true);

これは WordPress のデフォルトの自動 cron 起動を無効にする。WordPress によって保存されたスケジュールイベントを削除しない。

ステップ 2: ホスティングサーバーにスケジュールタスクを作成する

ホスティングコントロールパネルを開き、cron ジョブスケジューラを探す。

通常の WordPress インストールでは、次のような PHP CLI コマンドをスケジュールできる:

/usr/bin/php /home/account/public_html/wp-cron.php

PHP 実行ファイルのパスと WordPress インストールパスを、ホストが提供する実際の値に置き換える。

コマンドは正しい PHP バージョンで実行され、WordPress ファイルを読み取る権限を持っている必要がある。

WP-CLI がインストールされている場合、別の選択肢は:

cd /home/account/public_html && /usr/local/bin/wp cron event run --due-now

この代替方法は、WP-CLI を介して期限の WordPress イベントを明示的に処理する。

特定のインストールに対しては、複数の独立した cron ジョブを同じことを実行するよう設定するのではなく、1 つのスケジューリング方法を使用する。

ステップ 3: 適切な間隔を選択する

一般的な Web サイトでは、5 分が適切な開始点となる。

実行間隔 1 日あたりのスケジューラ呼び出し回数 最大ポーリング遅延* crontab 表現の例
1 分 1,440 1 分 * * * * *
5 分 288 5 分 */5 * * * *
10 分 144 10 分 */10 * * * *
15 分 96 15 分 */15 * * * *
30 分 48 30 分 */30 * * * *
  • スケジューラが正常に機能し、タスクの実行時間が短いことを前提とする。実際の実行はサーバー負荷や実行時間の長いコールバックによって遅延する可能性がある。

例えば、5 分ごと:

*/5 * * * *

1 分間隔はより頻繁なチェックを提供するが、すべての Web サイトに必要というわけではない。

トラフィックの少ないブログでは 5 分または 10 分で十分な場合もある。忙しい e コマースストアでは、バックグラウンドのワークロードに応じてより頻繁な処理が必要になるかもしれない。

ステップ 4: 結果をテストする

サーバージョブを設定したら、少なくとも 2 つのスケジュール間隔を待つ。

その後、イベントリストを再度確認する:

wp cron event list

以前に期限切れだったイベントが処理されたことを確認する。

ホスティングの cron ログも確認する。

予約テスト投稿、無害なメンテナンスタスク、または結果を安全に観察できる別の操作など、実際の業務操作も検証すべきである。

6. ホストが SSH アクセスを提供していない場合は?

多くの共有ホスティングプランでは、サーバー cron ジョブをまだ設定できる。

予約 URL リクエストをサポートするホスティングパネルもある。例えば:

https://example.com/wp-cron.php

対話型の SSH ターミナルを提供せずに PHP コマンドの実行を提供するものもある。

サポートされている場合は PHP CLI タスクを優先する。予約 HTTP リクエストは、リダイレクト、アクセス制限、セキュリティルール、ネットワーク問題の影響を受ける可能性がある。

ホスティングパネルが HTTP リクエストのみをサポートしている場合、エンドポイントに到達できること、およびリクエストが実際に期限のタスクをトリガーしていることを確認する。

HTTP 200 応答を受信したからといって、すべてのスケジュールコールバックが正常に完了したと想定してはならない。

Technical workflow illustration

7. 安全なテストイベントを作成する

開発者向けに、小さなテストプラグインを使うと、既存のプラグインとは独立してスケジューリングシステムが機能しているか確認しやすい。

このファイルを作成する:

wp-content/plugins/ceikay-cron-test/ceikay-cron-test.php

次を追加する:

<?php
/**
 * Plugin Name: CeiKay Cron Test
 * Description: Temporary diagnostic cron event.
 */

if (!defined('ABSPATH')) {
    exit;
}

add_action('ceikay_cron_test', function () {
    error_log(
        'CeiKay cron test executed at ' .
        gmdate('Y-m-d H:i:s') .
        ' UTC'
    );
});

register_activation_hook(__FILE__, function () {
    if (!wp_next_scheduled('ceikay_cron_test')) {
        wp_schedule_event(
            time() + 60,
            'hourly',
            'ceikay_cron_test'
        );
    }
});

register_deactivation_hook(__FILE__, function () {
    wp_clear_scheduled_hook('ceikay_cron_test');
});

WordPress 管理画面からプラグインを有効化する。

これは 1 時間ごとのイベントを登録し、PHP エラーログに単純な診断メッセージを書き込む。メールの送信、コンテンツの変更、外部ネットワークリクエストは行わない。

最初のイベントは有効化から約 1 分後にスケジュールされる。

WP-CLI で有効化直後にテストするには:

wp cron event run ceikay_cron_test

PHP エラーログに次のようなメッセージがあるか確認する:

CeiKay cron test executed at 2026-11-18 07:30:00 UTC

タイムスタンプはあくまで例である。

フックを手動で実行するのではなく自動スケジューラをテストしたい場合は、イベントが期限になるまで待ち、設定済みの cron 仕組みに処理させる。

テストが完了したら、診断プラグインを無効化し削除する。

8. トラブルシューティング: cron ジョブは実行されるがタスクは依然として失敗する

動作する cron トリガーはシステムの一部に過ぎない。

サーバースケジューラが正常に実行されても WordPress の操作が失敗し続ける場合、以下の診断表を使用する。

問題 確認すべき点 推奨アクション
スケジュールイベントが一覧に表示されない プラグインがフックを登録していない可能性がある プラグインの有効化とスケジュールコードを確認する
イベントが期限切れのまま サーバージョブが実行されていない可能性がある cron ログ、PHP パス、権限を確認する
PHP 致命的エラー タスクコールバックまたはプラグインの失敗 PHP エラーログとスタックトレースを調べる
HTTP 401 または 403 認証またはファイアウォール ループバックアクセス制限を確認する
HTTP 500 アプリケーションまたはサーバーの障害 PHP/サーバーログを調べる
イベントは実行されるがメールが届かない メール転送の問題 SMTP またはメール配信ログを確認する
重複実行 重複スケジュールまたは重複プロセス フック、引数、ロックを調べる
WooCommerce アクションが保留のまま Action Scheduler のバックログ スケジュールアクションのインターフェースと個別の失敗を調べる

期限切れのイベントを無闇に削除しないでください

行き詰まっているように見えるイベントをすべて削除したくなるかもしれない。

そうしないでください。

イベントは、正当な予約済みの支払い関連操作、注文処理タスク、メール配信、またはバックアップを表している可能性がある。

イベントを削除すると、根本的な問題を修復せずに予約された作業を削除してしまう可能性がある。

WP-CLI にはイベントを削除するコマンドが用意されているが、フックを特定しその目的を理解した後にのみ使用すべきである。

9. 自分のプラグインで重複したスケジュールイベントを避ける

WordPress プラグインを開発している場合、同じ繰り返しイベントを繰り返し登録するというよくあるミスがある。

例えば、既に存在するか確認せずにページ読み込みごとにタスクをスケジュールすることだ。

正しいアプローチは、まず確認することである:

if (!wp_next_scheduled('myplugin_daily_cleanup')) {
    wp_schedule_event(
        time() + HOUR_IN_SECONDS,
        'daily',
        'myplugin_daily_cleanup'
    );
}

その後、コールバックを個別に登録する:

add_action('myplugin_daily_cleanup', function () {
    // Perform a small, bounded maintenance task.
});

イベントが引数を受け取る場合、スケジュール、確認、削除の際に一貫した引数を使用する。WordPress はフックと引数を使用してスケジュールイベントを区別する。

実行時間も考慮する必要がある。1 つのリクエストで数千件のレコードを処理するタスクは、PHP の実行時間またはメモリを使い果たす可能性がある。

大量のワークロードの場合、データを小さなバッチで処理し、操作を再試行可能にし、進行状況を記録する。

10. 信頼性の高い WordPress スケジューラのための実践的チェックリスト

問題が解決したと判断する前に、以下の点を確認する:

  • [ ] WordPress サイトヘルスに説明のつかないスケジュールエラーまたはループバックエラーが表示されない。
  • [ ] 予想されるスケジュールフックが存在する。
  • [ ] サーバー cron が意図した間隔で実行される。
  • [ ] DISABLE_WP_CRON は、代替トリガーが準備できてからのみ設定される。
  • [ ] cron ジョブが正しい PHP 実行ファイルと WordPress パスを使用する。
  • [ ] 実際のスケジュールタスクが正常に完了する。
  • [ ] タスクが失敗したときにログを参照できる。
  • [ ] 重複したスケジューラ設定が有効になっていない。
  • [ ] 重要な操作に独自の監視または障害アラートがある。

信頼性の高いスケジューラとは、単に実行されるものではない。障害を特定し調査できるものである。

11. 最後の考え: サーバー cron を使用すべきとき

訪問者が少なく時間に敏感な自動化のない小規模な個人ブログでは、デフォルトの WP-Cron で十分である場合が多い。

しかし、Web サイトが予約投稿、バックグラウンドメンテナンス、e コマース処理、またはその他の繰り返し操作に依存している場合は、サーバー cron ジョブを検討する価値がある。

改善点は、サーバー cron が魔法のようにすべての WordPress プラグインを信頼性の高いものにすることではない。それは、期限のイベントをトリガーするために入ってくる Web サイトリクエストに依存するという、重要な不確実性の源を排除することである。

まず実際の障害を診断し、スケジュールイベントを調査し、そして初めてトリガー仕組みを変更する。

このアプローチは、何が間違っていたかも知らずに別のプラグインをインストールしたり設定を変更したりするよりも安全である。