WordPress Cron nefunguje? Jak opravit naplánované úlohy a zmeškané příspěvky
Naplánované příspěvky ve WordPressu se nezveřejňují? Zjistěte, jak diagnostikovat problémy s WP-Cron, zkontrolovat naplánované události, opravit chyby loopback a nakonfigurovat spolehlivý serverový cron job krok za krokem.
Naplánujete WordPress článek na 9:00 ráno. V 9:30 se stále neobjevil.
Nebo vaše WooCommerce e-maily dorazí pozdě, naplánované zálohy se nespustí, nebo plugin hlásí, že jeho úlohy na pozadí jsou zpožděné.
Tyto problémy často mají společnou příčinu: WP-Cron, vestavěný systém pro plánování úloh ve WordPressu.
WP-Cron je pohodlný, protože funguje bez nutnosti přístupu k plánovači úloh na vašem hostovacím serveru. Ale na rozdíl od tradičního systémového cron jobu neběží nepřetržitě na pozadí.
V této příručce se naučíte, jak WP-Cron funguje, jak identifikovat příčinu zpožděných úloh a jak nahradit jeho výchozí mechanismus spouštění spolehlivým serverovým cron jobem, když je to nutné.
Projdeme si jak sdílený hosting, tak servery s přístupem k příkazovému řádku.
1. Jak WP-Cron skutečně funguje
Tradiční linuxový cron daemon kontroluje svůj plán nezávisle na provozu webu.
WP-Cron funguje jinak. WordPress kontroluje naplánované úlohy během normální aktivity na webu a v případě potřeby se pokusí spustit požadavek na wp-cron.php.
To znamená, že naplánovaná událost není zaručeno, že se provede v přesně naplánovaném čase.
Představte si web, který obdrží svého posledního návštěvníka v 22:00. Záloha je naplánována na 2:00 ráno, ale nikdo web celou noc nenavštíví.
Záloha se možná nespustí, dokud WordPress neobdrží další požadavek, který spustí jeho plánovací systém.
Jak se liší tyto dvě metody plánování
Výchozí WP-Cron: Požadavek návštěvníka → WordPress kontroluje události → Splněné úlohy se spustí. Závisí na WordPress požadavcích.
Serverový cron: Plánovač serveru → Spustí každých pět minut → Splněné úlohy se spustí. Funguje nezávisle na provozu návštěvníků.
Serverový cron job nemění způsob, jakým WordPress ukládá naplánované události. Jednoduše poskytuje předvídatelnější způsob, jak je kontrolovat a provádět.
2. Rozpoznat příznaky dřív než cokoliv změníte
Ne každá zpožděná WordPress operace je způsobena WP-Cronem.
Začněte identifikací skutečného příznaku.
| Příznak | Možné vysvětlení |
|---|---|
| Naplánované příspěvky ukazují "Zmeškáno naplánování" | Spouštění cronu zpožděno nebo selhalo |
| Naplánované e-maily dorazí pozdě | Zpoždění cronu, zpracování fronty, nebo problém s doručováním pošty |
| Automatické zálohy se nespouští | Chybějící událost, selhání cronu, nebo chyba pluginu pro zálohy |
| WooCommerce akce zůvají pending | Problém se zpracováním Action Scheduleru |
| Site Health hlásí chybu loopback requestu | WordPress nemůže spolehlivě požádat svou vlastní URL |
| Úlohy se spustí až po návštěvě webu | Spouštění cronu závislé na provozu |
Důležitý rozdíl je mezi úlohou, která se nikdy nespustí a úlohou, která se spustí, ale selže.
Nahrazení WP-Cronu serverovým plánovačem může vyřešit první problém. Neopraví automaticky rozbitý plugin, nedostupnou databázi, nebo selhávající e-mailovou službu.
3. Nejdřív zkontrolujte WordPress Site Health
Než se dotknete konfiguračních souborů, otevřete administraci WordPressu.
- Jděte na Nástroje → Stav webu.
- Otevřete záložku Stav.
- Hledejte varování související s naplánovanými událostmi nebo loopback požadavky.
- Poznamenejte si přesnou zprávu před provedením změn.
Loopback požadavek je požadavek, který WordPress posílá na svůj vlastní web.
Pokud tyto požadavky selžou, naplánované úlohy nemusí být spouštěny správně.
Běžné příčiny zahrnují nesprávnou URL webu, problémy s DNS překladem, problémy s SSL certifikátem, HTTP autentizaci, omezení firewallu, nebo konflikty s pluginy a tématy.
Příklad: staging web chráněný heslem
Předpokládejme, že jste vytvořili WordPress staging prostředí na:
https://staging.example.com
Staging web vyžaduje HTTP Basic Authentication.
WordPress se pokusí požádat vlastní wp-cron.php endpoint, ale server vrátí HTTP 401, protože požadavek není autentifikován.
Problém není nutně v naplánované úloze samotné. Požadavek, který by úlohu měl spustit, je odmítnut.
V této situaci můžete použít serverový CLI plánovač, který se vyhne veřejné HTTP loopback cestě, nebo nakonfigurovat prostředí tak, aby WordPress interní požadavky fungovaly správně.
Neodstraňujte heslovou ochranu ze staging webu jen proto, aby cron fungoval.
4. Prozkoumejte naplánované úlohy s WP-CLI
Pokud máte SSH přístup a nainstalovaný WP-CLI, můžete prozkoumat plánovač přímo.
Nejprve přejděte do adresáře vaší WordPress instalace.
cd /path/to/wordpress
Pak vypište naplánované události:
wp cron event list
Uvidíte informace jako název hooku, příští naplánované spuštění a opakování.
Pro strojově čitelný výstup:
wp cron event list --fields=hook,next_run_gmt,recurrence --format=json
Na co se dívat?
Zaměřte se na události, jejichž příští čas spuštění je v minulosti.
Zpožděná událost je užitečné varovné signál, ale jedna zpožděná událost sama o sobě nedokazuje, že celý plánovač je rozbitý.
Zkontrolujte, zda více nesouvisejících hooků je zpožděných. Pokud ano, prozkoumejte globální mechanismus spouštění.

Pokud jsou ovlivněny události pouze jednoho pluginu, prozkoumejte ten plugin nejprve.
Spusťte splněné úlohy ručně
Na staging prostředí, nebo po potvrzení důsledků na produkci, spusťte:
wp cron event run --due-now
Toto požádá WordPress, aby provedl události, které jsou aktuálně splněné.
Buďte opatrní: tento příkaz provádí skutečnou práci. Může publikovat naplánovaný obsah, poslat zprávy, iniciovat zálohy, nebo spustit e-commerce operace.
Není to bezpečná diagnostická náhledová ukázka.
Pokud dokončí úspěšně, ale úlohy se později znovu stanou zpožděnými, váš problém může být v automatickém mechanismu spouštění spíše než v callback funkcích úloh.
5. Nahraďte závislý-na-provozu WP-Cron serverovým cron jobem
Pro produkční web, kde na naplánovaných úlohách záleží, je serverový cron job často lepší volbou.
Cíl je přímočarý:
- Zastavit WordPress v pokusech automaticky spouštět WP-Cron při běžných požadavcích na stránky.
- Požádat server, aby zpracovával splněné události v pravidelných intervalech.
Krok 1: upravte wp-config.php
Vytvořte zálohu wp-config.php.
Přidejte tuto konfiguraci před řádek, který vám říká, abyste přestali editovat:
define('DISABLE_WP_CRON', true);
Toto zakáže výchozí automatické spouštění cronu WordPressem. Nesmaže naplánované události uložené WordPressem.
Krok 2: vytvořte naplánovanou úlohu na vašem hostovacím serveru
Otevřete ovládací panel hostingu a najděte jeho plánovač cron jobů.
Pro standardní WordPress instalaci můžete naplánovat PHP CLI příkaz podobný tomuto:
/usr/bin/php /home/account/public_html/wp-cron.php
Nahraďte cestu k PHP spustitelnému souboru i cestu k WordPress instalaci skutečnými hodnotami poskytnutými vaším hostitelem.
Příkaz musí používat správnou PHP verzi a mít oprávnění číst WordPress soubory.
Pokud je nainstalovaný WP-CLI, další možností je:
cd /home/account/public_html && /usr/local/bin/wp cron event run --due-now
Tato alternativa explicitně zpracovává splněné WordPress události přes WP-CLI.
Použijte jeden plánovací metodu pro danou instalaci spíše než konfiguraci několika nezávislých cron jobů, které dělají to samé.
Krok 3: zvolte vhodný interval
Pro typický web je pět minut rozumným výchozím bodem.
| Interval spuštění | Vyvolání plánovače za den | Maximální prodleva dotazování* | Příklad crontab výrazu |
|---|---|---|---|
| 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 * * * * |
*Předpokládá funkční plánovač a krátce běžící úlohy. Skutečné spuštění může být zpožděno zátěží serveru nebo dlouho běžícími callbacky.
Například každých pět minut:
*/5 * * * *
Jednominutový interval nabízí častější kontroly, ale není nutný pro každý web.
Pro blog s nízkým provozem může být pět nebo deset minut zcela dostačující. Pro zatížený e-commerce obchod možná budete potřebovat častější zpracování v závislosti na jeho zátěži na pozadí.
Krok 4: otestujte výsledek
Po konfiguraci serverové úlohy počkejte alespoň dva naplánované intervaly.
Pak znovu prozkoumejte seznam událostí:
wp cron event list
Potvrďte, že dříve zpožděné události byly zpracovány.
Zkontrolujte také cron logy hostingu.
Měli byste také ověřit reálnou obchodní operaci: naplánovaný testovací příspěvek, bezpečnou údržbovou úlohu, nebo jinou operaci, jejíž výsledek lze bezpečně pozorovat.
6. Co když váš hostitel neposkytuje SSH přístup?
Můžete stále nakonfigurovat serverový cron job na mnoha sdílených hostingových plánech.
Některé hostingové panely podporují naplánovaný URL požadavek, například:
https://example.com/wp-cron.php
Jiné nabízejí PHP příkazové provedení bez poskytnutí interaktivního SSH terminálu.
Preferujte PHP CLI úlohu, když je podporována. Naplánovaný HTTP požadavek může být ovlivněn přesměrováními, přístupovými omezeními, bezpečnostními pravidly, nebo síťovými problémy.
Pokud váš hostingový panel podporuje pouze HTTP požadavky, potvrďte, že endpoint je dostupný a že požadavek skutečně spouští splněné úlohy.
Nepředpokládejte, že přijetí HTTP 200 odpovědi dokazuje, že každý naplánovaný callback dokončil úspěšně.

7. Vytvořte bezpečnou testovací událost
Pro vývojáře může malý testovací plugin pomoci potvrdit, že plánovací systém funguje nezávisle na existujících pluginech.
Vytvořte tento soubor:
wp-content/plugins/ceikay-cron-test/ceikay-cron-test.php
Přidejte:
<?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');
});
Aktivujte plugin z administrace WordPressu.
Registruje hodinovou událost, která zapisuje jednoduchou diagnostickou zprávu do PHP error logu. Neposílá e-maily, nemění obsah, nedělá externí síťové požadavky.
První událost je naplánována přibližně minutu po aktivaci.
Pro okamžité testování po aktivaci s WP-CLI:
wp cron event run ceikay_cron_test
Zkontrolujte PHP error log pro zprávu podobnou:
CeiKay cron test executed at 2026-11-18 07:30:00 UTC
Časová razítka je pouze příklad.
Pokud dáváte přednost testování automatického plánovače spíše než ručního spouštění hooku, počkejte, až událost se stane splněnou, a nechte nakonfigurovaný cron mechanismus ji zpracovat.
Po dokončení testování deaktivujte a smažte diagnostický plugin.
8. Řešení problémů: cron job běží, ale úlohy stále selžou
Fungující cron spouštěcí mechanismus je jen jedna část systému.
Pokud váš serverový plánovač běží úspěšně, ale WordPress operace nadále selžou, použijte následující diagnostickou tabulku.
| Problém | Co zkontrolovat | Navrhovaná akce |
|---|---|---|
| Žádné naplánované události nejsou uvedeny | Plugin nemusel zaregistrovat svůj hook | Zkontrolujte aktivaci pluginu a plánovací kód |
| Události zůstávají zpožděné | Serverová úloha nemusí být prováděna | Zkontrolujte cron logy, PHP cestu a oprávnění |
| PHP fatální chyba | Selhání task callbacku nebo pluginu | Prozkoumejte PHP error logy a stack trace |
| HTTP 401 nebo 403 | Autentizace nebo firewall | Zkontrolujte omezení loopback přístupu |
| HTTP 500 | Selhání aplikace nebo serveru | Prozkoumejte PHP/server logy |
| Události se provádějí, ale e-maily nedocházejí | Problém s mail transportem | Zkontrolujte SMTP nebo logy doručování e-mailů |
| Duplicitní provedení | Duplicitní plány nebo překrývající se procesy | Prozkoumejte hooky, argumenty a zamykání |
| WooCommerce akce zůvají pending | Zátěž Action Scheduleru | Prozkoumejte rozhraní naplánovaných akcí a jednotlivé selhání |
Nesmažte slepo zpožděné události
Může být lákavé odstranit každou událost, která vypadá jako zaseknutá.
Vyhněte se tomu.
Událost může představovat legitimní naplánovanou platební operaci, zpracování objednávky, doručení e-mailu, nebo zálohu.
Smazání události může odstranit naplánovanou práci bez opravy underlying problému.
WP-CLI poskytuje příkazy pro mazání událostí, ale tyto by měly být použity až po identifikaci hooku a porozumění jeho účelu.
9. Vyhněte se duplicitním naplánovaným událostem ve svých pluginech
Pokud vyvíjíte WordPress plugin, častou chybou je opakované registrování stejné opakované události.
Například plánování úlohy při každém načtení stránky bez kontroly, zda již existuje.
Správný přístup je nejprve zkontrolovat:
if (!wp_next_scheduled('myplugin_daily_cleanup')) {
wp_schedule_event(
time() + HOUR_IN_SECONDS,
'daily',
'myplugin_daily_cleanup'
);
}
Pak zaregistrovat callback samostatně:
add_action('myplugin_daily_cleanup', function () {
// Perform a small, bounded maintenance task.
});
Pokud událost přijímá argumenty, používejte konzistentní argumenty při plánování, kontrole a mazání. WordPress používá hook a argumenty k rozlišení naplánovaných událostí.
Také zvažte dobu provedení. Úloha, která zpracovává tisíce záznamů v jednom požadavku, může vyčerpat PHP čas provedení nebo paměť.
Pro velké zátěže zpracovávejte data v malých dávkách, dělejte operace bezpečné pro opakování a evidujte pokrok.
10. Praktický checklist pro spolehlivý WordPress plánovač
Než budete problém považovat za vyřešený, ověřte tyto body:
- [ ] WordPress Site Health neukazuje neobjasněné chyby plánování nebo loopbacku.
- [ ] Očekávané naplánované hooky existují.
- [ ] Server cron se provádí v zamýšleném intervalu.
- [ ]
DISABLE_WP_CRONje nakonfigurován až po připravení alternativního triggeru. - [ ] Cron job používá správnou PHP spustitelnou cestu a WordPress cestu.
- [ ] Reálná naplánovaná úloha dokončila úspěšně.
- [ ] Logy lze konzultovat, když úloha selže.
- [ ] Žádná duplicitní konfigurace plánovače není aktivní.
- [ ] Kritické operace mají své vlastní monitorování nebo varovné alerty.
Spolehlivý plánovač není jen ten, co běží. Je to ten, jehož selhání můžete identifikovat a prozkoumat.
11. Závěrečné myšlenky: kdy byste měli použít serverový cron?
Pro malý osobní blog s občasnými návštěvníky a bez časově citlivé automatizace může výchozí WP-Cron být zcela dostačující.
Ale pokud váš web spoléhá na naplánované publikování, údržbu na pozadí, e-commerce zpracování, nebo jiné opakované operace, serverový cron job je hodný zvážení.
Vylepšení není v tom, že serverový cron magicky učiní každý WordPress plugin spolehlivým. Odstraní jeden důležitý zdroj nejistoty: závislost na příchozích webových požadavcích pro spouštění splněných událostí.
Začněte diagnostikou skutečného selhání, prozkoumejte naplánované události, a teprve pak měňte spouštěcí mechanismus.
Tento přístup je bezpečnější než instalace dalšího pluginu nebo úprava konfiguračních nastavení bez vědomí, co se pokazilo.