---
title: Échecs de build
description: "Associez votre erreur de build à une solution : erreurs de configuration, erreurs de syntaxe MDX, fichiers manquants, problèmes OpenAPI et délais dépassés."
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://jamdesk.com/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Ouvrez le build ayant échoué dans votre onglet **Déploiements** et associez le message d'erreur à une section ci-dessous.

## Trouver l'erreur

1. Allez dans l'onglet **Déploiements** de votre projet
2. Cliquez sur le build ayant échoué
3. Examinez le message d'erreur et le journal

Le journal indique exactement ce qui n'a pas fonctionné et où.

## Échecs courants

### Configuration invalide

**Erreur :** « Invalid docs.json »

Votre `docs.json` contient des erreurs de syntaxe ou de schéma.

**Solution :**
1. Vérifiez l'absence de virgules, crochets ou guillemets manquants
2. Exécutez `jamdesk validate` localement
3. Comparez avec la [référence du schéma](https://jamdesk.com/docs/fr/config/docs-json-reference)

### Pages manquantes

**Erreur :** « Page 'path/to/page' not found »

Une page dans la navigation n'existe pas.

**Solution :**
- Vérifiez que le fichier existe
- Vérifiez que le chemin correspond exactement (sensible à la casse)
- N'incluez pas l'extension `.mdx` dans `docs.json`

### Erreurs de syntaxe MDX

**Erreur :** « MDX compilation failed »

Syntaxe MDX ou JSX invalide.

**Causes courantes :**
- Balises non fermées : `<Card>` sans `</Card>`
- Accolades non échappées : `{` au lieu de `\{`
- Props invalides : `title=value` au lieu de `title="value"`

### Images manquantes

**Erreur :** « Asset not found »

Une image référencée dans le MDX n'existe pas.

**Solution :**
- Vérifiez que le chemin de l'image est correct
- Les chemins sont relatifs à votre répertoire de documentation
- Vérifiez que le fichier a été commité dans Git

## Étapes de débogage

### 1. Lire l'erreur

Le journal indique exactement ce qui a échoué et où.

### 2. Tester localement

Exécutez `jamdesk dev` pour reproduire l'erreur.

### 3. Valider la configuration

Exécutez `jamdesk validate` pour vérifier votre configuration.

### 4. Vérifier les modifications récentes

Examinez votre dernier commit pour identifier le problème.

## Toujours bloqué ?

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

1. Copiez le journal de build complet
2. Notez l'identifiant de votre projet
3. [Contactez le support](https://jamdesk.com/docs/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="Aperçu du CLI" icon="terminal" href="/fr/cli/overview">
    Tester les builds localement
  </Card>
</Columns>