# Como corrigir erro 524 A Timeout Occurred (Cloudflare)

O erro 524 A Timeout Occurred é um código do Cloudflare que indica que a origem aceitou a conexão, mas não devolveu a resposta dentro do limite de 100 segundos. No WordPress, costuma vir de processos longos como importações, relatórios pesados ou consultas de banco lentas.

## O que é o erro 524 no WordPress?

O 524 A Timeout Occurred é um erro próprio do Cloudflare, não um código HTTP padrão. Ele acontece quando o Cloudflare conecta à origem com sucesso, mas o servidor demora mais do que o tempo limite de 100 segundos para enviar a resposta HTTP completa. Diferente do 522 (em que a conexão sequer se completa), no 524 a conexão é estabelecida e o problema é puramente o tempo de processamento. No WordPress, o gatilho típico é uma operação longa rodando dentro do ciclo de requisição web: importação de conteúdo, geração de relatório, backup ou uma consulta de banco lenta.

## Como identificar

- Tela do Cloudflare com "Error 524: A timeout occurred" após cerca de 100 segundos de espera.
- O erro aparece em tarefas longas (importação, relatório do WooCommerce, backup) e não em páginas comuns.
- A operação às vezes conclui no servidor mesmo com o navegador exibindo o 524, sinal de processo que passou de 100s.
- No log do servidor, a requisição que deu 524 aparece ainda em execução além do tempo limite do Cloudflare.

## Como prevenir

- Execute importações, exportações e backups via WP-CLI ou processo de fundo, nunca pela requisição web
- Mantenha o banco otimizado, com wp_options enxuto e consultas indexadas
- Use um cron real do servidor no lugar do WP-Cron para tarefas agendadas pesadas

Erros relacionados

- [Como corrigir erro 521 Web Server is Down](https://full.services/wp-fixer/corrigir-erro-521-wordpress/)
- [Como corrigir erro 522 Connection Timed Out (Cloudflare)](https://full.services/wp-fixer/corrigir-erro-522-wordpress/)
- [Como corrigir o erro 504 Gateway Timeout](https://full.services/wp-fixer/como-corrigir-erro-504-wordpress/)

## Causa

- Processo longo dentro do ciclo web (importação, exportação, backup) ultrapassando os 100 segundos do Cloudflare.
- Consulta de banco lenta (tabela sem índice, wp_options inchado) prolongando a resposta da página.
- Plugin de relatório ou de cron rodando tarefa pesada via requisição HTTP em vez de processo de fundo.
- PHP-FPM com poucos workers, enfileirando requisições e atrasando a resposta sob carga.
- Loop ou chamada externa lenta no código de um plugin/tema travando a conclusão da requisição.

## Como resolver

1. Identifique a operação que estoura 100s: veja qual ação dispara o 524: importação, relatório, busca ou salvamento em massa. O 524 é sempre sobre tempo, então localizar a tarefa longa é o primeiro passo do diagnóstico.
2. Rode tarefas pesadas fora do ciclo web: mova importações, exportações e backups para o WP-CLI ou para um processo de fundo. Fora da requisição HTTP, eles não ficam sujeitos ao limite de 100 segundos do Cloudflare.
3. Otimize o banco de dados: limpe a tabela wp_options de entradas autoload inchadas e adicione índices a consultas lentas. Uma query lenta é a causa silenciosa mais comum de páginas que passam dos 100 segundos.
4. Faça a operação direto na origem: para uma tarefa pontual que precisa passar de 100s, execute-a com o Cloudflare em modo Development ou pelo IP direto da origem, que não impõe o limite do proxy.
5. Ajuste o PHP-FPM e o cron: aumente o número de workers do PHP-FPM se as requisições enfileiram, e troque o WP-Cron por um cron real do servidor para tirar tarefas agendadas pesadas do ciclo de visita.

## Perguntas frequentes

### O que significa o erro 524 A Timeout Occurred?

É um erro do Cloudflare que indica que a origem aceitou a conexão, mas não devolveu a resposta dentro do limite de 100 segundos. O problema é tempo de processamento: a página ou a tarefa demorou demais para concluir.

### Qual a diferença entre o erro 524 e o erro 522?

No 522 a conexão com a origem sequer se completa (timeout de conexão). No 524 a conexão é estabelecida, mas a resposta demora mais que 100 segundos. O 522 é sobre conectar; o 524 é sobre o tempo de processar a requisição.

### Por que o 524 só aparece em importações e relatórios?

Porque essas tarefas rodam por muito tempo dentro do ciclo de requisição e passam dos 100 segundos do Cloudflare. Páginas comuns respondem rápido. Mover essas tarefas para o WP-CLI ou processo de fundo elimina o 524.

### A tarefa concluiu no servidor mas o navegador deu 524. Por quê?

Porque o Cloudflare cortou a espera em 100 segundos e devolveu o 524, enquanto o PHP continuou processando até terminar no servidor. O erro é só do tempo de espera do proxy, não significa que a operação falhou.

### Posso aumentar o limite de 100 segundos do Cloudflare?

Nos planos padrão o limite de 100 segundos é fixo. O caminho é reduzir o tempo de resposta: rodar tarefas longas fora do ciclo web, otimizar consultas e ajustar o PHP-FPM, em vez de tentar esticar o timeout do proxy.

### Otimizar o banco ajuda no erro 524?

Ajuda diretamente. Uma consulta lenta, como em uma wp_options inchada, prolonga a resposta da página até estourar os 100 segundos. Limpar o autoload e indexar as consultas pesadas reduz o tempo e evita o 524.

**Fonte:** [MDN Web Docs — HTTP response status codes](https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Status)