{"id":167102,"date":"2025-08-18T09:00:00","date_gmt":"2025-08-18T09:00:00","guid":{"rendered":"https:\/\/gtechgroup.it\/blog\/litespeed-cache-problemi-comuni-troubleshooting\/"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T22:00:00","slug":"litespeed-cache-problemi-comuni-troubleshooting","status":"publish","type":"post","link":"https:\/\/gtechgroup.it\/blog\/litespeed-cache-problemi-comuni-troubleshooting\/","title":{"rendered":"Risolvere i Problemi Comuni di LiteSpeed Cache: Troubleshooting"},"content":{"rendered":"

Risolvere i Problemi Comuni di LiteSpeed Cache: Troubleshooting<\/h2>\n

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.<\/p>\n

Metodologia di Troubleshooting<\/h3>\n

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:<\/p>\n

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

    Come Svuotare la Cache<\/h3>\n

    Lo svuotamento della cache è il primo passo di qualsiasi troubleshooting. LiteSpeed Cache offre diversi livelli di svuotamento:<\/p>\n

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

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

    Purge per URL<\/strong>: svuota la cache di una singola pagina. Puoi farlo dalla barra di amministrazione cliccando sull’icona LiteSpeed Cache mentre visualizzi la pagina.<\/p>\n

    Purge Critical CSS<\/strong>: rigenera il Critical CSS. Necessario quando il layout above the fold non è corretto.<\/p>\n

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

    \"Toolbox<\/p>\n

    Problema 1: Layout Rotto o Stili Mancanti<\/h3>\n

    Questo è il problema più comune e può avere diverse cause:<\/p>\n

    Causa: Combinazione CSS<\/strong><\/p>\n

    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.<\/p>\n

    Causa: UCSS (Unique CSS) troppo aggressivo<\/strong><\/p>\n

    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.<\/p>\n

    Causa: Critical CSS incompleto<\/strong><\/p>\n

    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”.<\/p>\n

    Causa: Cache che serve contenuto obsoleto<\/strong><\/p>\n

    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.<\/p>\n

    Problema 2: JavaScript Non Funziona<\/h3>\n

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

    Causa: JS Combine con dipendenze rotte<\/strong><\/p>\n

    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.<\/p>\n

    Causa: JS Defer su script inline-critici<\/strong><\/p>\n

    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”.<\/p>\n

    Causa: JS Delay troppo aggressivo<\/strong><\/p>\n

    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).<\/p>\n

    Errore specifico: “$ is not defined” o “jQuery is not defined”<\/strong><\/p>\n

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

    \"Debug<\/p>\n

    Problema 3: WooCommerce — Carrello Non Funziona<\/h3>\n

    Il carrello WooCommerce è particolarmente sensibile al caching. I problemi più comuni sono:<\/p>\n

    Il carrello mostra sempre 0 articoli<\/strong>: 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).<\/p>\n

    Il carrello mostra il contenuto di un altro utente<\/strong>: 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.<\/p>\n

    “Aggiungi al carrello” non funziona<\/strong>: lo script WooCommerce wc-add-to-cart<\/code> potrebbe essere stato differito o ritardato. Soluzione: escludi wc-add-to-cart<\/code> e wc-cart-fragments<\/code> dal JS Defer e dal JS Delay.<\/p>\n

    Il checkout mostra un errore di nonce<\/strong>: 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.<\/p>\n

    Problema 4: Pagina che Non Viene Cachata<\/h3>\n

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

    X-LiteSpeed-Cache: hit<\/code> = la pagina è in cache<\/p>\n

    X-LiteSpeed-Cache: miss<\/code> = la pagina non era in cache (prima visita o cache svuotata)<\/p>\n

    Assenza dell’intestazione = la cache non è attiva per questa pagina<\/p>\n

    Cause comuni per pagine non cachate<\/strong>:<\/p>\n