---
title: Dépannage des builds
description: "Résolvez les échecs de build courants : config, dépendances manquantes, syntaxe MDX, icônes. Messages d'erreur associés à leurs causes et solutions."
---

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

1. Accédez à l'onglet **Deployments** de votre projet
2. Cliquez sur le build échoué
3. 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.

<Steps>
  <Step title="Vérifier la syntaxe JSON">
    Recherchez les virgules, crochets ou guillemets manquants.
  </Step>
  <Step title="Valider localement">
    Exécutez `jamdesk validate` pour afficher les erreurs détaillées.
  </Step>
  <Step title="Corriger et pousser">
    Corrigez les erreurs et poussez pour déclencher un nouveau build.
  </Step>
</Steps>

### 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

<Accordion title="Étape 1 : Vérifier le journal de build">
  Le journal indique la ligne exacte et le fichier causant l'erreur. Commencez par là.
</Accordion>

<Accordion title="Étape 2 : Tester localement">
  Exécutez `jamdesk dev` localement pour reproduire et déboguer le problème.
</Accordion>

<Accordion title="Étape 3 : Valider la configuration">
  Exécutez `jamdesk validate` pour vérifier votre `docs.json` et `jamdesk broken-links` pour les liens internes cassés.
</Accordion>

<Accordion title="Étape 4 : Vérifier les modifications récentes">
  Examinez votre dernier commit. Avez-vous ajouté une nouvelle page ? Modifié la configuration ?
</Accordion>

## Toujours bloqué ?

Si vous ne parvenez pas à résoudre le problème :

1. Copiez le journal de build complet
2. Notez l'ID de votre projet (dans l'URL)
3. [Contacter le support](/fr/help/support/contact)

## Articles connexes

<Columns cols={2}>
  <Card title="Référence des erreurs" icon="book" href="/fr/help/troubleshooting/error-reference">
    Tous les codes d'erreur expliqués
  </Card>
  <Card title="Surveillance des builds" icon="chart-line" href="/fr/builds/monitoring">
    Suivre la progression du build
  </Card>
</Columns>