Build-Fehlerreferenz

Finde deinen Fehlercode mit Ctrl/Cmd+F oder durchsuche die Kategorien: Konfiguration, MDX, OpenAPI, Timeouts und Assets.

Konfigurationsfehler

INVALID_DOCS_JSON

Nachricht: "Invalid docs.json configuration"

Ursache: Deine Datei docs.json enthält Syntaxfehler oder ungültige Werte.

Lösung:

1. Führe lokal jamdesk validate aus, um detaillierte Fehler anzuzeigen
2. Prüfe auf fehlende Kommas, Klammern oder Anführungszeichen
3. Stelle sicher, dass alle Werte dem erwarteten Schema entsprechen

MISSING_PAGE

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

Ursache: Eine in der Navigation von docs.json aufgeführte Seite existiert nicht.

Lösung:

1. Prüfe, ob die Datei am angegebenen Pfad vorhanden ist
2. Stelle sicher, dass der Pfad in docs.json mit dem tatsächlichen Dateinamen übereinstimmt (ohne .mdx)
3. Bei Pfaden wird zwischen Groß- und Kleinschreibung unterschieden. Prüfe daher die Schreibweise

INVALID_FRONTMATTER

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

Ursache: Das YAML-Frontmatter am Anfang einer MDX-Datei ist fehlerhaft.

Lösung:

1. Stelle sicher, dass das Frontmatter mit --- beginnt und endet
2. Prüfe auf ungültige YAML-Syntax (fehlende Doppelpunkte, falsche Einrückung)
3. Setze Zeichenketten mit Sonderzeichen in Anführungszeichen

MDX-Fehler

MDX_SYNTAX_ERROR

Nachricht: "MDX compilation failed"

Ursache: Ungültige MDX- oder JSX-Syntax in deinem Inhalt.

Lösung:

1. Stelle sicher, dass alle JSX-Tags korrekt geschlossen werden (<Card>...</Card>)
2. Prüfe, ob Props die korrekte Syntax verwenden (title="value" statt title=value)
3. Maskiere geschweifte Klammern in normalem Text: \{ statt {

COMPONENT_NOT_FOUND

Nachricht: "Unknown component 'ComponentName'"

Ursache: Du verwendest eine Komponente, die in Jamdesk nicht existiert.

Lösung:

1. Prüfe die Komponentenreferenz auf die korrekten Namen
2. Bei Komponentennamen wird zwischen Groß- und Kleinschreibung unterschieden: Verwende <Card> statt <card>
3. Stelle sicher, dass du keine benutzerdefinierten Komponenten importierst (nicht unterstützt)

INVALID_PROPS

Nachricht: "Invalid props for component 'ComponentName'"

Ursache: Eine Komponente hat Props erhalten, die sie nicht akzeptiert.

Lösung:

1. Prüfe die Komponentendokumentation auf gültige Props
2. Entferne nicht unterstützte Props
3. Prüfe den erwarteten Typ der Prop in der Komponentendokumentation (beispielsweise erwartet cols eine Zahl und keine Zeichenkette)

OpenAPI-Fehler

OPENAPI_PARSE_ERROR

Nachricht: "Failed to parse OpenAPI specification"

Ursache: Deine OpenAPI-Spezifikationsdatei enthält eine ungültige Syntax oder Struktur.

Lösung:

1. Führe lokal jamdesk openapi-check aus, um die Datei zu validieren
2. Verwende einen OpenAPI-Validator wie Swagger Editor
3. Prüfe auf eine gültige JSON- oder YAML-Syntax

OPENAPI_REFERENCE_ERROR

Nachricht: "Unresolved reference in OpenAPI spec"

Ursache: Ein $ref in deiner OpenAPI-Spezifikation verweist auf eine nicht vorhandene Definition.

Lösung:

1. Prüfe, ob alle $ref-Pfade korrekt sind
2. Stelle sicher, dass die referenzierten Schemas unter components/schemas existieren
3. Wenn ein $ref auf eine externe Datei oder URL verweist, bestätige, dass die Datei in deinem Projekt enthalten und die URL erreichbar ist

Build-Timeout

BUILD_TIMEOUT

Nachricht: "Build exceeded maximum time limit"

Ursache: Der Build dauerte länger als die zulässige Zeit (normalerweise 5 Minuten).

Lösung:

1. Optimiere große Bilder (komprimiere sie oder ändere ihre Größe)
2. Teile sehr große Seiten in kleinere Seiten auf
3. Reduziere die Seitenanzahl, wenn sie extrem groß ist
4. Wende dich an den Support, wenn das Problem weiterhin besteht

Asset-Fehler

ASSET_NOT_FOUND

Nachricht: "Asset 'path/to/asset' not found"

Ursache: Ein in deiner Dokumentation referenziertes Bild oder eine Datei existiert nicht.

Lösung:

1. Prüfe, ob die Datei am angegebenen Pfad vorhanden ist
2. Stelle sicher, dass der Pfad relativ zu deinem Dokumentationsverzeichnis ist
3. Bei Pfaden wird zwischen Groß- und Kleinschreibung unterschieden. Prüfe daher den Dateinamen exakt

ASSET_TOO_LARGE

Nachricht: "Asset exceeds maximum file size"

Ursache: Ein Bild oder eine Datei ist größer als das Limit von 10 MB.

Lösung:

1. Komprimiere Bilder mit Tools wie TinyPNG oder ImageOptim
2. Verwende geeignete Formate (WebP für Fotos, SVG für Symbole)
3. Erwäge, sehr große Dateien extern zu hosten

Hilfe erhalten

Wenn du einen Fehler nicht beheben kannst:

1. Prüfe das vollständige Build-Protokoll in deinem Dashboard auf weitere Informationen
2. Durchsuche die FAQ nach häufigen Problemen
3. Kontaktiere den Support mit deiner Projekt-ID und den Fehlerdetails

Verwandte Artikel