L'app ne démarre pas : erreurs de deploy et de site

​

Erreurs d’envoi et de deploy

​

INVALID_DEPENDENCY

​

KEEP_CALM

​

Le site web ne se charge pas

• “The website took too long to respond” : Square Cloud a trouvé votre application mais n’a reçu aucune réponse de sa part.
• “This site couldn’t be found” : aucun site web n’est publié à cette adresse.

1. Faites écouter votre serveur sur le port 80 et l’hôte 0.0.0.0. Un serveur lié à localhost, 127.0.0.1 ou à tout autre port (3000, 5173, 8080…) est injoignable. Le runtime définit les variables d’environnement PORT et HOST à ces valeurs : lisez-les.
   Node.js (Express)

   Python (Flask)

   app.listen(process.env.PORT || 3000, process.env.HOST || "0.0.0.0", () => {
     console.log("Server running");
   });
   
2. Ouvrez les logs : si l’application a planté ou installe encore ses dépendances ou son build, le site ne peut pas encore répondre. Corrigez l’erreur affichée, ou attendez la fin du build.
3. Vérifiez que MEMORY laisse assez de place au build : un build de framework qui manque de RAM arrête l’application avec LACK_OF_RAM.

1. Vérifiez l’adresse : c’est https://<SUBDOMAIN>.squareweb.app, avec le sous-domaine de votre fichier de configuration.
2. Si vous venez de déployer, attendez jusqu’à une minute que l’adresse soit publiée.
3. Une application déployée sans SUBDOMAIN n’est pas un site web et ne peut pas le devenir : envoyez-la à nouveau comme nouvelle application avec SUBDOMAIN défini.
4. Sur un domaine personnalisé, le DNS est peut-être encore en cours de propagation. Voir pourquoi votre domaine ne s’est pas encore propagé.

​

EADDRINUSE (port déjà utilisé)

1. Démarrez un seul serveur web, une seule fois, écoutant sur le port 80 et l’hôte 0.0.0.0.
2. Recherchez dans votre code plus d’un appel .listen() (Node.js) ou run() (Python/Flask/Django) et supprimez le doublon.
3. Vérifiez que l’appel listen se trouve au niveau supérieur de votre fichier de démarrage, et non dans un callback qui peut se déclencher plusieurs fois.

​

« Cannot find module » (Node.js) et ModuleNotFoundError (Python)

• La bibliothèque n’est pas listée dans les dependencies du package.json (Node.js) ou dans requirements.txt/pyproject.toml (Python) : elle n’est donc jamais installée sur la plateforme, même si elle fonctionne sur votre machine.
• En Node.js, le paquet figure seulement dans devDependencies. Les applications tournent avec NODE_ENV=production, donc npm install ignore les dépendances de développement.

1. Ajoutez le paquet manquant à dependencies (ou à votre fichier de dépendances Python) avec une version valide.
2. Confirmez que le fichier de dépendances lui-même est inclus dans le zip que vous avez envoyé.
3. Redémarrez l’application. En Node.js, les dépendances ne sont installées que lorsque node_modules n’existe pas : supprimez node_modules (et package-lock.json, si vous l’avez envoyé) dans le gestionnaire de fichiers du tableau de bord, puis redémarrez pour une réinstallation propre.

​

Erreurs de bindings natifs better-sqlite3

1. Mettez à jour better-sqlite3 vers 12.5.0 ou une version ultérieure (si vous utilisez quick.db, mettez-le à jour vers 9.1.7 ou une version ultérieure).
2. Supprimez node_modules et package-lock.json.
3. Redémarrez l’application pour une réinstallation propre qui reconstruit les bindings natifs pour le runtime actuel.

​

Arrêtée par une limite de ressources

​

Horaires décalés de quelques heures

​

Guides associés

• Fichier de configuration : chaque champ et l’erreur qu’il déclenche.
• Variables d’environnement : définissez vos secrets, puis redémarrez pour les appliquer.
• Erreurs de bot Discord et erreurs de connexion à la base de données.

​

Contactez-nous