webclone/SOLUCAO-PROBLEMAS.md

🔧 Solução de Problemas - CloneWeb

Problemas Comuns e Soluções

❌ Erro: "Failed to load resource: 404 (Not Found)"

Causa: Recurso não encontrado ou serviço não iniciado corretamente.

Soluções:

1. Verificar se os serviços estão rodando:

   # Verificar se as portas estão em uso
   netstat -an | findstr :3000
   netstat -an | findstr :3001
   

2. Reiniciar os serviços:

   # Parar processos existentes
   taskkill /f /im node.exe
   
   # Iniciar novamente
   cd simple-crawler
   npm start
   
   # Em outro terminal
   cd web-interface  
   npm start
   

3. Usar os scripts de inicialização:

   • Execute start-app.bat ou start-app.ps1

⚠️ Erro: "Content Security Policy directive violated"

Causa: Política de segurança bloqueando recursos.

Solução: Já corrigido na versão atual. Se persistir:

1. Limpe o cache do navegador (Ctrl+Shift+Delete)
2. Recarregue a página (F5 ou Ctrl+F5)
3. Tente em modo anônimo/privado

🚫 Erro: "Crawler service unavailable"

Causa: Serviço do crawler não está rodando na porta 3001.

Soluções:

1. Verificar se a porta está livre:

   netstat -an | findstr :3001
   

2. Iniciar o crawler manualmente:

   cd simple-crawler
   npm start
   

3. Verificar dependências:

   cd simple-crawler
   npm install
   

📁 Erro: "Não foi possível abrir a pasta"

Causa: Problema com permissões ou caminho inválido.

Soluções:

1. Abrir manualmente: Navegue até a pasta cloned-sites/
2. Verificar permissões: Execute como administrador
3. Caminho alternativo: Copie o caminho da pasta dos resultados

🌐 Erro: "Não foi possível abrir o site"

Causa: Arquivo index.html não encontrado ou corrompido.

Soluções:

1. Verificar se o arquivo existe: cloned-sites/[site]/index.html
2. Abrir manualmente: Clique duplo no arquivo index.html
3. Usar o script: Execute abrir-site.bat na pasta do clone

🕷️ Erro durante o crawling: "Assignment to constant variable"

Causa: Erro no código (já corrigido).

Solução: Reinicie o serviço do crawler:

# Parar o crawler
Ctrl+C no terminal do crawler

# Iniciar novamente
npm start

📦 Poucos assets baixados

Causa: Site usa assets externos ou protegidos.

Explicação: Normal para alguns sites. O sistema baixa apenas assets acessíveis publicamente.

🔄 Site não funciona offline

Possíveis causas:

1. JavaScript externo: Site depende de APIs externas
2. CDNs: Recursos hospedados em CDNs não foram baixados
3. CORS: Políticas de segurança do navegador

Soluções:

1. Alguns sites podem ter funcionalidade limitada offline
2. Sites estáticos funcionam melhor
3. Teste com sites simples primeiro

🚀 Dicas de Uso

Sites que funcionam bem:

• ✅ Sites estáticos (HTML/CSS simples)
• ✅ Blogs e sites de notícias
• ✅ Páginas de documentação
• ✅ Sites com poucos recursos externos

Sites que podem ter limitações:

• ⚠️ SPAs (Single Page Applications)
• ⚠️ Sites com muitas APIs externas
• ⚠️ Aplicações web complexas
• ⚠️ Sites com autenticação

Melhor performance:

1. Teste com sites simples primeiro
2. Aguarde o processo completo (pode demorar para sites grandes)
3. Verifique a conexão com internet durante o processo
4. Use URLs completas (https://exemplo.com)

📞 Suporte

Se os problemas persistirem:

1. Verifique os logs nos terminais dos serviços
2. Reinicie completamente o sistema
3. Teste com um site simples como https://example.com
4. Verifique se todas as dependências estão instaladas

🔄 Reinicialização Completa

Para resolver a maioria dos problemas:

# 1. Parar todos os processos Node.js
taskkill /f /im node.exe

# 2. Aguardar 5 segundos

# 3. Iniciar novamente
start-app.bat

Ou use o PowerShell:

# 1. Parar processos
Get-Process node -ErrorAction SilentlyContinue | Stop-Process -Force

# 2. Iniciar novamente  
.\start-app.ps1