Verkkosivut ja kehitys

WordPress Cron ei toimi? Kuinka korjata ajoitetut tehtävät ja puuttuvat julkaisut

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

WordPressin ajoitetut julkaisut eivät julkaise? Opi, miten diagnosoida WP-Cron-ongelmia, tarkastella ajoitettuja tapahtumia, korjata loopback-virheitä ja määrittää luotettava palvelimen cron-työ vaihe vaiheelta.

WordPress Cron ei toimi? Miten korjata ajoitetut tehtävät ja menetetyt julkaisut

Ajoitat WordPress-artikkelin klo 9:00. Kello 9:30 se ei vielä ole ilmestynyt.

Tai ehkä WooCommerce-sähköpostit saapuvat myöhässä, ajoitetut varmuuskopiot eivät koskaan käynnisty, tai laajennus ilmoittaa, että sen taustatehtävät ovat myöhässä.

Nämä ongelmat liittyvät usein samaan asiaan: WP-Cron, WordPressin sisäänrakennettuun tehtävien ajoitussysteemiin.

WP-Cron on mukava, koska se toimii ilman, että sinun tarvitsee pääsyä hosting-palvelimesi tehtävien ajoittajaan. Mutta perinteisen järjestelmän cron-jobin eri tavalla se ei jatkuvasti suorita taustalla.

Tässä oppaassa opit, miten WP-Cron toimii, miten tunnistaa viivästyvien tehtävien syy ja miten korvata sen oletusmääräinen käynnistysmekanismi luotettavalla palvelimen cron-jobilla tarvittaessa.

Käsittelemme sekä jaetun hostingin että komentorivipääsyä sisältävät palvelimet.

1. Miten WP-Cron todella toimii

Perinteinen Linux cron-daemon tarkistaa ajoituksensa riippumatta verkkosivuston liikenteestä.

WP-Cron toimii toisin. WordPress tarkistaa ajoitetut tehtävät normaalin verkkosivuston aktiviteetin aikana ja yrittää, kun sopii, käynnistää pyynnön osoitteeseen wp-cron.php.

Tämä tarkoittaa, että ajoitettu tapahtuma ei ole varmasti suoritettavissa sen tarkalleen aikataulutetulla ajankohdalla.

Kuvittele verkkosivusto, joka saa viimeisen vierailijansa klo 22:00. Varmuuskopio on ajoitettu klo 02:00, mutta kukaan ei vieraile sivustolla yöllä.

Varmuuskopio ei ehkä käynnisty ennen kuin WordPress saa toisen pyynnön, joka käynnistää sen ajoitussysteemin.

Miten kaksi ajoitusmenetelmää eroavat

Oletus WP-Cron: Vierailijan pyyntö → WordPress tarkistaa tapahtumat → Erääntyneet tehtävät alkavat. Se riippuu WordPress-pyynnöistä.

Palvelimen cron: Palvelimen ajoittaja → Suorittaa viisi minuutin välein → Erääntyneet tehtävät alkavat. Se toimii riippumatta vierailuliikenteestä.

Palvelimen cron-job ei muuta tapaa, jolla WordPress tallentaa ajoitetut tapahtumat. Se tarjoaa vain luotettavemman tavan tarkistaa ja suorittaa ne.

2. Tunnista oireet ennen mitään muutosta

Ei jokainen viivästynyt WordPress-toiminto johtu WP-Cronista.

Aloita tunnistamalla varsinainen oire.

Oire Mahdollinen selitys
Ajoitetut artikkelit näyttävät "Aikataulu menetetty" Cron-käynnistys viivästyi tai epäonnistui
Ajoitetut sähköpostit saapuvat myöhässä Cron-viive, jonon käsittely tai sähköpostitoimitusongelma
Automaattiset varmuuskopiot eivät koskaan käynnisty Puuttuva tapahtuma, cron-virhe tai varmuuskopiointi-laajennuksen virhe
WooCommerce-toiminnot jäävät odottamaan Action Schedulerin käsittelyongelma
Sivuston terveys raportoi loopback-virheen WordPress ei pysty luotettavasti pyytämään omaa URL-osoitteaan
Tehtävät suoritetaan vasta verkkosivuston vierailun jälkeen Liikenteestä riippuva cron-käynnistys

Tärkeä erottelu on tehtävän, joka ei koskaan käynnisty, ja tehtävän, joka käynnistyy mutta epäonnistuu välillä.

WP-Cronin korvaaminen palvelimen ajoittajalla voi ratkaista ensimmäisen ongelman. Se ei automaattisesti korjaa rikkiinna laajennusta, ei-toimivaa tietokantaa tai epäonnistunutta sähköpostipalvelua.

3. Tarkista WordPressin sivuston terveys ensin

Ennen kuin kosketat kokoonpanotiedostoja, avaa WordPressin hallintaliittymä.

  1. Mene kohtaan Työkalut → Sivuston terveys.
  2. Avaa Tila-välilehti.
  3. Etsi varoituksia, jotka liittyvät ajoitetuihin tapahtumiin tai loopback-pyyntöihin.
  4. Kirjoita ylös tarkka viesti ennen muutosten tekemistä.

Loopback-pyyntö on pyyntö, jonka WordPress tekee omaan verkkosivustoonsa.

Jos nämä pyynnöt epäonnistuvat, ajoitetut tehtävät eivät ehkä käynnisty oikein.

Yleisimmät syyt sisältävät virheellisen verkkosivuston URL-osoitteen, DNS-ratkaisuongelmat, SSL-varmenteen ongelmat, HTTP-todennuksen, palomuurirajoitukset tai laajennusten ja teemojen konfliktit.

Esimerkki: salasanalla suojattu väliaikaisympäristö (staging)

Oletetaan, että olet luonut WordPress-väliaikaisympäristön osoitteeseen:

https://staging.example.com

Väliaikaisympäristö vaatii HTTP Basic -todennuksen.

WordPress yrittää pyytää omaa wp-cron.php -päätepistettään, mutta palvelin palauttaa HTTP 401, koska pyyntö ei ole todennettu.

Ongelma ei välttämättä ole itsessään ajoitetussa tehtävässä. Pyynnön, joka pitäisi käynnistää tehtävän, hylätään.

Tässä tilanteessa voit käyttää palvelinpohjaista CLI-ajoittajaa, joka välttää julkisen HTTP-loopback-reitin, tai määrittää ympäristön siten, että WordPressin sisäiset pyynnöt toimivat oikein.

Älä poista salasanansuojauksia väliaikaisympäristöstä vain cronin toimittamiseksi.

4. Tarkkaile ajoitettuja tehtäviä WP-CLI:llä

Jos sinulla on SSH-pääsy ja WP-CLI on asennettu, voit tarkkailla ajoittajaa suoraan.

Siirry ensin WordPress-asennushakemistoon.

cd /path/to/wordpress

Listaa sitten ajoitetut tapahtumat:

wp cron event list

Näet tiedot kuten koukun nimen, seuraavan ajoitetun suorituksen ja toistuvuuden.

Konekieliselle tulosteelle:

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

Mitä kannattaa etsiä?

Kiinnitä huomiota tapahtumiin, joiden seuraava suoritusaika on menneisyydessä.

Mennehtynyt tapahtuma on hyödyllinen varoitusmerkki, mutta yksi mennehtynyt tapahtuma ei itsessään todista, että koko ajoittaja on rikki.

Tarkista, ovatko useita erillisiä koukkuja mennehtyneet. Jos ovat, tutki yleistä käynnistysmekanismia.

Illustration of the article's main concept

Jos vain yhden laajennuksen tapahtumat ovat vaikuttuneet, tarkista se laajennus ensin.

Suorita erääntyneet tehtävät manuaalisesti

Väliaikaisympäristössä, tai tuotannossa vahvistamalla seuraukset ensin, suorita:

wp cron event run --due-now

Tämä pyytää WordPressia suorittamaan tapahtumat, jotka ovat tällä hetkellä erääntyneet.

Varovasti: tämä komento suorittaa varsinaista työtä. Se voi julkaista ajoitetun sisällön, lähettää viestejä, käynnistää varmuuskopiot tai käynnistää verkkokaupan toiminnot.

Se ei ole vahingottomainen diagnostinen esikatselu.

Jos se suoritetaan onnistuneesti, mutta tehtävät menettelevät jälleen mennehtyneiksi, ongelmasi voi olla automaattinen käynnistysmekanismi snarare kuin tehtävän takaisinkutsut.

5. Korvaa liikenteestä riippuva WP-Cron palvelimen cron-jobilla

Tuotannon verkkosivustossa, jossa ajoitetut tehtävät ovat tärkeitä, palvelimen cron-job on usein parempi valinta.

Tavoite on suoraviivainen:

  • Estä WordPressia yrittämästä spawnaa WP-Cronia automaattisesti normaalilla sivupyynnöllä.
  • Pyydä palvelinta käsittelemään erääntyneet tapahtumat säännöllisin väliajoin.

Vaihe 1: muokkaa wp-config.php

Tee varmuuskopiosta wp-config.php.

Lisää tämä kokoonpano rivin ennen, joka kertoo sinun lopettamaan muokkaus:

define('DISABLE_WP_CRON', true);

Tämä poistaa käytöstä WordPressin oletusarvoisen automaattisen cron-spawnin. Se ei poista WordPressin tallentamia ajoitettuja tapahtumia.

Vaihe 2: luo ajoitettu tehtävä hosting-palvelimellasi

Avaa hosting-hallintapaneelisi ja etsi sen cron-jobin ajoittaja.

Vakiolliselle WordPress-asennukselle voit ajoittaa PHP CLI -komennon, joka on muotoa:

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

Korvaa sekä PHP-suoritettavan tiedoston polku että WordPress-asennuksen polku hostisi antamilla todellisilla arvoilla.

Komennon on suoritettava oikea PHP-versio ja sillä on oltava oikeus lukea WordPress-tiedostot.

Jos WP-CLI on asennettu, toinen vaihtoehto on:

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

Tämä vaihtoehto käsittelee erääntyneet WordPress-tapahtumat eksplisiittisesti WP-CLI:n kautta.

Käytä yhtä ajoitusmenetelmää per asennus sen sijaan, että määrittäisit useita riippumattomia cron-jobeja tekevät samat asiat.

Vaihe 3: valitse sopiva väli

Tyypilliselle verkkosivustolle viisi minuuttia on kohtuullinen alkupiste.

Suorituksen väli Ajoittajan käynnistykset vuorokaudessa Maksimi pollausviive* Esimerkki crontab-lauseke
1 minuutti 1 440 1 minuutti * * * * *
5 minuuttia 288 5 minuuttia */5 * * * *
10 minuuttia 144 10 minuuttia */10 * * * *
15 minuuttia 96 15 minuuttia */15 * * * *
30 minuuttia 48 30 minuuttia */30 * * * *

*Olettaa toimivan ajoittajan ja lyhytkestoiset tehtävät. Varsinainen suoritus voi viivästyä palvelimen kuorman tai pitkäkestoisten takaisinkutsujen vuoksi.

Esimerkiksi viisi minuutin välein:

*/5 * * * *

Yhden minuutin väli tarjoaa useammat tarkistukset, mutta se ei ole välttämätön jokaiselle verkkosivustolle.

Matala-liikenteisellä blogilla viisi tai kymmenen minuuttia voi olla täysin riittävä. Kiireisellä verkkokaupalla saatat tarvita useampaa käsittelyä taustakormista riippuen.

Vaihe 4: testaa tulos

Palvelin-jon konfiguroinnin jälkeen odota ainakin kahden ajoitetun väliajan.

Tarkkaile sitten tapahtumalistaa uudelleen:

wp cron event list

Varmista, että aiemmin mennehtyneet tapahtumat on käsitelty.

Tarkista myös hostingin cron-lokit.

Sinun pitäisi myös varmistaa varsinainen liiketoimintatoiminto: ajoitettu testijulkaisu, vahingoton ylläpitotehtävä tai toinen toiminto, jonka tulos on turvallista havainnoida.

6. Mitä jos hostisi ei tarjoa SSH-pääsyä?

Voit silti määrittää palvelimen cron-jobin monilla jaetulla hosting-palveluilla.

Joissakin hosting-paneeleissa tuetaan ajoitettua URL-pyynnöstä, esimerkiksi:

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

Toiset tarjoavat PHP-komennon suoritusta ilman interaktiivista SSH-terminaalia.

Suosi PHP CLI -tehtävää, kun se on tuettu. Ajoitettu HTTP-pyyntö saattaa kärsiä uudelleenohjauksista, pääsyrajoituksista, turvallisuussäännöistä tai verkkiongelmista.

Jos hosting-paneelisi tukee vain HTTP-pyyntöjä, varmista, että päätepiste on saavutettavissa ja että pyyntö todella käynnistää erääntyneet tehtävät.

Älä olettele, että HTTP 200 -vastaanoton saaminen todistaa, että jokainen ajoitettu takaisinkutsu suoritettiin onnistuneesti.

Technical workflow illustration

7. Luo turvallinen testitapahtuma

Kekehittäjille pieni testilaajennus voi auttaa vahvistamaan, että ajoitussysteemi toimii riippumatta olemassa olevista laajennuksista.

Luo tämä tiedosto:

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

Lisää:

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

Aktivoi laajennus WordPressin hallintaliittymästä.

Se rekisteröi tunnin välein toistuvan tapahtuman, joka kirjaa yksinkertaisen diagnostiikkaviestin PHP-viralokiin. Se ei lähetä sähköposteja, muuta sisältöä tai tee ulkoisia verkkopyyntöjä.

Ensimmäinen tapahtuma ajoitetaan noin minuutin aktivoinnin jälkeen.

Testaaksesi sitä välittömästi aktivoinnin jälkeen WP-CLI:llä:

wp cron event run ceikay_cron_test

Tarkista PHP-viraloki viestin kaltaisesta:

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

Aikaleima on vain esimerkki.

Jos haluat testata automaattista ajoittajaa snarare kuin manuaalisesti suorittaa koukku, odota, kunnes tapahtuma on erääntynyt, ja anna määritetyn cron-mekanismin käsitellä sen.

Kun testaus on valmis, poista diagnostiikkalaajennus käytöstä ja poista se.

8. Vianmääritys: cron-job suoritetaan, mutta tehtävät epäonnistuvat silti

Toimiva cron-käynnistin on vain yksi järjestelmän osa.

Jos palvelimesi ajoittaja suoritetaan onnistuneesti, mutta WordPress-toiminnot jatkuvat epäonnistumaan, käytä seuraavaa diagnostista taulukkoa.

Ongelma Mitä tarkistaa Ehdotettu toiminto
Ei lueteltuja ajoitettuja tapahtumia Laajennus ei ehkä ole rekisteröinyt koukkuansa Tarkista laajennuksen aktivointi ja ajoituskoodi
Tapahtumat pysyvät mennehtyneinä Palvelin-työ ei ehkä suoriteta Tarkista cron-lokit, PHP-polu ja oikeudet
PHP fatal error Tehtävän takaisinkutsu tai laajennuksen virhe Tarkista PHP-viralokit ja pinojälki
HTTP 401 tai 403 Todennus tai palomuuri Tarkista loopback-pääsyn rajoitukset
HTTP 500 Sovellus- tai palvelinvika Tarkista PHP-/palvelinlokit
Tapahtumat suoritetaan, mutta sähköpostit eivät saavu Sähköpostikuljetuksen ongelma Tarkista SMTP- tai sähköpostitoimittamislokit
Kaksoissuoritukset Kaksoisajoitukset tai päällekkäiset prosessit Tarkista koukut, argumentit ja lukitus
WooCommerce-toiminnot jäävät odottamaan Action Schedulerin takaisinmaksu Tarkista ajoitettujen toimintojen liitäntä ja yksittäiset virheet

Älä poista mennehtyneitä tapahtumia sokeasti

Saa saatetta houkutella poistaa kaikki näyttävät jumissa olevat tapahtumat.

Vältä sitä.

Tapahtuma voi edustaa legitimaattia ajoitettua maksuun liittyvä toiminto, tilauksen käsittelytehtävä, sähköpostitoimitus tai varmuuskopio.

Tapahtuman poistaminen voi poistaa ajoitetun työn ilman, että se korjaa alapuolellista ongelmaa.

WP-CLI tarjoaa komentoja tapahtumien poistamiseen, mutta nämä tulisi käyttää vasta koukun tunnistamisen ja sen tarkoituksen ymmärtämisen jälkeen.

9. Vältä kaksoisajoitetut tapahtumat omissasi laajennuksissa

Jos kehität WordPress-laajennusta, yleinen virhe on rekisteröidä sama toistuva tapahtuma toistuvasti.

Esimerkiksi tehtävän ajoittaminen jokaisen sivun latauksen yhteydessä ilman tarkistusta, onko se jo olemassa.

Oikea lähestymistapa on tarkistaa ensin:

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

Sitten rekisteröi takaisinkutsu erikseen:

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

Jos tapahtuma hyväksyy argumentteja, käytä yhdenmukaisia argumentteja ajoittaessa, tarkistaessa ja poistaessa sitä. WordPress käyttää koukkuja ja argumenteja erottamaan ajoitetut tapahtumat toisistaan.

Harkitse myös suorituskestoa. Tehtävä, joka käsittelee tuhansia tietueita yhdessä pyynnössä, voi tyhjentää PHP-suoritusaikaa tai muistia.

Suuriin kuormiin, käsittele dataa pienissä erissä, tee toiminnoista turvallisia yrittää uudelleen, ja tallenna edistyminen.

10. Käytännöllinen tarkistusluettelo luotettavalle WordPress-ajoittajalle

Ennen kuin pidät ongelman ratkaistuna, varmista nämä kohdat:

  • [ ] WordPressin sivuston terveys ei näytä selittämättömiä ajoitus- tai loopback-virheitä.
  • [ ] Odotetut ajoitetut koukut ovat olemassa.
  • [ ] Palvelimen cron suorittaa tarkoitetulla välillä.
  • [ ] DISABLE_WP_CRON on määritetty vasta vaihtoehtoisen käynnistimen valmiudessa.
  • [ ] Cron-job käyttää oikeaa PHP-suoritettavaa tiedostoa ja WordPress-polkua.
  • [ ] Varsinainen ajoitettu tehtävä suoritetaan onnistuneesti.
  • [ ] Lokit voi konsultoida tehtävän epäonnistuessa.
  • [ ] Ei aktiivista kaksoisajoittajakokoonpanoa.
  • [ ] Kriittisillä toiminnoilla on oma valvontansa tai virhehälytyksensä.

Luotettava ajoittaja ei ole vain se, joka suorittaa. Se on se, jonka virheet pystyt tunnistamaan ja tutkimaan.

11. Lopulliset ajatukset: milloin kannattaa käyttää palvelimen cronia?

Pienellä persoonallisella blogilla, jolla on satunnaisia vierailijoita ja ei aikaan herkkiä automaatioita, oletusarvoinen WP-Cron on yleensä täysin riittävä.

Mutta jos verkkosivustosi luottaa ajoittettuun julkaisemiseen, taustaylläpitoon, verkkokaupan käsittelyyn tai muihin toistuviin toimintoihin, palvelimen cron-job on harkittava.

Parannus ei ole se, että palvelimen cron taikatehoisesti tekee jokaisen WordPress-laajennuksen luotettavaksi. Se poistaa yhden tärkeän epävarmuuden lähteen: riippuvuuden saapuvista verkkosivustopyynnöistä erääntyneiden tapahtumien käynnistämiseen.

Aloita diagnosoimalla varsinainen virhe, tarkkaile ajoitettuja tapahtumia, ja vasta sitten muuta käynnistysmekanismia.

Se lähestymistapa on turvallisempi kuin asentaa toinen laajennus tai muokata kokoonpanoasetuksia ilman, että tiedät, mikä meni pieleen.