Dépanner les aperçus

Trouvez votre symptôme, appliquez la solution. Quand aucun ne correspond, la solution passe-partout est Analyse & Fix : elle lit les logs pour que vous n'ayez pas à le faire.

L'aperçu ne démarre pas

La construction échoue. Les logs se terminent par une erreur de construction ou de compilation. C'est un problème de code issu d'un changement récent : lancez Analyse & Fix, ou répondez dans la discussion responsable.

Il reste bloqué à l'installation ou à la construction. Les premiers démarrages sont lents, c'est normal : les dépendances s'installent de zéro. S'il n'y a pas eu de nouvelle ligne de log depuis plusieurs minutes, arrêtez l'aperçu et relancez-le ; un cache périmé ou une panne réseau passagère survit rarement à un redémarrage.

Une erreur de base de données au démarrage (aperçus d'API). Les migrations et le schéma ne concordent pas, ce qui est courant juste après un changement du modèle de données. Analyse & Fix résout le désaccord ; voir Bases de données d'aperçu pour la façon dont la base éphémère est préparée.

L'aperçu marchait, il a disparu

Le lien est mort, l'aperçu a disparu. Les aperçus sont éphémères : les inactifs sont nettoyés automatiquement pour libérer des ressources. Rien n'est perdu (votre code est dans le dépôt) : lancez simplement un nouvel aperçu. N'oubliez pas que la base de données repart à zéro avec lui.

Il montre un ancien comportement. Vous prévisualisez sans doute une autre branche ou un autre espace de discussion que vous ne le pensez. Vérifiez depuis quelle source l'aperçu a été lancé dans le Preview Hub : les changements d'une discussion apparaissent dans son aperçu, pas dans un aperçu construit depuis votre branche par défaut.

Il démarre, mais se comporte mal

Page blanche ou chargement sans fin. Ouvrez les logs et regardez-les pendant que vous rechargez la page : une erreur d'exécution s'affichera à ce moment-là. Confiez-la à Analyse & Fix.

Données fausses ou manquantes. Les aperçus tournent sur des données d'exemple, pas sur vos enregistrements de production. Un écran vide peut simplement vouloir dire que les données d'exemple ne couvrent pas ce cas : demandez à l'IA de les étendre.

Ça marche sur ordinateur, c'est cassé sur téléphone. De vrais bugs de mise en page ; signalez-les avec des captures ou des annotations. Voir Tester sur votre téléphone.

Un nouvel aperçu ne démarre pas du tout

Vous avez peut-être atteint la limite d'aperçus simultanés de votre espace de travail. Arrêtez dans le Preview Hub un aperçu dont vous n'avez plus besoin et lancez le nouveau. Les limites suivent votre formule : voir les tarifs.

L'aperçu d'API n'atteint pas la base de données

Les logs mentionnent localhost:5432, une connexion refusée ou « database does not exist ». L'API vise encore une base Postgres locale au lieu de la base d'aperçu démarrée par EvonX. Relancez l'aperçu pour que l'injection des variables d'environnement se refasse. Si cela continue après un changement de code, utilisez Analyse & Fix : c'est la voie habituelle quand l'app ignore la chaîne de connexion injectée.

L'app démarre, puis plante sur une table manquante (par exemple une étape de données d'exemple qui parle d'une relation qui n'existe pas). Les migrations et le modèle ont divergé. Lancez Analyse & Fix, ou demandez à une discussion d'aligner le schéma sur ce que le démarrage attend. Voir Bases de données d'aperçu.

Voir aussi

• Analyse & Fix : la voie automatique quand les logs sont un mur de texte.
• Lire les logs d'aperçu : comment trouver la première erreur vous-même.