blog
WordPress

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.

JR · · 8 min de leitura · 1 tabela · 2 blocos de código

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
  1. Por que o layout quebra depois de ativar a otimização de página
  2. Como fazer backup e provar que a otimização é a causa
  3. Como isolar a opção culpada testando uma de cada vez
  4. Como ler o console do navegador para achar o arquivo que falhou
  5. Excluir só o arquivo culpado em vez de desligar a opção
  6. Lazy load de imagens: investigar por último e excluir a imagem
  7. 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.

  1. No painel do WordPress, entre em LiteSpeed Cache > Toolbox (Ferramentas, em algumas traduções).
  2. Abra a aba Import / Export.
  3. 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 confirmar que a otimização é a causaOtimização ligada0Página sem otimização…0
Teste de isolamento: compare a página quebrada com e sem o parâmetro de URL antes de desligar qualquer opção.

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:

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.

  1. Com a opção culpada ligada, abra a página quebrada.
  2. Aperte F12 (ou clique com o botão direito e escolha Inspecionar).
  3. Vá na aba Console.
  4. 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.

Isolar a opção culpada em cinco passosFazer backup em Toolbox > Import / ExportDesligar CSS e JS CombinePurge All e teste em janela anônimaReligar uma opção por vezParar na opção que quebra
Sequência de isolamento: uma opção por vez, com teste a cada passo.

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:

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:

  1. Entre em LiteSpeed Cache > Page Optimization e abra a aba Media Excludes.
  2. Em Lazy Load Image Excludes, cole um trecho único do nome do arquivo da imagem (exemplo fictício: logo.png), um por linha.
  3. Se preferir excluir pela classe CSS, aperte F12, vá na aba Elements, clique na imagem e copie o valor de class="..." da tag img. Cole essa classe em Lazy Load Image Class Name Excludes.
  4. 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:

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

  1. Documentação oficial (litespeed) — LSCWP: troubleshooting page optimization. Consultado em 2026-11-01.
Leia também