Strony internetowe i programowanie

WordPress Cron nie działa? Jak naprawić zaplanowane zadania i pominięte wpisy

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

Zaplanowane wpisy w WordPressie nie publikują się? Dowiedz się, jak krok po kroku diagnozować problemy z WP-Cron, sprawdzać zaplanowane zdarzenia, naprawiać błędy loopback i konfigurować niezawodne zadanie cron na serwerze.

WordPress Cron nie działa? Jak naprawić zaplanowane zadania i przegapione posty

Planujesz artykuł w WordPressie na 9:00 rano. O 9:30 wciąż się nie pojawił.

Albo może Twoje e-maile z WooCommerce docierają z opóźnieniem, zaplanowane kopie zapasowe nigdy się nie uruchamiają, albo wtyczka zgłasza, że jej zadania w tle są przeterminowane.

Te problemy często mają coś wspólnego: WP-Cron, wbudowany w WordPress system planowania zadań.

WP-Cron jest wygodny, ponieważ działa bez konieczności posiadania dostępu do harmonogramu zadań serwera hostingowego. Ale w przeciwieństwie do tradycyjnego zadania cron systemu, nie działa nieprzerwanie w tle.

W tym przewodniku dowiesz się, jak działa WP-Cron, jak zidentyfikować przyczynę opóźnionych zadań i jak w razie potrzeby zastąpić jego domyślny mechanizm wyzwalania niezawodnym zadaniem cron na serwerze.

Omówimy zarówno hosting współdzielony, jak i serwery z dostępem do wiersza poleceń.

1. Jak WP-Cron działa w rzeczywistości

Tradycyjny demon cron w Linuxie sprawdza swój harmonogram niezależnie od ruchu na stronie internetowej.

WP-Cron działa inaczej. WordPress sprawdza zaplanowane zadania podczas normalnej aktywności na stronie i, w stosownych przypadkach, próbuje wysłać żądanie do wp-cron.php.

Oznacza to, że zaplanowane zdarzenie nie ma gwarancji wykonania o dokładnie zaplanowanej godzinie.

Wyobraź sobie stronę internetową, której ostatni gość odwiedza ją o 22:00. Kopia zapasowa jest zaplanowana na 2:00 w nocy, ale nikt nie odwiedza strony w nocy.

Kopia zapasowa może nie rozpocząć się, dopóki WordPress nie otrzyma kolejnego żądania, które uruchomi jego system planowania.

Różnice między dwiema metodami planowania

Domyślny WP-Cron: Żądanie od odwiedzającego → WordPress sprawdza zdarzenia → Zadania należne się uruchamiają. Zależy od żądań do WordPressa.

Cron na serwerze: Harmonogram serwera → Uruchamia się co pięć minut → Zadania należne się uruchamiają. Działa niezależnie od ruchu odwiedzających.

Zadanie cron na serwerze nie zmienia sposobu, w jaki WordPress przechowuje zaplanowane zdarzenia. Po prostu zapewnia bardziej przewidywalny sposób sprawdzania i wykonywania ich.

2. Rozpoznaj objawy przed wprowadzeniem jakichkolwiek zmian

Nie każda opóźniona operacja w WordPressie jest spowodowana przez WP-Cron.

Zacznij od zidentyfikowania rzeczywistego objawu.

Objaw Możliwe wyjaśnienie
Zaplanowane posty wyświetlają „Przegapiony harmonogram” Wyzwalacz cron opóźniony lub nieudany
Zaplanowane e-maile docierają z opóźnieniem Opóźnienie cron, przetwarzanie kolejki lub problem z dostarczaniem poczty
Automatyczne kopie zapasowe nigdy się nie uruchamiają Brakujące zdarzenie, awaria cron lub błąd wtyczki kopii zapasowej
Akcje WooCommerce pozostają w zawieszeniu Problem z przetwarzaniem Action Scheduler
Kondycja witryny zgłasza błąd pętli zwrotnej WordPress nie może niezawodnie zażądać własnego adresu URL
Zadania uruchamiają się tylko po odwiedzeniu strony Wyzwalanie cron zależne od ruchu

Ważne rozróżnienie polega na różnicy między zadania, które nigdy się nie uruchamia, a zadani, które uruchamiają się, ale kończą niepowodzeniem.

Zastąpienie WP-Cron harmonogramem serwera może rozwiązać pierwszy problem. Nie naprawi automatycznie uszkodzonej wtyczki, niedostępnej bazy danych ani nie działającej usługi e-mail.

3. Najpierw sprawdź Kondycję witryny WordPress

Przed edycją plików konfiguracyjnych otwórz panel administracyjny WordPressa.

  1. Przejdź do Narzędzia → Kondycja witryny.
  2. Otwórz zakładkę Status.
  3. Poszukaj ostrzeżeń związanych z zaplanowanymi zdarzeniami lub żądaniami pętli zwrotnej.
  4. Zanotuj dokładny komunikat przed wprowadzeniem zmian.

Żądanie pętli zwrotnej to żądanie, które WordPress wysyła do własnej witryny.

Jeśli te żądania nie powiodą się, zaplanowane zadania mogą nie zostać wyzwolone poprawnie.

Typowe przyczyny to nieprawidłowy adres URL witryny, problemy z rozpoznawaniem DNS, problemy z certyfikatem SSL, uwierzytelnianie HTTP, ograniczenia zapory ogniowej lub konflikty z wtyczkami i motywami.

Przykład: witryna testowa chroniona hasłem

Załóżmy, że utworzyłeś środowisko testowe WordPressa pod adresem:

https://staging.example.com

Witryna testowa wymaga uwierzytelniania HTTP Basic.

WordPress próbuje zażądać własnego punktu końcowego wp-cron.php, ale serwer zwraca HTTP 401, ponieważ żądanie nie jest uwierzytelnione.

Problemem niekoniecznie jest samo zaplanowane zadanie. Żądanie, które powinno wyzwolić zadanie, jest odrzucane.

W tej sytuacji możesz użyć po stronie serwera harmonogramu CLI, który omija publiczną trasę pętli zwrotnej HTTP, lub skonfigurować środowisko tak, aby wewnętrzne żądania WordPressa działały poprawnie.

Nie usuwaj ochrony hasłem z witryny testowej tylko po to, aby uruchomić cron.

4. Sprawdzaj zaplanowane zadania za pomocą WP-CLI

Jeśli masz dostęp SSH i zainstalowane WP-CLI, możesz bezpośrednio zbadać harmonogram.

Po pierwsze, przejdź do katalogu instalacji WordPressa.

cd /path/to/wordpress

Następnie wypisz zaplanowane zdarzenia:

wp cron event list

Zobaczysz informacje takie jak nazwa haczyka, następne zaplanowane wykonanie i powtarzalność.

Dla wyjścia czytelnego przez maszynę:

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

Na co zwrócić uwagę?

Zwróć uwagę na zdarzenia, których następny czas wykonania już minął.

Przeterminowane zdarzenie jest przydatnym ostrzeżeniem, ale samo w sobie nie dowodzi, że cały harmonogram jest uszkodzony.

Sprawdź, czy wiele niepowiązanych haczyków jest przeterminowanych. Jeśli tak, zbadaj globalny mechanizm wyzwalania.

Illustration of the article's main concept

Jeśli dotyczą to tylko zdarzenia jednej wtyczki, zbadaj najpierw tę wtyczkę.

Uruchamiaj należne zadania ręcznie

W środowisku testowym lub po potwierdzeniu konsekwencji na produkcji, uruchom:

wp cron event run --due-now

Prosi WordPress o wykonanie zdarzeń, które są obecnie należne.

Uważaj: to polecenie wykonuje prawdziwą pracę. Może opublikować zaplanowaną treść, wysłać wiadomości, zainicjować kopie zapasowe lub uruchomić operacje e-commerce.

To nie jest bezpieczna podgląd diagnostyczny.

Jeśli zakończy się pomyślnie, ale zadania ponownie staną się przeterminowane, problemem może być automatyczny mechanizm wyzwalania, a nie wywołania zwrotne zadań.

5. Zastąp WP-Cron zależny od ruchu zadaniem cron na serwerze

Dla witryny produkcyjnej, w której zaplanowane zadania są ważne, zadanie cron na serwerze jest często lepszym wyborem.

Cel jest prosty:

  • Zatrzymaj próby automatycznego uruchamiania WP-Cron przez WordPressa przy normalnych żądaniach stron.
  • Poproś serwer o przetwarzanie należnych zdarzeń w regularnych odstępach czasu.

Krok 1: edytuj wp-config.php

Zrób kopię zapasową wp-config.php.

Dodaj tę konfigurację przed linią, która każe przestać edytować:

define('DISABLE_WP_CRON', true);

To wyłącza domyślne automatyczne uruchamianie cron przez WordPressa. Nie usuwa zaplanowanych zdarzeń przechowywanych przez WordPressa.

Krok 2: utwórz zaplanowane zadanie na serwerze hostingu

Otwórz panel sterowania hostingu i znajdź harmonogram zadań cron.

W standardowej instalacji WordPressa możesz zaplanować polecenie PHP CLI podobne do:

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

Zamień zarówno ścieżkę do pliku wykonywalnego PHP, jak i ścieżkę do instalacji WordPressa na rzeczywiste wartości podane przez hosta.

Polecenie musi uruchamiać poprawną wersję PHP i mieć uprawnienia do odczytu plików WordPressa.

Jeśli zainstalowane jest WP-CLI, inną opcją jest:

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

Ta alternatywa wyraźnie przetwarza należne zdarzenia WordPressa za pośrednictwem WP-CLI.

Użyj jednej metody planowania dla danej instalacji zamiast konfigurować kilka niezależnych zadań cron robiących to samo.

Krok 3: wybierz odpowiedni odstęp czasu

Dla typowej strony internetowej pięć minut jest rozsądnym punktem wyjścia.

Odstęp wykonania Wywołań harmonogramu dziennie Maksymalne opóźnienie sondowania* Przykładowe wyrażenie crontab
1 minuta 1 440 1 minuta * * * * *
5 minut 288 5 minut */5 * * * *
10 minut 144 10 minut */10 * * * *
15 minut 96 15 minut */15 * * * *
30 minut 48 30 minut */30 * * * *

*Zakłada sprawnie działający harmonogram i krótkotrwałe zadania. Rzeczywiste wykonanie może być opóźnione przez obciążenie serwera lub długotrwałe wywołania zwrotne.

Na przykład, co pięć minut:

*/5 * * * *

Odstęp jedną minutę oferuje częstsze sprawdzanie, ale nie jest konieczny dla każdej strony internetowej.

Dla bloga o niskim ruchu pięć lub dziesięć minut może być w zupełności wystarczące. Dla ruchomego sklepu internetowego może być konieczne częstsze przetwarzanie, w zależności od obciążenia w tle.

Krok 4: przetestuj wynik

Po skonfigurowaniu zadania serwera poczekaj co najmniej dwa zaplanowane odstępy czasu.

Następnie ponownie sprawdź listę zdarzeń:

wp cron event list

Potwierdź, że wcześniej przeterminowane zdarzenia zostały przetworzone.

Sprawdź również dzienniki cron hostingu.

Należy również zweryfikować rzeczywistą operację biznesową: zaplanowany post testowy, nieinwazyjne zadanie konserwacyjne lub inną operację, której wynik można bezpiecznie obserwować.

6. Co jeśli Twój host nie zapewnia dostępu SSH?

Nadal możesz skonfigurować zadanie cron na serwerze w wielu planach hostingu współdzielonego.

Niektóre panele hostingu obsługują zaplanowane żądanie URL, na przykład:

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

Inne oferują wykonywanie poleceń PHP bez zapewniania interaktywnego terminala SSH.

W miarę możliwości preferuj zadanie PHP CLI. Zaplanowane żądanie HTTP może być dotknięte przekierowaniami, ograniczeniami dostępu, regułami bezpieczeństwa lub problemami sieciowymi.

Jeśli Twój panel hostingu obsługuje tylko żądania HTTP, potwierdź, że punkt końcowy jest dostępny i że żądanie faktycznie wyzwala należne zadania.

Nie zakładaj, że otrzymanie odpowiedzi HTTP 200 dowodzi, że każde zaplanowane wywołanie zwrotne zakończyło się pomyślnie.

Technical workflow illustration

7. Stwórz bezpieczne zdarzenie testowe

Dla deweloperów mała wtyczka testowa może pomóc potwierdzić, że system planowania działa niezależnie od istniejących wtyczek.

Stwórz ten plik:

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

Dodaj:

<?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');
});

Aktywuj wtyczkę z panelu administracyjnego WordPressa.

Rejestruje zdarzenie godzinowe, które zapisuje prosty komunikat diagnostyczny do dziennika błędów PHP. Nie wysyła e-maili, nie zmienia treści ani nie wykonuje zewnętrznych żądań sieciowych.

Pierwsze zdarzenie jest zaplanowane około minuty po aktywacji.

Aby przetestować go natychmiast po aktywacji za pomocą WP-CLI:

wp cron event run ceikay_cron_test

Sprawdź dziennik błędów PHP pod kątem komunikatu podobnego do:

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

Znacznik czasu jest tylko przykładem.

Jeśli wolisz przetestować automatyczny harmonogram zamiast ręcznie wykonywać haczyk, poczekaj, aż zdarzenie stanie się należne, i pozwól skonfigurowanemu mechanizmowi cron je przetworzyć.

Po zakończeniu testów dezaktywuj i usuń wtyczkę diagnostyczną.

8. Rozwiązywanie problemów: zadanie cron jest uruchamiane, ale zadania nadal kończą się niepowodzeniem

Sprawny wyzwalacz cron to tylko jedna część systemu.

Jeśli Twój harmonogram serwera działa pomyślnie, ale operacje WordPressa nadal kończą się niepowodzeniem, użyj poniższej tabeli diagnostycznej.

Problem Co sprawdzić Sugerowana akcja
Brak wymienionych zdarzeń zaplanowanych Wtyczka mogła nie zarejestrować swojego haczyka Sprawdź aktywację wtyczki i kod planowania
Zdarzenia nadal są przeterminowane Zadanie serwera może nie być wykonywane Sprawdź dzienniki cron, ścieżkę PHP i uprawnienia
Błąd krytyczny PHP Wywołanie zwrotne zadania lub awaria wtyczki Zbadaj dzienniki błędów PHP i śledzenie stosu
HTTP 401 lub 403 Uwierzytelnianie lub zapora ogniowa Przejrzyj ograniczenia dostępu pętli zwrotnej
HTTP 500 Awaria aplikacji lub serwera Zbadaj dzienniki PHP/serwera
Zdarzenia są wykonywane, ale e-maile nie docierają Problem z transportem poczty Sprawdź dzienniki SMTP lub dostarczania poczty e-mail
Duplikaty wykonania Zduplikowane harmonogramy lub nakładające się procesy Zbadaj haczyki, argumenty i blokowanie
Akcje WooCommerce pozostają w zawieszeniu Kolejka Action Scheduler Zbadaj interfejs zaplanowanych akcji i indywidualne awarie

Nie usuwaj bezmyślnie przeterminowanych zdarzeń

Może być kuszące, aby usunąć każde zdarzenie, które wydaje się zawieszone.

Unikaj tego.

Zdarzenie może reprezentować legitymną zaplanowaną operację związaną z płatnością, zadanie przetwarzania zamówienia, dostarczanie wiadomości e-mail lub kopię zapasową.

Usunięcie zdarzenia może usunąć zaplanowaną pracę bez naprawy podstawowego problemu.

WP-CLI zapewnia polecenia do usuwania zdarzeń, ale należy ich używać tylko po zidentyfikowaniu haczyka i zrozumieniu jego celu.

9. Unikaj zduplikowanych zaplanowanych zdarzeń we własnych wtyczkach

Jeśli tworzysz wtyczkę WordPressa, powszechnym błędem jest wielokrotne rejestrowanie tego samego zdarzenia cyklicznego.

Na przykład, planowanie zadania przy każdym ładowaniu strony bez sprawdzania, czy już istnieje.

Prawidłowe podejście polega na sprawdzeniu najpierw:

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

Następnie zarejestruj wywołanie zwrotne osobno:

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

Jeśli zdarzenie przyjmuje argumenty, używaj spójnych argumentów podczas planowania, sprawdzania i czyszczenia go. WordPress używa haczyka i argumentów do rozróżniania zaplanowanych zdarzeń.

Weź pod uwagę również czas wykonania. Zadanie, które przetwarza tysiące rekordów w jednym żądaniu, może wyczerpać limit czasu wykonania PHP lub pamięć.

W przypadku dużych obciążeń przetwarzaj dane w małych partiach, spraw, aby operacje były bezpieczne do ponowienia, i rejestruj postęp.

10. Praktyczna lista kontrolna dla niezawodnego harmonogramu WordPressa

Zanim uznasz problem za rozwiązany, zweryfikuj te punkty:

  • [ ] Kondycja witryny WordPress nie wykazuje nieuzasadnionych błędów planowania ani pętli zwrotnej.
  • [ ] Oczekiwane haczyki zaplanowane istnieją.
  • [ ] Cron serwera wykonuje się w zamierzonym odstępie czasu.
  • [ ] DISABLE_WP_CRON jest skonfigurowany tylko po przygotowaniu alternatywnego wyzwalacza.
  • [ ] Zadanie cron używa poprawnego pliku wykonywalnego PHP i ścieżki WordPressa.
  • [ ] Prawdziwe zaplanowane zadanie kończy się pomyślnie.
  • [ ] Można sprawdzić dzienniki, gdy zadanie kończy się niepowodzeniem.
  • [ ] Nie jest aktywna żadna zduplikowana konfiguracja harmonogramu.
  • [ ] Operacje krytyczne mają własne monitorowanie lub alerty o awariach.

Niezawodny harmonogram to nie tylko taki, który działa. To taki, którego awarie możesz zidentyfikować i zbadać.

11. Wnioski końcowe: kiedy warto używać crona na serwerze?

Dla małego osobistego bloga z okazjonalnymi odwiedzającymi i bez automatyzacji wrażliwej na czas, domyślny WP-Cron może być w zupełności wystarczający.

Ale jeśli Twoja strona internetowa opiera się na zaplanowanej publikacji, konserwacji w tle, przetwarzaniu e-commerce lub innych powtarzających się operacjach, warto rozważyć zadanie cron na serwerze.

Poprawa nie polega na tym, że cron serwera magicznie sprawia, że każda wtyczka WordPressa jest niezawodna. Usuwa on jedno ważne źródło niepewności: zależność od przychodzących żądań witryny do wyzwalania należnych zdarzeń.

Zacznij od zdiagnozowania rzeczywistej awarii, sprawdź zaplanowane zdarzenia i dopiero wtedy zmień mechanizm wyzwalania.

To podejście jest bezpieczniejsze niż instalowanie kolejnej wtyczki lub modyfikowanie ustawień konfiguracyjnych bez wiedzy, co poszło nie tak.