---
title: Référence des erreurs de build
description: Chaque code d'erreur de build avec sa cause et sa correction — configuration, syntaxe MDX, OpenAPI, délais d'attente et problèmes d'assets.
---

Trouvez votre code d'erreur avec Ctrl/Cmd+F ou parcourez par catégorie : configuration, MDX, OpenAPI, délais d'attente et assets.

## Erreurs de configuration

### INVALID_DOCS_JSON

**Message :** "Invalid docs.json configuration"

**Cause :** Votre fichier `docs.json` contient des erreurs de syntaxe ou des valeurs invalides.

**Correction :**
1. Exécutez `jamdesk validate` localement pour voir les erreurs détaillées
2. Vérifiez les virgules, crochets ou guillemets manquants
3. Vérifiez que toutes les valeurs correspondent au schéma attendu

### MISSING_PAGE

**Message :** "Page 'path/to/page' referenced in navigation but file not found"

**Cause :** Une page listée dans la navigation de `docs.json` n'existe pas.

**Correction :**
1. Vérifiez que le fichier existe au chemin spécifié
2. Vérifiez que le chemin dans `docs.json` correspond au nom de fichier réel (sans `.mdx`)
3. Les chemins sont sensibles à la casse, vérifiez donc les majuscules

### INVALID_FRONTMATTER

**Message :** "Invalid frontmatter in 'path/to/page'"

**Cause :** Le frontmatter YAML en haut d'un fichier MDX est mal formé.

**Correction :**
1. Assurez-vous que le frontmatter commence et se termine par `---`
2. Vérifiez la syntaxe YAML invalide (deux-points manquants, mauvaise indentation)
3. Mettez entre guillemets les chaînes contenant des caractères spéciaux

## Erreurs MDX

### MDX_SYNTAX_ERROR

**Message :** "MDX compilation failed"

**Cause :** Syntaxe MDX ou JSX invalide dans votre contenu.

**Correction :**
1. Assurez-vous que toutes les balises JSX sont correctement fermées (`<Card>...</Card>`)
2. Vérifiez que les props utilisent la syntaxe correcte (`title="value"` et non `title=value`)
3. Échappez les accolades dans le texte ordinaire : `\{` au lieu de `{`

### COMPONENT_NOT_FOUND

**Message :** "Unknown component 'ComponentName'"

**Cause :** Utilisation d'un composant qui n'existe pas dans Jamdesk.

**Correction :**
1. Consultez la [référence des composants](/fr/components/overview) pour les noms corrects
2. Les composants sont sensibles à la casse : utilisez `<Card>` et non `<card>`
3. Vérifiez que vous n'importez pas de composants personnalisés (non pris en charge)

### INVALID_PROPS

**Message :** "Invalid props for component 'ComponentName'"

**Cause :** Un composant a reçu des props qu'il n'accepte pas.

**Correction :**
1. Consultez la documentation du composant pour les props valides
2. Supprimez les props non prises en charge
3. Assurez-vous que les valeurs des props sont du bon type

## Erreurs OpenAPI

### OPENAPI_PARSE_ERROR

**Message :** "Failed to parse OpenAPI specification"

**Cause :** Votre fichier de spécification OpenAPI a une syntaxe ou une structure invalide.

**Correction :**
1. Exécutez `jamdesk openapi-check` pour valider localement
2. Utilisez un validateur OpenAPI comme Swagger Editor
3. Vérifiez la syntaxe JSON ou YAML valide

### OPENAPI_REFERENCE_ERROR

**Message :** "Unresolved reference in OpenAPI spec"

**Cause :** Un `$ref` dans votre spécification OpenAPI pointe vers une définition inexistante.

**Correction :**
1. Vérifiez que tous les chemins `$ref` sont corrects
2. Vérifiez que les schémas référencés existent dans `components/schemas`
3. Assurez-vous que les références externes sont accessibles

## Délai d'attente de build

### BUILD_TIMEOUT

**Message :** "Build exceeded maximum time limit"

**Cause :** Le build a pris plus de temps que la durée autorisée (généralement 5 minutes).

**Correction :**
1. Optimisez les images volumineuses (compression ou redimensionnement)
2. Divisez les pages très longues en pages plus petites
3. Réduisez le nombre de pages si elles sont extrêmement nombreuses
4. Contactez le support si le problème persiste

## Erreurs d'assets

### ASSET_NOT_FOUND

**Message :** "Asset 'path/to/asset' not found"

**Cause :** Une image ou un fichier référencé dans votre documentation n'existe pas.

**Correction :**
1. Vérifiez que le fichier existe au chemin spécifié
2. Vérifiez que le chemin est relatif à votre répertoire de documentation
3. Les chemins sont sensibles à la casse, vérifiez donc le nom du fichier exactement

### ASSET_TOO_LARGE

**Message :** "Asset exceeds maximum file size"

**Cause :** Une image ou un fichier dépasse la limite de 10 Mo.

**Correction :**
1. Compressez les images avec des outils comme TinyPNG ou ImageOptim
2. Utilisez des formats appropriés (WebP pour les photos, SVG pour les icônes)
3. Envisagez d'héberger les fichiers très volumineux en externe

## Obtenir de l'aide

Si vous ne parvenez pas à résoudre une erreur :

1. Consultez le journal de build complet dans votre dashboard pour plus de contexte
2. Recherchez dans la [FAQ](/fr/help/faq) les problèmes courants
3. [Contactez le support](/fr/help/support/contact) avec l'ID de votre projet et les détails de l'erreur

## Articles associés

<Columns cols={2}>
  <Card title="Échecs de build" icon="triangle-exclamation" href="/fr/help/troubleshooting/build-failures">
    Échecs de build courants et solutions
  </Card>
  <Card title="Contacter le support" icon="headset" href="/fr/help/support/contact">
    Obtenez l'aide de notre équipe
  </Card>
</Columns>