---
title: Errori di build
description: "Abbina l'errore di build alla soluzione: errori di configurazione, sintassi MDX, file mancanti, problemi OpenAPI e timeout."
---

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

Apri la build non riuscita nella scheda **Deployments** e associa il messaggio di errore alla sezione corrispondente.

## Individuare l'errore

1. Vai alla scheda **Deployments** del tuo progetto
2. Fai clic sulla build non riuscita
3. Esamina il messaggio di errore e il log

Il log mostra esattamente cosa non ha funzionato e dove.

## Errori comuni

### Configurazione non valida

**Errore:** "Invalid docs.json"

Il tuo `docs.json` contiene errori di sintassi o dello schema.

**Soluzione:**
1. Controlla la presenza di virgole, parentesi o virgolette mancanti
2. Esegui `jamdesk validate` localmente
3. Confronta il file con il [riferimento dello schema](/it/config/docs-json-reference)

### Pagine mancanti

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

Una pagina nella navigazione non esiste.

**Soluzione:**
- Verifica che il file esista
- Controlla che il percorso corrisponda esattamente, rispettando maiuscole e minuscole
- Non includere l'estensione `.mdx` in `docs.json`

### Errori di sintassi MDX

**Errore:** "MDX compilation failed"

La sintassi MDX o JSX non è valida.

**Cause comuni:**
- Tag non chiusi: `<Card>` senza `</Card>`
- Parentesi graffe non sottoposte a escape: `{` invece di `\{`
- Props non valide: `title=value` invece di `title="value"`

### Immagini mancanti

**Errore:** "Asset not found"

Un'immagine referenziata in MDX non esiste.

**Soluzione:**
- Controlla che il percorso dell'immagine sia corretto
- I percorsi sono relativi alla directory della documentazione
- Verifica che il file sia stato sottoposto a commit in Git

## Passaggi per il debug

<Steps>
  <Step title="Leggi l'errore">
    Il log indica esattamente cosa non ha funzionato e dove.
  </Step>
  <Step title="Esegui il test localmente">
    Esegui `jamdesk dev` per riprodurre l'errore.
  </Step>
  <Step title="Convalida la configurazione">
    Esegui `jamdesk validate` per controllare la configurazione.
  </Step>
  <Step title="Controlla le modifiche recenti">
    Esamina il tuo ultimo commit per individuare il problema.
  </Step>
</Steps>

## Il problema persiste?

Se non riesci a risolvere il problema:

1. Copia il log completo della build
2. Prendi nota dell'ID del progetto
3. [Contatta l'assistenza](/it/help/support/contact)

## Articoli correlati

<Columns cols={2}>
  <Card title="Riferimento errori" icon="book" href="/it/help/troubleshooting/error-reference">
    Spiegazione di tutti i codici di errore
  </Card>
  <Card title="Panoramica CLI" icon="terminal" href="/it/cli/overview">
    Testa le build localmente
  </Card>
</Columns>