Runbook — UOL/cPanel, 504 e Resource Limit

Sintomas

• Gateway Timeout.
• Resource Limit Is Reached.
• Requisição fica carregando infinitamente.
• Exportação de arquivos processa parte do lote e falha.

Causas comuns

• Geração de ZIP grande em uma única requisição.
• Falta de índices em tabelas de candidatos/currículos.
• max_execution_time, memória ou I/O limitados na hospedagem.
• Banco remoto lento ou timeout de conexão alto.
• Arquivos em storage/curriculos ausentes após deploy.

Correções recomendadas

1. Usar exportação individual em PDF, não ZIP.
2. Limitar EXPORT_MAX_SELECIONADOS.
3. Aplicar índices em candidates conforme SQL de otimização.
4. Configurar DB_CONNECT_TIMEOUT=3.
5. Não apagar storage/curriculos.
6. Manter logs internos, mas não exibir erro bruto ao usuário.
7. Remover install.php após a instalação.

Checklist rápido

php -v
php -m | grep -E "pdo_mysql|gd|fileinfo"
find storage/curriculos -type f | head