Questa guida vi aiuta a diagnosticare rapidamente l'origine di un problema se il vostro sito Node.js, ospitato sull'infrastruttura Infomaniak, non funziona come previsto.

Verificare lo stato dell'applicazione

Dal dashboard del vostro sito Node.js, potete consultare lo stato attuale dell'applicazione:

• Attivo: la vostra applicazione funziona normalmente.
• In corso di riavvio: l'applicazione si sta riavviando, attendete alcuni istanti.
• Arrestata o In errore: c'è un problema.

In caso di errore o di arresto:

• Cliccate su "Avvia" o "Riavvia" l'applicazione.
• Consultate immediatamente la console di esecuzione per identificare eventuali errori tecnici.

Leggere la console di esecuzione

La console visualizza i messaggi di errore generati durante l'avvio della vostra applicazione. Ecco gli errori frequenti:

• Comando di avvio errato: verificate di utilizzare la sintassi corretta (esempio: npm start, node app.js, ecc.).
• Errore nel codice sorgente: potrebbe trattarsi di un'eccezione non gestita, di un modulo mancante o di una porta definita in modo errato.

Verificare i parametri dell'applicazione

Nella sezione Parametri avanzati del sito, assicuratevi che tutte le impostazioni siano corrette:

• Cartella di esecuzione: cartella in cui vengono eseguiti i comandi build e start.
• Comando di costruzione (opzionale): ad esempio npm run build se la vostra app ne richiede uno.
• Comando di avvio: ad esempio node index.js, npm start, ecc.
• Porta di ascolto: la porta su cui l'applicazione attende le richieste (ad esempio 8080, 3000, ecc.).
  • La porta configurata nella vostra applicazione deve corrispondere a quella definita nel Manager.
• Versione di Node.js: assicuratevi che sia compatibile con il vostro codice.

Infomaniak mette a disposizione i gestori di pacchetti NPM e Yarn. È possibile scegliere quello che corrisponde al proprio progetto nell'assistente di configurazione.

Ancora bloccato?

Il sito rimane inaccessibile?

• La tua applicazione potrebbe essere in modalità manutenzione.
• La porta di ascolto dell'applicazione potrebbe essere errata o bloccata.
• L'applicazione non restituisce una risposta HTTP corretta (ad esempio, non è presente res.send() o res.end() nel server).

Hai utilizzato un metodo di installazione avanzato?

Se hai importato il tuo codice tramite Git, ZIP, SSH o SFTP, assicurati che:

• Il codice sia stato correttamente decompresso o clonato nella cartella giusta.
• I file essenziali (package.json, server.js, index.js, ecc.) siano presenti.
• Le dipendenze siano correttamente installate (node_modules presente dopo npm install o yarn install).

Se il problema persiste dopo tutti questi controlli:

• Prova a creare un nuovo sito con il metodo semplice per testare con un esempio funzionante.
• Confronta la tua configurazione con quella dell'esempio fornito.
• Consulta la documentazione ufficiale di Node.js per errori specifici.
• In caso di necessità, contatta il supporto Infomaniak con una copia dei log visualizzati nella console.