163 lines
4.1 KiB
Markdown
163 lines
4.1 KiB
Markdown
# 🔧 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**:
|
|
```bash
|
|
# Verificar se as portas estão em uso
|
|
netstat -an | findstr :3000
|
|
netstat -an | findstr :3001
|
|
```
|
|
|
|
2. **Reiniciar os serviços**:
|
|
```bash
|
|
# 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**:
|
|
```bash
|
|
netstat -an | findstr :3001
|
|
```
|
|
|
|
2. **Iniciar o crawler manualmente**:
|
|
```bash
|
|
cd simple-crawler
|
|
npm start
|
|
```
|
|
|
|
3. **Verificar dependências**:
|
|
```bash
|
|
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:
|
|
```bash
|
|
# 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:
|
|
|
|
```bash
|
|
# 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:
|
|
```powershell
|
|
# 1. Parar processos
|
|
Get-Process node -ErrorAction SilentlyContinue | Stop-Process -Force
|
|
|
|
# 2. Iniciar novamente
|
|
.\start-app.ps1
|
|
``` |