Risolvere i Problemi Comuni di WP Super Cache: Troubleshooting

Risolvere i Problemi Comuni di WP Super Cache: Troubleshooting

Anche il plugin di caching più affidabile può presentare problemi. Dalla cache che non si attiva ai conflitti con altri plugin, dagli errori 500 alle pagine bianche, i problemi legati al caching possono essere frustranti e difficili da diagnosticare. In questo articolo finale della serie su WP Super Cache, affrontiamo i problemi più comuni, le loro cause e le soluzioni passo-passo per risolverli. Questa guida di troubleshooting ti permetterà di identificare e risolvere rapidamente qualsiasi problema legato alla cache del tuo sito WordPress.

Problema 1: La Cache Non Si Attiva

Uno dei problemi più frequenti è che la cache sembra non funzionare nonostante il plugin sia installato e attivato. Il sito continua a caricarsi lentamente e non ci sono commenti HTML di cache nel codice sorgente.

Cause possibili e soluzioni:

WP_CACHE non è definito: WP Super Cache richiede che la costante WP_CACHE sia impostata su true nel file wp-config.php. Il plugin normalmente la aggiunge automaticamente, ma in alcuni casi (permessi del file, configurazione del server) non riesce a farlo.

• Apri wp-config.php con un editor di testo o via FTP
• Cerca la riga define(’WP_CACHE’, true);
• Se non c’è, aggiungila appena sotto la riga <?php o prima di /* That’s all, stop editing! */
• Se c’è ma è impostata su false, cambiala in true
• Se c’è ma è commentata (con // davanti), rimuovi i caratteri di commento

advanced-cache.php mancante o corrotto: Il file wp-content/advanced-cache.php è il drop-in che WordPress carica per inizializzare il caching.

• Verifica che il file esista in wp-content/
• Se manca, disattiva e riattiva WP Super Cache dal pannello plugin: il file verrà rigenerato
• Se esiste ma è di un altro plugin (controlla il contenuto), elimina il file e riattiva WP Super Cache

Caching non abilitato nell’interfaccia: Dopo l’installazione, il caching deve essere abilitato manualmente.

• Vai su Impostazioni → WP Super Cache → Easy
• Seleziona “Caching On (Recommended)”
• Clicca “Update Status”

Problema 2: Errore 500 dopo l’Attivazione

Un errore 500 (Internal Server Error) dopo l’attivazione di WP Super Cache indica tipicamente un problema con il file .htaccess o con la configurazione del server.

Soluzioni:

Regole .htaccess corrotte:

• Accedi al sito via FTP
• Scarica una copia del file .htaccess come backup
• Apri il file e rimuovi tutte le regole tra # BEGIN WPSuperCache e # END WPSuperCache
• Salva il file e verifica che il sito torni a funzionare
• Se funziona, il problema era nella modalità Expert. Torna nelle impostazioni del plugin e usa la modalità Simple

mod_rewrite non disponibile: Se il server non supporta mod_rewrite, le regole della modalità Expert causano errori.

• Passa alla modalità Simple nelle impostazioni avanzate di WP Super Cache
• Contatta il provider per verificare se mod_rewrite è abilitato

Conflitto con le regole WordPress: In rari casi, le regole di WP Super Cache possono confliggere con quelle di WordPress o di altri plugin.

• Vai su Impostazioni → Permalink e salva le impostazioni senza modificarle: WordPress rigenererà le sue regole .htaccess
• Poi riattiva la modalità Expert in WP Super Cache per rigenerare le sue regole nella posizione corretta

Problema 3: Pagine Bianche (White Screen of Death)

Una pagina completamente bianca indica un errore fatale PHP. Con WP Super Cache, le cause più comuni sono:

Errore in wp-cache-config.php:

• Se hai modificato manualmente il file, un errore di sintassi può causare la pagina bianca
• Rinomina il file (es. wp-cache-config.php.bak) via FTP
• WP Super Cache rigenererà il file con le impostazioni predefinite

Errore in advanced-cache.php:

• Elimina il file wp-content/advanced-cache.php via FTP
• Aggiungi o modifica in wp-config.php: define(’WP_CACHE’, false);
• Il sito dovrebbe tornare a funzionare senza caching
• Riattiva il plugin per rigenerare i file

Limite di memoria PHP:

• Se la generazione della cache consuma troppa memoria, PHP termina con un errore fatale
• Aumenta il limite di memoria aggiungendo define(’WP_MEMORY_LIMIT’, ’256M’); in wp-config.php
• Se sei su hosting condiviso, contatta il provider per aumentare il php memory_limit

Problema 4: Contenuti Obsoleti Serviti dalla Cache

Dopo aver aggiornato un articolo o una pagina, i visitatori continuano a vedere la versione precedente. Questo indica che la cache non viene invalidata correttamente.

Soluzioni:

• Svuota manualmente la cache: Vai su Impostazioni → WP Super Cache → Contents e clicca “Delete Cache”
• Verifica l’opzione di invalidazione automatica: Nella tab Advanced, assicurati che sia abilitata l’opzione “Clear all cache files when a post or page is published or updated”
• Cache Cloudflare o CDN: Se usi Cloudflare o una CDN, potrebbe essere la loro cache a servire il contenuto obsoleto. Svuota la cache anche dalla dashboard del provider CDN
• Cache del browser: L’utente potrebbe vedere una versione cachata dal proprio browser. Chiedi di premere Ctrl+Shift+R (hard refresh) o di svuotare la cache del browser
• Cache del provider: Alcuni hosting (Siteground, Bluehost) hanno un proprio sistema di cache a livello di server che può interferire. Svuota anche quella cache

Problema 5: Conflitto con Altri Plugin

WP Super Cache può entrare in conflitto con diversi tipi di plugin. Ecco i conflitti più comuni:

Con altri plugin di caching:

• Non utilizzare mai due plugin di page caching contemporaneamente
• Disattiva e rimuovi completamente qualsiasi altro plugin di caching prima di usare WP Super Cache
• Dopo la rimozione, verifica che non rimangano file residui come advanced-cache.php o wp-cache-config.php del plugin precedente

Con plugin di minificazione (Autoptimize, Fast Velocity Minify):

• Generalmente compatibili, ma possono causare problemi se modificano l’HTML in modo che WP Super Cache non riesce a rilevare correttamente le pagine
• Se noti problemi, prova a disabilitare la minificazione HTML e mantieni solo CSS/JS

Con plugin di sicurezza (Wordfence, Sucuri):

• I plugin di sicurezza che operano a livello PHP potrebbero non funzionare in modalità Expert perché PHP viene bypassato
• Usa la modalità Simple se il plugin di sicurezza necessita di eseguire codice ad ogni richiesta
• Aggiungi le pagine di login e di blocco del plugin di sicurezza alle esclusioni della cache

Con plugin multilingual (WPML, Polylang):

• I siti multilingua generano URL diversi per ogni lingua, e la cache deve gestirli come pagine separate
• Verifica che WP Super Cache crei file cached separati per ogni variante linguistica
• Se le lingue condividono lo stesso URL (con cookie o sessione), potrebbe essere necessario disabilitare la cache supercache e usare solo WP-Cache

Problema 6: La Modalità Expert Non Funziona

Dopo aver attivato la modalità Expert, il sito non serve le pagine dalla cache o mostra errori.

Soluzioni:

• Verifica mod_rewrite: Crea un semplice test mod_rewrite o chiedi al provider se il modulo è abilitato
• Verifica AllowOverride: La configurazione di Apache deve permettere l’uso di .htaccess con AllowOverride All o almeno FileInfo
• Verifica i permessi .htaccess: Il file deve essere scrivibile da PHP (tipicamente permessi 644 o 666)
• Controlla le regole: Apri il file .htaccess e verifica che le regole WP Super Cache siano presenti e corrette
• Rigenera le regole: Nella tab Advanced, clicca “Update mod_rewrite Rules”
• Alternativa: Se la modalità Expert continua a non funzionare, usa la modalità Simple che offre comunque ottimi risultati

Problema 7: Test Cache Fallisce

Il test integrato di WP Super Cache riporta “The pages are not the same”, indicando che i timestamp non corrispondono.

Cause possibili:

• Contenuto dinamico: Elementi della pagina che cambiano ad ogni caricamento (timestamp, contatori, widget casuali) causano differenze tra le due richieste. Identifica e gestisci questi elementi (escludili dalla cache o rendili statici)
• Plugin che iniettano contenuto casuale: Alcuni plugin inseriscono ID casuali, nonce o token che cambiano ad ogni richiesta
• Cache non ancora generata: Se la cache è stata appena svuotata, la prima richiesta genera la cache e la seconda la serve. Il test potrebbe fallire per motivi di timing
• CDN o proxy: Un reverse proxy o CDN potrebbe modificare la risposta tra le due richieste

Soluzione: Esegui il test più volte. Se fallisce costantemente, usa la verifica manuale via codice sorgente per confermare il funzionamento della cache.

Problema 8: Il Preload Non Si Completa

Il preload si avvia ma non riesce a generare la cache per tutte le pagine.

Soluzioni:

• Timeout PHP: Il preload potrebbe superare il limite di esecuzione PHP. WP Super Cache riprende dal punto interrotto al ciclo successivo. Attendi più cicli per il completamento
• Limiti dell’hosting: L’hosting potrebbe bloccare le richieste multiple come sospetto DDoS. Riduci la velocità del preload nelle impostazioni
• Errori sulle pagine: Se una pagina genera un errore PHP, il preload potrebbe bloccarsi. Controlla il log degli errori PHP per identificare pagine problematiche
• Spazio su disco esaurito: Verifica lo spazio disponibile e libera spazio se necessario

Problema 9: Problemi con HTTPS/SSL

Dopo la migrazione a HTTPS, la cache potrebbe servire versioni HTTP delle pagine o causare avvisi di contenuto misto (mixed content).

Soluzioni:

• Svuota completamente la cache: I file cached con URL HTTP devono essere eliminati e rigenerati con HTTPS
• Verifica wp-config.php: Assicurati che WP_HOME e WP_SITEURL (se definiti) usino https://
• Verifica le impostazioni WordPress: In Impostazioni → Generali, sia l’indirizzo WordPress che l’indirizzo del sito devono usare HTTPS
• Rigenera le regole .htaccess: Le regole della modalità Expert devono riflettere il protocollo HTTPS
• CDN: Se usi una CDN, assicurati che sia configurata per HTTPS

Problema 10: Errori “Cannot Modify Header Information”

Questo errore PHP indica che qualcosa sta inviando output (anche uno spazio o una riga vuota) prima che WP Super Cache possa impostare gli header HTTP.

Soluzioni:

• BOM (Byte Order Mark): Alcuni editor aggiungono un carattere BOM invisibile all’inizio dei file PHP. Apri wp-config.php e i file del tema con un editor che permette di salvare senza BOM
• Spazi prima di <?php: Verifica che non ci siano spazi o righe vuote prima del tag di apertura PHP in wp-config.php
• Plugin problematici: Un plugin potrebbe eseguire un echo o un print troppo presto. Disattiva i plugin uno alla volta per identificare il colpevole

Procedura di Reset Completo

Se nessuna delle soluzioni sopra funziona, esegui un reset completo di WP Super Cache:

1. Disattiva il plugin dal pannello WordPress
2. Via FTP, elimina i seguenti file:
   • wp-content/advanced-cache.php
   • wp-content/wp-cache-config.php
3. Elimina la directory wp-content/cache/
4. Apri wp-config.php e imposta WP_CACHE su false o rimuovi la riga
5. Se eri in modalità Expert, apri .htaccess e rimuovi le regole tra # BEGIN WPSuperCache e # END WPSuperCache
6. Elimina il plugin dalla directory wp-content/plugins/wp-super-cache/
7. Reinstalla WP Super Cache dalla directory WordPress
8. Attiva il plugin e configuralo da zero

Questa procedura garantisce una partenza pulita, eliminando qualsiasi file corrotto o configurazione problematica.

Quando Chiedere Aiuto

Se hai provato tutte le soluzioni senza successo, ecco le risorse a tua disposizione:

• Forum di supporto WordPress.org: Cerca problemi simili o apri una nuova discussione nella sezione dedicata a WP Super Cache
• Supporto del provider hosting: Molti problemi sono legati alla configurazione del server, e il supporto tecnico del provider può identificarli rapidamente
• Consulenza professionale: Per siti critici o problemi complessi, un professionista WordPress può risolvere il problema in modo efficiente

Quando chiedi aiuto, fornisci sempre: versione di WordPress, versione di WP Super Cache, versione PHP, tipo di hosting, elenco degli altri plugin attivi, e una descrizione dettagliata del problema con i passaggi per riprodurlo.

Conclusioni della Serie

Con questo articolo si conclude la nostra serie completa su WP Super Cache. Abbiamo coperto ogni aspetto del plugin, dall’installazione base alla configurazione avanzata, dall’integrazione con CDN e Cloudflare alla configurazione per WooCommerce, dal debug al troubleshooting. WP Super Cache rimane uno degli strumenti più affidabili e versatili per migliorare le prestazioni di un sito WordPress, e con le conoscenze acquisite in questa serie, sei ora in grado di configurarlo e gestirlo in modo professionale.

Ricorda: la velocità del sito non è solo una questione tecnica, ma un fattore che influenza direttamente l’esperienza utente, il posizionamento SEO e, in ultima analisi, il successo del tuo progetto online.

Hai un problema con WP Super Cache che non riesci a risolvere? Il team di G Tech Group è specializzato nella risoluzione di problemi di caching e prestazioni WordPress. Contattaci per un’assistenza rapida e professionale. Scopri anche le nostre soluzioni di hosting WordPress gestito dove la cache viene configurata e monitorata dal nostro team tecnico.

Migliora il Tuo Sito WordPress

Scopri le nostre guide complete sugli altri plugin essenziali per WordPress:

• Come Installare Elementor su WordPress
• Come Installare e Configurare WP Rocket
• Come Installare e Configurare SEOPress
• Come Installare e Configurare UpdraftPlus