---
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](https://jamdesk.com/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](https://jamdesk.com/docs/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

### 1. Fehler lesen

Das Protokoll zeigt genau, was fehlgeschlagen ist und wo.

### 2. Lokal testen

Führe `jamdesk dev` aus, um den Fehler zu reproduzieren.

### 3. Konfiguration validieren

Führe `jamdesk validate` aus, um deine Konfiguration zu prüfen.

### 4. Letzte Änderungen prüfen

Überprüfe deinen letzten Commit auf die Ursache.

## 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](https://jamdesk.com/docs/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>