LiteSpeed Cache quebrou o layout ou o menu: como achar a opção culpada
Como achar a opção do LiteSpeed Cache que quebrou o menu ou o CSS, usando o console do navegador, e corrigir com exclusão sem desativar o plugin.

Resposta curta: desligue as otimizações de CSS e JS do LiteSpeed Cache (combinar CSS, combinar JS, adiar JS), limpe o cache e religue uma por vez, testando a cada passo; quando o site quebrar, a última opção ligada é a culpada, e o console do navegador (F12) mostra qual arquivo falhou. Exclua só esse arquivo.
Neste artigo
- Por que o layout quebra depois de ativar a otimização de página
- Como fazer backup e provar que a otimização é a causa
- Como isolar a opção culpada testando uma de cada vez
- Como ler o console do navegador para achar o arquivo que falhou
- Excluir só o arquivo culpado em vez de desligar a opção
- Lazy load de imagens: investigar por último e excluir a imagem
- Quando o culpado não é o LiteSpeed
Por que o layout quebra depois de ativar a otimização de página
O LiteSpeed Cache tem duas famílias de recurso que costumam ser confundidas. O cache de página guarda o HTML pronto e raramente muda a aparência do site. A otimização de página reescreve o HTML: junta vários arquivos CSS em um só, junta arquivos JavaScript, muda a ordem em que os scripts carregam e adia imagens. É essa segunda família que quebra menu, slider, botão de carrinho ou o layout inteiro.
O motivo é quase sempre ordem e dependência. Um script do tema espera que o jQuery já exista. Se a opção de adiar JS empurra o jQuery para o fim da página, o script do menu roda antes e falha. Com CSS, a combinação pode mudar a ordem das regras, e uma regra que antes vencia passa a perder.
A documentação oficial de troubleshooting de otimização do LiteSpeed recomenda o mesmo caminho que este guia segue: em vez de desativar o plugin inteiro, desligar as opções de otimização e reativar uma por vez até achar a que causa o problema. Desativar o plugin resolve o sintoma e joga fora todo o resto que estava funcionando.
Como fazer backup e provar que a otimização é a causa
Antes de alterar qualquer chave, salve as configurações atuais. Assim, se algo piorar, você volta ao ponto de partida em um clique.
- No painel do WordPress, entre em LiteSpeed Cache > Toolbox (Ferramentas, em algumas traduções).
- Abra a aba Import / Export.
- Clique em Export e guarde o arquivo baixado.
Para voltar atrás, é a mesma tela: escolha o arquivo em Import e confirme. Se você não tem backup do site inteiro, faça também, pelo painel da hospedagem ou por um plugin de backup. Mexer só em configuração de plugin tem risco baixo, mas a regra vale.
Agora confirme que o problema é mesmo a otimização. A documentação do LiteSpeed descreve um parâmetro de URL que mostra a página sem as otimizações aplicadas. Abra a página quebrada e acrescente ao final do endereço:
?LSCWP_CTRL=before_optimize
Exemplo fictício: https://seusite.com.br/contato/?LSCWP_CTRL=before_optimize. Se a página já tem um ? no endereço, use &LSCWP_CTRL=before_optimize.
Resultado esperado: se com o parâmetro o menu funciona e o layout aparece certo, a culpa é de alguma otimização de página e vale seguir este guia. Se continua quebrado, o problema está em outro lugar (tema, outro plugin, CDN, que é a rede de servidores que entrega cópias do site perto do visitante) e desligar opções do LiteSpeed não vai resolver.
Como isolar a opção culpada testando uma de cada vez
A lógica é simples: zerar as otimizações, confirmar que o site volta ao normal e religar uma por vez, testando a cada passo. Quando o problema reaparecer, a última opção ligada é a culpada.
Anote o que está ligado hoje antes de desligar qualquer coisa
Entre em LiteSpeed Cache > Page Optimization. Percorra as abas de CSS e de JS e anote quais chaves estão em ON. O nome exato das abas e das opções muda um pouco entre versões e traduções, então guie-se pelos termos em inglês, que aparecem em quase todas as versões.
Desligue a combinação e o adiamento de CSS e JS, nesta ordem
Coloque em OFF, nesta ordem, e salve:
- CSS Combine (combinar CSS)
- JS Combine (combinar JS) e, se existir, JS Combine External and Inline
- Load JS Deferred (carregar JS adiado): mude para OFF, mesmo que esteja em Deferred ou Delayed
- CSS Minify e JS Minify (minificar é remover espaços e comentários do arquivo para deixá-lo menor), só se o problema não sumir com as anteriores
Deixe o lazy load de imagens como está por enquanto. Ele entra no fim.
Limpe o cache e teste em janela anônima a cada alteração
Depois de cada alteração, limpe o cache em LiteSpeed Cache > Toolbox > Purge > Purge All. Sem isso, você continua vendo a página antiga e conclui errado.
Teste numa janela anônima do navegador (Ctrl+Shift+N no Chrome). Logado como administrador, você pode ver uma versão diferente da que o visitante vê, e o cache do próprio navegador também engana.
Se o site voltou ao normal, siga. Se ainda está quebrado com tudo desligado, volte à seção anterior: provavelmente não é o LiteSpeed.
Religue uma opção por vez e pare na que quebra
Ligue uma opção, salve, faça Purge All, teste na janela anônima. Funcionou, passe para a próxima. Quebrou, você achou a culpada. Religue apenas as opções que você desligou no passo 2, nesta ordem (pule as que ficaram ligadas): minificar CSS, minificar JS, combinar CSS, combinar JS e, por último, adiar JS. Adiar JS mexe na ordem de execução e tende a ser a mais sensível.
Como ler o console do navegador para achar o arquivo que falhou
Saber que a culpada é "combinar JS" ajuda, mas não basta. Você quer saber qual script dentro do arquivo combinado quebrou, para excluir só ele. Quem diz isso é o console do navegador, como a própria documentação do LiteSpeed orienta.
- Com a opção culpada ligada, abra a página quebrada.
- Aperte F12 (ou clique com o botão direito e escolha Inspecionar).
- Vá na aba Console.
- Recarregue a página e procure as linhas em vermelho.
Ao lado de cada erro aparece o nome do arquivo e a linha. Arquivos gerados pelo LiteSpeed costumam ficar em caminhos como /wp-content/litespeed/js/ ou /wp-content/litespeed/css/, com nomes formados por letras e números. Um erro apontando para um desses arquivos indica que o problema está no conteúdo combinado ou otimizado. Um erro apontando para um arquivo de plugin ou tema, com caminho normal, dá o nome do suspeito direto.
| O que aparece no console | Opção mais provável | Próximo passo |
|---|---|---|
jQuery is not defined ou $ is not defined |
Load JS Deferred ou JS Combine | Excluir o jQuery do adiamento ou da combinação |
Erro de sintaxe dentro de arquivo em /wp-content/litespeed/js/ |
JS Combine ou JS Minify | Desligar a minificação; se persistir, excluir o script da combinação |
| Função do tema ou plugin "is not defined" | Load JS Deferred | Excluir o script dependente do adiamento |
| Nenhum erro, mas layout desalinhado ou fonte errada | CSS Combine ou CSS Minify | Comparar com ?LSCWP_CTRL=before_optimize e excluir o CSS do tema |
Erro 404 em arquivo de /wp-content/litespeed/ |
Arquivo otimizado antigo ou apagado | Purge All e recarregar |
A tabela é um ponto de partida, não regra fixa. Use-a junto com o teste de uma opção por vez: o console aponta o arquivo, o teste confirma a opção.
Excluir só o arquivo culpado em vez de desligar a opção
Achou o arquivo, não precisa abrir mão da otimização inteira. O LiteSpeed permite tirar arquivos específicos de cada otimização. Em versões recentes, essas listas ficam em Page Optimization, na aba Tuning (e Tuning - CSS para os de estilo). Em versões antigas, ficam dentro das próprias abas de CSS e JS.
As listas que importam aqui:
- JS Excludes: tira o script da combinação e da minificação.
- JS Deferred / Delayed Excludes: tira o script do adiamento. É a lista certa para erro de jQuery.
- CSS Excludes: tira a folha de estilo da combinação e da minificação.
Coloque um item por linha. Basta um trecho único do caminho do arquivo, não precisa do endereço completo. A lista depende da opção culpada: se foi Load JS Deferred (o caso típico de jQuery is not defined), cole em JS Deferred / Delayed Excludes; se foi JS Combine ou JS Minify, cole em JS Excludes. Exemplo fictício, para um menu que dependia do jQuery e quebrou com o adiamento, colado em JS Deferred / Delayed Excludes:
jquery.min.js
jquery-migrate.min.js
meu-tema/js/menu.js
Salve, faça Purge All e teste na janela anônima. Se o menu voltou e o console está limpo, religue as opções que você tinha desligado no início, uma por vez, sempre testando.
Se o erro está dentro de um arquivo combinado e você não consegue descobrir qual script original o causou, desligue só a opção culpada e mantenha as outras. Perder a combinação de JS e manter cache, minificação de CSS e o resto ainda é um resultado bom. Um site rápido e quebrado não serve para nada.
Lazy load de imagens: investigar por último e excluir a imagem
O carregamento sob demanda (Lazy Load Images, em Page Optimization > Media) quebra coisas diferentes: logo que some, imagem de slider que não aparece, galeria em branco. Raramente derruba menu ou provoca erro de JavaScript no console.
Por isso ele é o último suspeito. Só investigue depois que CSS e JS estiverem resolvidos e o problema restante for imagem faltando. O procedimento é o mesmo: desligar, Purge All, testar em janela anônima. Se for ele, a correção é excluir a imagem específica do lazy load, e não desligar o recurso para o site inteiro:
- Entre em LiteSpeed Cache > Page Optimization e abra a aba Media Excludes.
- Em Lazy Load Image Excludes, cole um trecho único do nome do arquivo da imagem (exemplo fictício:
logo.png), um por linha. - Se preferir excluir pela classe CSS, aperte F12, vá na aba Elements, clique na imagem e copie o valor de
class="..."da tagimg. Cole essa classe em Lazy Load Image Class Name Excludes. - Salve, faça Purge All e teste na janela anônima.
Quando o culpado não é o LiteSpeed
Se a página continua quebrada com ?LSCWP_CTRL=before_optimize ou com todas as otimizações desligadas, pare de mexer no LiteSpeed. Os suspeitos mais comuns nesse caso:
- Outro plugin de otimização ativo ao mesmo tempo (Autoptimize, WP Rocket, plugins de minificação). Dois plugins reescrevendo o mesmo CSS e JS é receita de conflito. Deixe só um.
- Recursos de otimização na CDN, como o Rocket Loader do Cloudflare, que reescreve o carregamento do JavaScript. Eles atuam depois do WordPress e não aparecem no painel do site.
- Atualização recente de tema ou plugin, coincidindo com a quebra. Nesse caso o LiteSpeed só serviu o arquivo novo, já quebrado.
Uma última recomendação: depois de achar a correção, exporte de novo as configurações em Toolbox > Import / Export. O arquivo exportado no começo era o estado quebrado; o novo é o estado que funciona, e é ele que você vai querer importar se precisar refazer tudo.
Referências
- Documentação oficial (litespeed) — LSCWP: troubleshooting page optimization. Consultado em 2026-11-01.