Comment déboguer une application Node.js ?

Lisez ce que votre application a écrit

Une application qui plante dit pourquoi, sur sa sortie standard. Cette sortie va dans un fichier de journal sur votre compte, pas dans votre navigateur.

Pour un projet déployé avec Hodifly, c'est un fichier par projet et par branche :

~/logs/hodifly-<projet>-<branche>.log

Tout ce que votre code écrit avec console.log ou console.error s'y trouve, ainsi que la trace de ce qui a fait tomber l'application. Ouvrez-le dans cPanel > Gestionnaire de fichiers, ou en FTP. Il survit aux déploiements et aux retours arrière, et il est allégé automatiquement quand il devient volumineux.

À ne pas confondre avec le journal de déploiement (cPanel > Hodifly > votre projet > le déploiement), qui concerne la compilation : installation des dépendances, build. L'un vous dit si votre code a été compilé, l'autre ce qu'il a fait une fois lancé.

Pour une application que vous avez installée vous-même dans Setup Node.js App, ajoutez la même chose au fichier .htaccess du dossier sur lequel pointe le domaine, en donnant le chemin complet :

PassengerAppLogFile "/home/UTILISATEUR/logs/mon-app.log"

Obtenir une page d'erreur plus complète

Par défaut, la page d'erreur affichée dans le navigateur est volontairement sommaire. Passenger peut en afficher une détaillée, utile pendant que vous travaillez mais à ne pas laisser sur un site en production : ajoutez ces lignes au même fichier .htaccess, et retirez-les ensuite.

PassengerAppEnv development
PassengerFriendlyErrorPages on

Coupez le problème en deux

Si la cause n'est toujours pas évidente, créez une petite application "Hello World". Si elle tourne, le serveur va bien et le problème est dans votre code. Sinon, voyez « Que faire si une application Node.js ne se lance pas ? ».

Mis à jour le : 31/08/2026