Référence des erreurs de build

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 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 les problèmes courants
3. Contactez le support avec l'ID de votre projet et les détails de l'erreur

Articles associés