# 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.

> 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.

João Rizzon · 2026-11-11 · WordPress

---

## 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](https://docs.litespeedtech.com/lscache/lscwp/ts-optimize/) 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 tag `img`. 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.

