Object cache invalidation -ongelmat WordPressissä ja niiden ratkaisut

WordPressin object cache (esim. Redis tai Memcached) on yksi tehokkaimmista tavoista nopeuttaa sivustoa, mutta samalla yksi yleisimmistä “hiljaisista” ongelmalähteistä. Kun cache invalidation ei toimi oikein, sivusto voi näyttää vanhaa dataa, päivitykset eivät näy tai suorituskyky vaihtelee epäloogisesti.

Ongelma ei yleensä ole itse cache-järjestelmässä, vaan siinä miten WordPress, pluginit ja custom-koodi käsittelevät välimuistin päivittämistä ja poistamista.

Mitä object cache invalidation tarkoittaa

Perusidea

Object cache tallentaa:

• WP_Query tuloksia
• option-arvoja
• termien ja postien dataa
• usein käytettyjä SQL-vastauksia

Invalidation tarkoittaa:

• vanhan datan poistamista tai päivittämistä
• jotta uusi data näkyy heti oikein

Jos invalidation epäonnistuu → käyttäjä näkee “vanhaa totuutta”.

Tyypilliset invalidation-ongelmat WordPressissä

1. “Stale data” eli vanhentunut sisältö

Oireet:

• postaus päivitetty, mutta frontend näyttää vanhan version
• tuotteiden hinnat eivät päivity WooCommercessa
• menu tai widgetit eivät muutu

Syy:

• cachea ei tyhjennetä päivityksen yhteydessä
• transientit tai object cache jäävät eloon

2. Epäyhtenäinen cache state (cache drift)

Oire:

• eri käyttäjät näkevät eri version sivusta
• admin näkee oikean, frontend väärän

Syy:

• partial cache flush
• vain osa cache-avaimista poistetaan
• useita cache layer -kerroksia (Redis + page cache + CDN)

3. Liian aggressiivinen cache invalidation

Oire:

• sivu hidastuu päivitysten jälkeen
• cache rakentuu jatkuvasti uudelleen

Syy:

• jokainen pieni muutos flushaa koko cache-poolin
• esimerkiksi wp_cache_flush() liian usein

4. Orvot cache-avaimet

Oire:

• cache kasvaa jatkuvasti
• muistinkäyttö kasvaa ilman syytä

Syy:

• pluginit eivät poista vanhoja cache-avaimia
• dynamic keys jäävät roikkumaan

5. Object cache vs page cache ristiriita

Oire:

• REST API näyttää uutta dataa
• mutta frontend HTML näyttää vanhaa

Syy:

• object cache päivittyy mutta page cache ei (tai päinvastoin)

Miksi invalidation menee rikki

1. Plugin-ekosysteemi ei ole yhtenäinen

Jokainen plugin voi:

• käyttää omaa cache-logiikkaa
• unohtaa flushauksen
• tai tehdä sen eri hookeissa

2. WordPress hook -epäjohdonmukaisuus

Tärkeät hookit:

• save_post
• deleted_post
• updated_option

Jos plugin ei kuuntele oikeaa hookia → cache jää vanhaksi.

3. Object cache drop-inin erot

Redis / Memcached / WP-Redis:

• eri toteutukset käyttäytyvät eri tavalla
• persistent cache vs non-persistent cache

4. Multi-layer caching

Tyypillinen stack:

• Redis object cache
• Nginx FastCGI cache
• CDN (Cloudflare)

Jos vain yksi kerros päivittyy → data on ristiriidassa.

Käytännön ratkaisut

1. Oikea cache invalidation hookien käyttö

Esimerkki:

add_action('save_post', function($post_id) {
    wp_cache_delete($post_id, 'posts');
});

Tärkeää:

• kohdenna flush tarkasti
• vältä globaalit flushit

2. Vältä wp_cache_flush() käyttöä

Huono:

• tyhjentää koko cache-poolin

Parempi:

• poista vain tietty key tai group

3. Käytä cache group -erottelua

Esim:

• posts_group
• options_group
• user_group

Hyöty:

• voidaan invalidata tarkasti ilman koko järjestelmän tyhjennystä

4. Redis TTL (time-to-live) strategia

• aseta järkevät TTL-arvot
• ei kaikkea “ikuiseksi cacheksi”

Esim:

• 60–300 sekuntia dynaamiselle datalle
• pidempi staattiselle

5. Object cache + page cache synkronointi

Ratkaisu:

• varmista että page cache kuuntelee samoja hookeja
• tai flushaa page cache automaattisesti kun content muuttuu

6. WooCommerce erityishuomiot

WooCommerce:

• käyttää paljon transientteja
• tuotteiden päivitys ei aina flushaa kaikkea

Ratkaisu:

• varmista action scheduler -yhteensopivuus
• käytä WooCommerce cache clearing hookeja

7. Debugging Redis cachea

Työkalut:

• redis-cli monitor
• WP Redis plugin debug
• Query Monitor (object cache inspection)

Tarkista:

• cache hit ratio
• key explosion (liikaa avaimia)

8. Transientien siivous

Transientit:

• voivat jäädä vanhaksi dataksi
• eivät aina noudata object cache invalidationia

Ratkaisu:

• wp_scheduled_delete transient cleanup
• tai WP-CLI cleanup

9. Vältä “cache everything forever” -mallia

Ongelma:

• data ei koskaan päivity
• invalidation muuttuu mahdottomaksi

Parempi:

• yhdistä TTL + event-based invalidation

Yhteenveto

Object cache invalidation -ongelmat WordPressissä johtuvat lähes aina yhdistelmästä:

• liian aggressiivinen tai puuttuva cache flush
• pluginien epäyhtenäinen logiikka
• useita cache-kerroksia ilman synkronointia
• huono hook-käyttö

Oikea ratkaisu ei ole “enemmän cachea”, vaan:

• tarkempi invalidation-logiikka
• oikeat hookit
• pienemmät cache-alueet
• ja TTL + event hybridimalli

Kun nämä ovat kunnossa, Redis- tai Memcached-cache muuttuu epäluotettavasta optimointiyrityksestä oikeasti vakaaksi suorituskykykerrokseksi.