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'expiration 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.

Solution :

1. Exécutez jamdesk validate localement pour voir les erreurs détaillées
2. Vérifiez l'absence de 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.

Solution :

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 la capitalisation

INVALID_FRONTMATTER

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

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

Solution :

1. Assurez-vous que le frontmatter commence et se termine par ---
2. Vérifiez l'absence de syntaxe YAML invalide (deux-points manquants, indentation incorrecte)
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.

Solution :

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 normal : \{ au lieu de {

COMPONENT_NOT_FOUND

Message : "Unknown component 'ComponentName'"

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

Solution :

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.

Solution :

1. Consultez la documentation du composant pour connaître les props valides
2. Retirez toute prop non prise en charge
3. Vérifiez le type attendu de la prop dans la documentation du composant (par exemple, cols attend un nombre, pas une chaîne)

Erreurs OpenAPI

OPENAPI_PARSE_ERROR

Message : "Failed to parse OpenAPI specification"

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

Solution :

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

OPENAPI_REFERENCE_ERROR

Message : "Unresolved reference in OpenAPI spec"

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

Solution :

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. Si une $ref pointe vers un fichier externe ou une URL, confirmez que le fichier est inclus dans votre projet et que l'URL est accessible

Délai d'expiration du build

BUILD_TIMEOUT

Message : "Build exceeded maximum time limit"

Cause : Le build a duré plus longtemps que le temps autorisé (généralement 5 minutes).

Solution :

1. Optimisez les grandes images (compression ou redimensionnement)
2. Divisez les pages très volumineuses en pages plus petites
3. Réduisez le nombre de pages si le projet est extrêmement volumineux
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.

Solution :

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 de fichier exact

ASSET_TOO_LARGE

Message : "Asset exceeds maximum file size"

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

Solution :

1. Compressez les images avec des outils comme TinyPNG ou ImageOptim
2. Utilisez des formats adapté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 complet du build 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 connexes