Pular para o conteúdo principal

Problemas Comuns & Soluções

Um guia abrangente para os problemas mais comuns e suas soluções.

Problemas de Instalação​

Página Branca em Branco Após a Instalação​

Causa: Geralmente um problema de permissões de arquivo.

Solução:

# Verificar o log do Laravel
tail -50 storage/logs/laravel.log

# Corrigir permissões
sudo chmod -R 775 storage bootstrap/cache
sudo chown -R www-data:www-data storage bootstrap/cache

Erros de "Classe Não Encontrada"​

Causa: Dependências do Composer não instaladas ou autoloader não gerado.

Solução:

composer install --no-dev --optimize-autoloader
php artisan config:clear

Instalador Mostra "Já Instalado"​

Causa: O arquivo storage/installed.lock existe.

Solução: Se você precisar executar novamente o instalador:

rm storage/installed.lock

Em seguida, acesse /install novamente.

CSS/JS Não Carregando (Página Sem Estilo)​

Causa: Link simbólico de armazenamento ausente ou problema com o caminho dos assets.

Solução:

php artisan storage:link
php artisan config:clear
php artisan view:clear

Verifique também se o APP_URL no .env corresponde ao seu domínio real (incluindo https://).

Problemas com o Banco de Dados​

"SQLSTATE[HY000] [2002] Connection Refused"​

Causa: MySQL não está rodando ou host errado.

Solução:

  • Verifique se o MySQL está rodando: sudo systemctl status mysql
  • Tente 127.0.0.1 em vez de localhost no .env
  • Verifique a porta (padrão: 3306)

"SQLSTATE[HY000] [1045] Access Denied"​

Causa: Credenciais incorretas do banco de dados.

Solução:

  • Verifique o usuário/senha no .env
  • Teste a conexão: mysql -u your_user -p your_database
  • Reatribua permissões:
GRANT ALL PRIVILEGES ON feedbackpulse.* TO 'your_user'@'localhost';
FLUSH PRIVILEGES;

Emojis Aparecendo como ????​

Causa: O charset do banco de dados é utf8 em vez de utf8mb4.

Solução:

ALTER DATABASE feedbackpulse CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Problemas com o Servidor Web​

Todas as Rotas Retornam 404​

Solução para Apache:

sudo a2enmod rewrite
sudo systemctl restart apache2

Certifique-se de que AllowOverride All está definido no seu virtual host.

Solução para Nginx: Certifique-se de que seu bloco de servidor tem:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

502 Bad Gateway (Nginx)​

Causa: PHP-FPM não está rodando ou caminho do socket errado.

Solução:

sudo systemctl restart php8.4-fpm
# Verificar o caminho do socket
ls /var/run/php/php8.4-fpm.sock

413 Request Entity Too Large​

Causa: Limite de tamanho de upload muito baixo.

Solução (Nginx):

client_max_body_size 20M;

Solução (PHP):

upload_max_filesize = 20M
post_max_size = 25M

Problemas de Autenticação​

"Incompatibilidade de Token CSRF" (Erro 419)​

Causa: Sessão expirada ou problema com cookies.

Solução:

  • Limpe os cookies do navegador e tente novamente
  • Verifique SESSION_DOMAIN no .env (defina como .yourdomain.com para subdomínios)
  • Certifique-se de que SESSION_SECURE_COOKIE=true apenas se estiver usando HTTPS

Não Consigo Fazer Login Após Redefinição de Senha​

Causa: O navegador armazenou em cache a sessão antiga.

Solução: Limpe os cookies do navegador ou use o modo anônimo.

Login Social Retorna Erro​

Causa: Incompatibilidade na URL de callback.

Solução: Certifique-se de que a URL de callback no console do Google/GitHub corresponde exatamente a:

  • Google: https://yourdomain.com/auth/google/callback
  • GitHub: https://yourdomain.com/auth/github/callback

Problemas de Pagamento​

Consulte Problemas com Gateway de Pagamento para solução de problemas detalhada de pagamentos.

Problemas de E-mail​

Consulte E-mail Não Enviando para solução de problemas detalhada de e-mail.

Problemas de Desempenho​

Consulte Otimização de Desempenho para dicas de otimização.

Problemas de Cache​

Em caso de dúvida, limpe todos os caches:

php artisan optimize:clear

Isso limpa:

  • Cache de configuração
  • Cache de rotas
  • Cache de views
  • Cache da aplicação
  • Cache de classes compiladas

Modo Debug (Temporário)​

Para ver mensagens de erro detalhadas:

  1. Edite .env:
APP_DEBUG=true
LOG_LEVEL=debug
  1. Reproduza o erro
  2. Verifique a página de erro ou storage/logs/laravel.log
  3. Imediatamente defina APP_DEBUG=false quando terminar!
aviso

Nunca deixe APP_DEBUG=true em produção. Ele expõe informações sensíveis.

Obtendo Ajuda​

Se nada acima resolver seu problema:

  1. Verifique storage/logs/laravel.log para o rastreamento completo do erro
  2. Verifique o log de erro do seu servidor web (/var/log/nginx/error.log ou /var/log/apache2/error.log)
  3. Pesquise nos comentários do item no CodeCanyon por problemas semelhantes
  4. Abra um ticket de suporte com:
    • Mensagem de erro (do log)
    • Versão do PHP (php -v)
    • Versão do Laravel
    • Detalhes do servidor (SO, servidor web, versão do MySQL)
    • Passos para reproduzir