Dépannage des builds
Résolvez les échecs de build courants en associant les messages d'erreur à leurs causes et solutions. Couvre les erreurs de configuration, les dépendances manquantes, la syntaxe MDX et les problèmes d'icônes.
Lorsqu'un build échoue, vérifiez le message d'erreur dans le journal de build et trouvez la section correspondante ci-dessous.
Afficher les détails de l'erreur
- Accédez à l'onglet Deployments de votre projet
- Cliquez sur le build échoué
- Examinez le message d'erreur et le journal de build
Le journal indique exactement où et pourquoi le build a échoué.
Erreurs courantes
Erreurs de configuration
"Invalid docs.json" — Votre fichier de configuration contient des erreurs de syntaxe.
Recherchez les virgules, crochets ou guillemets manquants.
Exécutez jamdesk validate pour afficher les erreurs détaillées.
Corrigez les erreurs et poussez pour déclencher un nouveau build.
Pages manquantes
"Page not found" — Une page dans votre navigation n'existe pas.
- Vérifiez que le nom du fichier correspond au chemin dans
docs.json - Les chemins sont sensibles à la casse
- N'incluez pas l'extension
.mdx
Erreurs de syntaxe MDX
"MDX compilation failed" — Syntaxe MDX ou JSX invalide.
Causes courantes :
- Balises non fermées (
<Card>sans</Card>) - Caractères spéciaux non échappés (
{au lieu de\{) - Syntaxe de prop invalide
Timeout de build
"Build exceeded time limit" — Le build a pris trop de temps.
Essayez :
- D'optimiser les images volumineuses
- De diviser les pages très longues
- De réduire le nombre total de pages
Étapes de débogage
Le journal indique la ligne exacte et le fichier causant l'erreur. Commencez par là.
Exécutez jamdesk dev localement pour reproduire et déboguer le problème.
Exécutez jamdesk validate pour vérifier votre docs.json et jamdesk broken-links pour les liens internes cassés.
Examinez votre dernier commit. Avez-vous ajouté une nouvelle page ? Modifié la configuration ?
Toujours bloqué ?
Si vous ne parvenez pas à résoudre le problème :
- Copiez le journal de build complet
- Notez l'ID de votre projet (dans l'URL)
- Contacter le support