Se il sito si rompe dopo aver attivato minificazione, combinazione, caricamento differito o rimozione del CSS inutilizzato, disattiva solamente l’ultima funzione modificata, esegui un purge completo e verifica da anonimo. Poi riattiva le ottimizzazioni una alla volta e usa le esclusioni CSS o JavaScript per individuare il file responsabile.
Le funzioni di Page Optimization di LiteSpeed Cache possono ridurre dimensione e numero delle risorse, ma modificano ordine, posizione o contenuto di CSS e JavaScript. Un tema o plugin può dipendere da una sequenza precisa, da codice inline o da una libreria caricata prima di un’altra.
Quando il sito è rotto dopo la minificazione CSS o JavaScript, non conviene disattivare tutto definitivamente né aggiungere decine di esclusioni casuali. Se il sito è rotto dopo la minificazione, serve una procedura ripetibile.
Sintomi tipici di un conflitto CSS o JavaScript
- menu mobile che non si apre;
- slider fermo o invisibile;
- layout senza colonne o stili;
- icone mancanti;
- popup, moduli o filtri non funzionanti;
- carrello che non si aggiorna;
- errore JavaScript nella console;
- pagina corretta da amministratore ma rotta da anonimo;
- problema presente solo su mobile o su una lingua.
Annota pagina, dispositivo, browser e operazione che non funziona. Una schermata aiuta per il layout, ma per JavaScript è utile anche il messaggio della console.
Prima misura: ripristinare rapidamente il sito
- accedi a WordPress;
- apri LiteSpeed Cache → Page Optimization;
- disattiva solamente l’impostazione attivata per ultima;
- salva;
- vai su LiteSpeed Cache → Toolbox → Purge;
- esegui Purge All;
- svuota anche l’eventuale cache CDN;
- verifica in finestra anonima.
Se non ricordi l’ultima modifica, disattiva temporaneamente le ottimizzazioni CSS e JS, ma lascia attiva la page cache. In questo modo separi il problema di presentazione dalla cache del server.
Non usare il pulsante “Reset All Settings” come primo tentativo. Perderesti anche impostazioni non collegate al conflitto e renderesti più difficile capire quale opzione fosse responsabile.
Quali opzioni possono causare il problema
| Funzione | Possibile effetto |
|---|---|
| CSS Minify | Rimuove spazi e riscrive il file; può evidenziare CSS non valido. |
| CSS Combine | Unisce risorse e può modificare l’ordine delle regole. |
| UCSS / Remove Unused CSS | Genera CSS specifico; una regola necessaria può essere esclusa dalla generazione. |
| Load CSS Asynchronously | Il contenuto può apparire senza stile o cambiare durante il caricamento. |
| JS Minify | Può esporre incompatibilità in script non validi. |
| JS Combine | Può cambiare l’ordine di esecuzione delle dipendenze. |
| Load JS Deferred | Ritarda gli script fino al parsing del documento. |
| Delay JS | Rimanda l’esecuzione fino a un’interazione e può bloccare funzioni iniziali. |
Metodo corretto: testare una funzione alla volta
Parti da una configurazione stabile:
- page cache attiva;
- ottimizzazioni CSS e JS problematiche disattivate;
- purge eseguito;
- sito verificato da anonimo.
Poi attiva una sola funzione, salva, esegui purge e controlla almeno:
- homepage desktop e mobile;
- pagina con modulo;
- pagina con menu o popup;
- articolo o prodotto;
- carrello e checkout, senza forzarne la cache;
- console JavaScript del browser.
Solo se il test è positivo passa all’opzione successiva. Questo approccio richiede più passaggi ma evita combinazioni in cui non è possibile identificare la causa.
La minificazione CSS o JavaScript va quindi considerata una modifica funzionale, non soltanto estetica: ogni attivazione deve essere seguita da purge, controllo della console e test delle funzioni principali.
Come trovare uno script JavaScript incompatibile
Quando il problema appare con minificazione, combinazione, defer o delay:
- apri la console del browser con F12;
- ricarica la pagina e annota il primo errore reale;
- individua il nome del file o una stringa riconoscibile;
- apri LiteSpeed Cache → Page Optimization → Tuning;
- aggiungi il file o una porzione univoca in JS Excludes, una voce per riga;
- per Delay JS usa l’elenco di esclusione specifico della funzione;
- salva, esegui purge e ripeti il test.
Usa una porzione stabile dell’URL, per esempio il percorso del plugin, evitando domini completi se la stessa risorsa cambia CDN. Non escludere jquery o intere cartelle senza una prova: l’esclusione troppo ampia annulla il vantaggio dell’ottimizzazione.
Come trovare un CSS incompatibile
Se il problema riguarda layout, icone o stili:
- controlla nella scheda Network quali CSS vengono caricati;
- verifica se la regola mancante appartiene a tema o plugin;
- aggiungi il file in CSS Excludes;
- se il CSS è inline, usa una stringa caratteristica prevista dall’interfaccia di tuning;
- purga e controlla la pagina;
- rimuovi gradualmente le esclusioni non necessarie.
Con UCSS, verifica anche che la coda di generazione sia completata. Una pagina può apparire temporaneamente non ottimizzata o usare un fallback mentre il CSS unico viene generato.
Elementor, WooCommerce e plugin dinamici
I page builder e i plugin e-commerce generano file, classi e script in modo dinamico. Dopo una modifica del layout:
- rigenera i file CSS del page builder, se previsto;
- purga LiteSpeed Cache;
- purga l’eventuale CDN;
- controlla pagine con widget diversi;
- non memorizzare carrello, checkout e account nella cache pubblica.
Evita di attivare contemporaneamente ottimizzazioni equivalenti nel tema, in LiteSpeed Cache e in un secondo plugin. Due sistemi che minificano o ritardano gli stessi file creano output difficili da diagnosticare.
Problema visibile solo su mobile
Controlla se il tema carica menu, slider o script diversi in base alla larghezza. Non attivare Cache Mobile se il sito è semplicemente responsive e genera lo stesso HTML. Una cache mobile separata serve solo quando il sito produce markup differente per dispositivo.
Controlla anche cache del browser e CDN
Dopo aver corretto l’impostazione, il browser o il CDN possono continuare a servire file CSS e JavaScript generati in precedenza. Esegui il purge LiteSpeed, svuota la cache del CDN e prova una finestra anonima. Se il file ottimizzato conserva lo stesso URL, usa gli strumenti Network per verificare data, dimensione e risposta realmente scaricata.
Non affidarti soltanto a un hard refresh: alcuni livelli intermedi possono mantenere una copia. Confronta la pagina da una seconda rete o aggiungi temporaneamente un parametro solo per il test, senza usarlo per valutare l’header della page cache.
Debug e raccolta delle prove
Prima di aprire un ticket raccogli:
- URL esatta;
- screenshot prima e dopo;
- browser e dispositivo;
- impostazione che causa il problema;
- primo errore della console;
- file escluso che risolve il conflitto;
- presenza di CDN o secondo plugin di ottimizzazione.
Non lasciare il debug dettagliato attivo sul sito pubblico più del necessario e non pubblicare log contenenti percorsi riservati o token.
Quando mantenere un’esclusione
Un’esclusione mirata è accettabile quando una singola risorsa non è compatibile ma il resto dell’ottimizzazione funziona. Documenta il motivo e ricontrolla dopo gli aggiornamenti del tema o plugin: il conflitto può essere risolto a monte.
Per la configurazione generale consulta LiteSpeed Cache per WordPress su Xlogic; per verificare la page cache usa LSCache HIT o MISS.
Fonti tecniche ufficiali
Domande frequenti sui conflitti CSS e JavaScript
Devo disattivare completamente LiteSpeed Cache?
No. Disattiva temporaneamente solo le funzioni CSS o JavaScript coinvolte e lascia attiva la page cache. Così separi il problema di ottimizzazione dalla cache del server.
Perché il sito è corretto da amministratore ma rotto da anonimo?
Gli utenti autenticati possono bypassare cache e ottimizzazioni. Esegui sempre il test finale in finestra anonima dopo il purge.
È meglio escludere tutto JavaScript?
No. Un’esclusione generale annulla gran parte del beneficio e nasconde la causa. Individua il file o la stringa minima che ripristina la funzione.
Dopo ogni modifica devo svuotare la cache?
Sì. Senza purge potresti continuare a vedere una versione generata con le impostazioni precedenti e trarre conclusioni errate.
Posso usare un altro plugin di minificazione insieme a LiteSpeed Cache?
È sconsigliato. Due sistemi che trasformano gli stessi file possono alterare ordine e output e rendere il conflitto molto più difficile da isolare.