---
title: Build-Fehlerreferenz
description: "Alle Build-Fehlercodes mit Ursache und Lösung für Konfiguration, MDX-Syntax, OpenAPI, Timeouts und Assets."
---

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

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](/de/components/overview) 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](/de/help/faq) nach häufigen Problemen
3. [Kontaktiere den Support](/de/help/support/contact) mit deiner Projekt-ID und den Fehlerdetails

## Verwandte Artikel

<Columns cols={2}>
  <Card title="Build-Fehler" icon="triangle-exclamation" href="/de/help/troubleshooting/build-failures">
    Häufige Build-Fehler und Lösungen
  </Card>
  <Card title="Support kontaktieren" icon="headset" href="/de/help/support/contact">
    Hilfe von unserem Team erhalten
  </Card>
</Columns>