Questa guida ti aiuta a individuare rapidamente la causa di un problema nel caso in cui il tuo sito Node.js, ospitato sull'infrastruttura Infomaniak, non funzioni come previsto.

Verifica lo stato dell'applicazione

Dalla dashboard del tuo sito Node.js, puoi consultare lo stato attuale dell'applicazione:

• Attiva: la tua applicazione funziona correttamente.
• In fase di riavvio: l'applicazione si sta riavviando, attendere qualche istante.
• Arrestata o In errore: si è verificato un problema.

In caso di errore o interruzione:

• Fare clic su «Avvia» o «Riavvia» l'applicazione.
• Consultare immediatamente la console di esecuzione per identificare eventuali errori tecnici.

Visualizzare la console di esecuzione

La console visualizza i messaggi di errore generati durante l'avvio dell'applicazione. Di seguito sono elencati gli errori più comuni:

• Comando di avvio non corretto: verificare di utilizzare la sintassi corretta (ad 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 le impostazioni dell'applicazione

Nella sezione Impostazioni avanzate del sito, assicurati che tutte le impostazioni siano corrette:

• Directory di esecuzione: directory in cui vengono eseguite le istruzioni build e start.
• Comando di compilazione (opzionale): ad esempio npm run build, se la tua applicazione 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 tua applicazione deve corrispondere a quella definita nel Manager.
• Versione di Node.js: assicurati che sia compatibile con il tuo codice.

Infomaniak mette a disposizione i gestori di pacchetti NPM e Yarn. Puoi scegliere quello più adatto al tuo progetto nell'assistente di configurazione.

Ancora problemi?

Il sito rimane inaccessibile?

• La sua 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, manca 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 è stato decompresso o clonato correttamente nella cartella giusta.
• I file essenziali (package.json, server.js, index.js, ecc.) sono presenti.
• Le dipendenze sono state installate correttamente (la cartella node_modules è presente dopo l'esecuzione di npm install o yarn install).

Se il problema persiste dopo aver effettuato tutte queste verifiche:

• Provate a creare un nuovo sito utilizzando il metodo semplice per testarlo con un esempio funzionante.
• Confrontate la vostra configurazione con quella dell'esempio fornito.
• Consultare la documentazione ufficiale di Node.js per informazioni su errori specifici.
• Se necessario, contattare l'assistenza Infomaniak allegando una copia dei log visualizzati nella console.