Risolvere i Problemi Comuni di LiteSpeed Cache: Troubleshooting

Risolvere i Problemi Comuni di LiteSpeed Cache: Troubleshooting

LiteSpeed Cache è un plugin potente e complesso, e come ogni strumento sofisticato, può occasionalmente causare problemi. Un layout che si rompe, un modulo che smette di funzionare, un carrello che mostra dati errati — queste situazioni possono essere frustranti, ma nella stragrande maggioranza dei casi hanno soluzioni semplici. In questa guida affronteremo i problemi più comuni che gli utenti incontrano con LiteSpeed Cache, fornendo procedure di troubleshooting sistematiche per risolverli rapidamente.

Metodologia di Troubleshooting

Prima di entrare nei problemi specifici, è fondamentale avere un approccio metodico al troubleshooting. Quando qualcosa non funziona dopo aver configurato LiteSpeed Cache, segui questi passi:

1. Verifica che il problema sia causato dalla cache: svuota tutta la cache e verifica se il problema persiste. Se il problema scompare dopo lo svuotamento, è sicuramente legato alla cache
2. Identifica la funzionalità responsabile: disabilita le ottimizzazioni una alla volta (inizia da CSS/JS, poi immagini, poi cache) fino a identificare quale causa il problema
3. Testa in incognito: usa sempre una finestra di navigazione in incognito per testare, eliminando l’influenza della cache del browser
4. Controlla la console del browser: apri gli Strumenti per sviluppatori (F12) e controlla la scheda Console per errori JavaScript e la scheda Network per risorse che non vengono caricate
5. Abilita il debug: LiteSpeed Cache ha una modalità debug che registra informazioni dettagliate nel log

Come Svuotare la Cache

Lo svuotamento della cache è il primo passo di qualsiasi troubleshooting. LiteSpeed Cache offre diversi livelli di svuotamento:

Purge All: svuota tutta la cache (pagine, CSS/JS ottimizzati, Critical CSS). Vai su LiteSpeed Cache > Toolbox > Purge > Purge All.

Purge CSS/JS Cache: svuota solo i file CSS e JS ottimizzati. Utile quando il problema riguarda solo il layout o le funzionalità JavaScript.

Purge per URL: svuota la cache di una singola pagina. Puoi farlo dalla barra di amministrazione cliccando sull’icona LiteSpeed Cache mentre visualizzi la pagina.

Purge Critical CSS: rigenera il Critical CSS. Necessario quando il layout above the fold non è corretto.

Dopo lo svuotamento, ricorda di svuotare anche la cache del browser (Ctrl+Shift+R su Chrome/Firefox per un hard refresh).

Problema 1: Layout Rotto o Stili Mancanti

Questo è il problema più comune e può avere diverse cause:

Causa: Combinazione CSS

La combinazione CSS può alterare l’ordine dei fogli di stile, causando sovrascritture di stili inaspettate. Soluzione: disabilita “CSS Combine” e verifica se il problema si risolve. Se sì, puoi riattivare la combinazione aggiungendo i CSS problematici alle esclusioni.

Causa: UCSS (Unique CSS) troppo aggressivo

L’UCSS potrebbe rimuovere regole CSS che sembrano non utilizzate ma che vengono applicate dinamicamente (tramite JavaScript o dopo l’interazione utente). Soluzione: disabilita “Generate UCSS” e verifica. Se il problema si risolve, aggiungi i selettori CSS mancanti alla safelist UCSS.

Causa: Critical CSS incompleto

Se il Critical CSS non copre tutti gli stili above the fold, si verifica un FOUC (flash of unstyled content). Soluzione: rigenera il Critical CSS da Toolbox. Se il problema persiste, aggiungi le regole CSS mancanti manualmente nel campo “CSS critico aggiuntivo”.

Causa: Cache che serve contenuto obsoleto

Se hai modificato il CSS del tema dopo la generazione della cache, la versione cachata potrebbe avere gli stili vecchi. Soluzione: svuota tutta la cache dopo ogni modifica al tema.

Problema 2: JavaScript Non Funziona

Slider che non scorrono, menu a tendina che non si aprono, moduli che non inviano — sono tutti sintomi di problemi con l’ottimizzazione JavaScript.

Causa: JS Combine con dipendenze rotte

La combinazione JS può alterare l’ordine di esecuzione degli script. Se lo script A dipende dallo script B e l’ordine viene invertito, si verificano errori. Soluzione: disabilita “JS Combine” e verifica. Aggiungi gli script problematici alle esclusioni.

Causa: JS Defer su script inline-critici

Alcuni script devono eseguirsi immediatamente nel punto in cui sono definiti nell’HTML. Il defer li sposta alla fine, causando errori. Soluzione: aggiungi gli script problematici alla lista “JS Defer Excludes”.

Causa: JS Delay troppo aggressivo

Se script essenziali per l’interazione vengono ritardati, l’utente può cliccare un pulsante e non ottenere risposta fino a quando lo script non viene caricato. Soluzione: rimuovi gli script essenziali dalla lista “JS Delay”. Ritarda solo script di terze parti non essenziali (analytics, chat, social).

Errore specifico: “$ is not defined” o “jQuery is not defined”

Questo errore indica che uno script tenta di usare jQuery prima che venga caricato. Soluzione: escludi jQuery dal defer e dal combine. Aggiungi jquery alla lista delle esclusioni JS.

Problema 3: WooCommerce — Carrello Non Funziona

Il carrello WooCommerce è particolarmente sensibile al caching. I problemi più comuni sono:

Il carrello mostra sempre 0 articoli: la pagina cachata ha il carrello vuoto perché il primo visitatore che ha generato la cache non aveva nulla nel carrello. Soluzione: attiva ESI per il widget del carrello, oppure verifica che WooCommerce usi AJAX per aggiornare il mini-carrello (che è il comportamento predefinito).

Il carrello mostra il contenuto di un altro utente: la cache pubblica sta servendo una pagina che include dati personali. Questo è un problema serio di privacy. Soluzione: verifica che le pagine carrello, checkout e account siano escluse dalla cache. Controlla in Cache > Esclusioni.

“Aggiungi al carrello” non funziona: lo script WooCommerce wc-add-to-cart potrebbe essere stato differito o ritardato. Soluzione: escludi wc-add-to-cart e wc-cart-fragments dal JS Defer e dal JS Delay.

Il checkout mostra un errore di nonce: la pagina di checkout ha un nonce scaduto perché è stata servita dalla cache. Soluzione: verifica che la pagina di checkout sia nelle esclusioni della cache. Se usi ESI, configura la gestione dei nonce tramite ESI.

Problema 4: Pagina che Non Viene Cachata

A volte una pagina che dovrebbe essere cachata continua ad avere un TTFB alto. Per verificare se è in cache, controlla le intestazioni HTTP:

X-LiteSpeed-Cache: hit = la pagina è in cache

X-LiteSpeed-Cache: miss = la pagina non era in cache (prima visita o cache svuotata)

Assenza dell’intestazione = la cache non è attiva per questa pagina

Cause comuni per pagine non cachate:

• Cookie che impediscono la cache: certi cookie (come quelli di plugin membership o A/B testing) impediscono il caching. Controlla quali cookie sono nella lista “Do Not Cache Cookies”
• URL nelle esclusioni: la pagina potrebbe essere stata esclusa manualmente o da un pattern di esclusione troppo ampio
• Plugin che impostano intestazioni no-cache: alcuni plugin inviano intestazioni HTTP che impediscono il caching. Abilita il debug di LiteSpeed Cache per identificarli
• Query string nell’URL: per impostazione predefinita, le pagine con query string non vengono cachate. Se sono legittimi, aggiungili alla lista delle query string cachate
• POST requests: le richieste POST non vengono mai cachate (comportamento corretto)

Problema 5: Immagini Non Ottimizzate o WebP Non Funzionante

Le immagini non vengono inviate a QUIC.cloud: verifica di avere una Domain Key valida. Controlla che il cron di WordPress funzioni correttamente (alcuni hosting disabilitano wp-cron). Verifica i limiti del piano QUIC.cloud.

Le immagini WebP non vengono servite: verifica che “WebP Replacement” sia attivo. Controlla che le versioni WebP esistano nella cartella uploads (hanno estensione .webp aggiunta al nome originale). Su server non-LiteSpeed, la sostituzione WebP potrebbe richiedere regole .htaccess specifiche.

Qualità delle immagini inaccettabile: se la compressione è troppo aggressiva, cambia il livello da “Ultra Lossy” a “Lossy” o “Lossless” e riottimizza le immagini. Puoi ripristinare gli originali da Image Optimization > Destroy All Optimization Data.

Problema 6: Object Cache Non Funzionante

Errore “Object Cache connection failed”: Redis o Memcached non è in esecuzione sul server, o l’host/porta configurati non sono corretti. Verifica con il provider hosting che Redis/Memcached sia disponibile e attivo.

Sito lento dopo aver attivato l’Object Cache: se Redis/Memcached ha poca memoria allocata, la cache viene continuamente svuotata (thrashing). Verifica la memoria allocata con redis-cli info memory. Se evicted_keys è alto, Redis ha bisogno di più memoria.

Contenuti non aggiornati nel backend: l’Object Cache potrebbe servire dati stale nel pannello di amministrazione. Disabilita “Cache WP Admin” nelle impostazioni Object Cache se riscontri questo problema.

Problema 7: Conflitti con Altri Plugin

LiteSpeed Cache può conflittare con altri plugin che svolgono funzioni simili:

Altri plugin di cache: non usare mai due plugin di cache contemporaneamente. Disinstalla WP Rocket, W3 Total Cache, WP Super Cache o qualsiasi altro plugin di cache prima di usare LiteSpeed Cache.

Plugin di ottimizzazione: plugin come Autoptimize, Fast Velocity Minify o Asset CleanUp possono conflittare con le ottimizzazioni CSS/JS di LiteSpeed Cache. Usa le funzionalità di un solo plugin.

Plugin di Lazy Loading: se hai un plugin di Lazy Loading separato (come a3 Lazy Load), disattivalo e usa il Lazy Loading integrato in LiteSpeed Cache.

Plugin CDN: se usi un plugin CDN separato (come CDN Enabler), potresti avere conflitti con il CDN di LiteSpeed Cache. Usa una sola soluzione CDN.

Problema 8: Errore 500 dopo l’Attivazione

In rari casi, LiteSpeed Cache può causare un errore 500 Internal Server Error dopo l’attivazione. Le cause più comuni sono:

Conflitto con .htaccess: LiteSpeed Cache aggiunge regole al file .htaccess. Se ci sono già regole conflittuali, il risultato può essere un errore 500. Soluzione: accedi via FTP, rinomina .htaccess in .htaccess.bak e crea un nuovo .htaccess con le regole WordPress predefinite.

Memoria PHP insufficiente: LiteSpeed Cache può richiedere più memoria PHP rispetto al limite del server. Soluzione: aumenta il memory_limit PHP a almeno 256MB.

File object-cache.php corrotto: se l’Object Cache è attivo e il file drop-in è corrotto, WordPress potrebbe non caricarsi. Soluzione: cancella via FTP il file wp-content/object-cache.php.

Modalità Debug di LiteSpeed Cache

Per problemi difficili da diagnosticare, abilita la modalità debug:

1. Vai su LiteSpeed Cache > Toolbox > Debug Settings
2. Imposta Debug Log su “On”
3. Opzionale: imposta Admin IPs con il tuo IP per limitare il debug al tuo indirizzo
4. Riproduci il problema
5. Controlla il log in LiteSpeed Cache > Toolbox > Debug Log

Il debug log registra ogni decisione del plugin: perché una pagina è stata cachata o meno, quali ottimizzazioni sono state applicate, quali errori si sono verificati. È lo strumento più potente per il troubleshooting avanzato.

Importante: disabilita sempre il debug quando hai finito. Il debug log può crescere rapidamente e consumare spazio disco.

Problema 9: Cache che Non Si Svuota

A volte, dopo aver cliccato “Purge All”, il sito continua a mostrare contenuto vecchio. Le cause possono essere:

• Cache del browser: il browser ha la sua cache interna. Fai un hard refresh (Ctrl+Shift+R) o testa in incognito
• Cache CDN: se usi una CDN (Cloudflare, QUIC.cloud), la cache CDN deve essere svuotata separatamente
• Proxy/reverse proxy: se c’è un proxy tra l’utente e il server (come Varnish), la sua cache deve essere svuotata
• Cache OPcache: PHP OPcache memorizza il bytecode compilato. In rari casi, potrebbe servire codice vecchio. Riavvia PHP-FPM o OPcache per risolvere

Problema 10: Sito Lento Nonostante la Cache

Se il sito è lento anche con la cache attiva, il problema potrebbe non essere la cache:

• Server sovraccarico: verifica il carico CPU e la memoria del server. Un server al 90% di CPU non può servire pagine velocemente, cache o meno
• DNS lento: un resolver DNS lento aggiunge latenza prima ancora che la connessione al server venga stabilita
• SSL/TLS lento: un handshake TLS lento aggiunge 100-200ms. Verifica la configurazione TLS del server
• Plugin pesanti: alcuni plugin (come Wordfence, Jetpack) possono essere pesanti anche con la cache attiva. Usa il plugin Query Monitor per identificare i colli di bottiglia
• Tema non ottimizzato: un tema mal codificato con query N+1, loop non ottimizzati o asset troppo pesanti sarà lento indipendentemente dalla cache

Quando Chiedere Aiuto

Se hai seguito tutti i passaggi di questa guida e il problema persiste, è il momento di chiedere aiuto a professionisti. Le risorse disponibili sono:

• Forum di supporto WordPress: il plugin ha un forum di supporto attivo su wordpress.org
• Comunità LiteSpeed: il forum ufficiale di LiteSpeed Technologies
• Documentazione QUIC.cloud: guide dettagliate per ogni funzionalità
• Professionisti WordPress: per problemi complessi che richiedono competenze specifiche

Conclusione

La maggior parte dei problemi con LiteSpeed Cache ha soluzioni semplici: disabilitare un’ottimizzazione specifica, aggiungere un’esclusione o svuotare la cache. La chiave è avere un approccio sistematico al troubleshooting: isola il problema, identifica la causa e applica la soluzione mirata. Con il tempo, imparerai a prevenire la maggior parte dei problemi configurando il plugin correttamente fin dall’inizio.

Questa guida conclude la nostra serie completa su LiteSpeed Cache per WordPress. Dalla installazione alla configurazione avanzata, dall’ottimizzazione delle immagini al troubleshooting, abbiamo coperto ogni aspetto di questo straordinario plugin. Con le conoscenze acquisite, sei pronto per configurare LiteSpeed Cache in modo professionale su qualsiasi sito WordPress.

Hai un problema con LiteSpeed Cache che non riesci a risolvere? Il team di G Tech Group è specializzato nella configurazione e nel troubleshooting di LiteSpeed Cache. Il nostro hosting WordPress con LiteSpeed include supporto tecnico dedicato. Contattaci e risolveremo il tuo problema rapidamente.

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