---
title: Build-Fehler
description: "Ordne deinen Build-Fehler einer Lösung zu: Konfigurationsfehler, MDX-Syntaxfehler, fehlende Dateien, OpenAPI-Probleme und Zeitüberschreitungen."
---

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

Öffne den fehlgeschlagenen Build im Tab **Deployments** und ordne die Fehlermeldung einem Abschnitt weiter unten zu.

## Fehler finden

1. Öffne den Tab **Deployments** deines Projekts
2. Klicke auf den fehlgeschlagenen Build
3. Prüfe die Fehlermeldung und das Protokoll

Das Protokoll zeigt genau, was schiefgelaufen ist und wo.

## Häufige Fehler

### Ungültige Konfiguration

**Fehler:** "Invalid docs.json"

Deine `docs.json` enthält Syntax- oder Schemafehler.

**Lösung:**
1. Prüfe, ob Kommas, Klammern oder Anführungszeichen fehlen
2. Führe lokal `jamdesk validate` aus
3. Vergleiche die Datei mit der [Schema-Referenz](/de/config/docs-json-reference)

### Fehlende Seiten

**Fehler:** "Page 'path/to/page' not found"

Eine Seite in der Navigation ist nicht vorhanden.

**Lösung:**
- Prüfe, ob die Datei vorhanden ist
- Stelle sicher, dass der Pfad exakt übereinstimmt (Groß- und Kleinschreibung beachten)
- Füge die Erweiterung `.mdx` nicht in `docs.json` ein

### MDX-Syntaxfehler

**Fehler:** "MDX compilation failed"

Ungültige MDX- oder JSX-Syntax.

**Häufige Ursachen:**
- Nicht geschlossene Tags: `<Card>` ohne `</Card>`
- Nicht maskierte geschweifte Klammern: `{` statt `\{`
- Ungültige Props: `title=value` statt `title="value"`

### Fehlende Bilder

**Fehler:** "Asset not found"

Ein in MDX referenziertes Bild ist nicht vorhanden.

**Lösung:**
- Prüfe, ob der Bildpfad korrekt ist
- Pfade beziehen sich relativ auf dein Dokumentationsverzeichnis
- Stelle sicher, dass die Datei in Git committed wurde

## Schritte zur Fehlerbehebung

<Steps>
  <Step title="Fehler lesen">
    Das Protokoll zeigt genau, was fehlgeschlagen ist und wo.
  </Step>
  <Step title="Lokal testen">
    Führe `jamdesk dev` aus, um den Fehler zu reproduzieren.
  </Step>
  <Step title="Konfiguration validieren">
    Führe `jamdesk validate` aus, um deine Konfiguration zu prüfen.
  </Step>
  <Step title="Letzte Änderungen prüfen">
    Überprüfe deinen letzten Commit auf die Ursache.
  </Step>
</Steps>

## Noch keine Lösung?

Wenn du das Problem nicht beheben kannst:

1. Kopiere das vollständige Build-Protokoll
2. Notiere die Projekt-ID
3. [Support kontaktieren](/de/help/support/contact)

## Verwandte Artikel

<Columns cols={2}>
  <Card title="Fehlerreferenz" icon="book" href="/de/help/troubleshooting/error-reference">
    Alle Fehlercodes erklärt
  </Card>
  <Card title="CLI-Übersicht" icon="terminal" href="/de/cli/overview">
    Builds lokal testen
  </Card>
</Columns>