Errori di build

Apri la build non riuscita nella scheda Deployments e cerca il messaggio di errore in una delle sezioni seguenti.

Individuare l'errore

1. Vai alla scheda Deployments del tuo progetto
2. Clicca sulla build non riuscita
3. Controlla il messaggio di errore e il log

Il log mostra cosa non ha funzionato e dove.

Errori comuni

Configurazione non valida

Errore: "Invalid docs.json"

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

Soluzione:

1. Controlla la presenza di virgole, parentesi o virgolette mancanti
2. Esegui jamdesk validate in locale
3. Confronta con il riferimento dello schema

Pagine mancanti

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

Una pagina presente nella navigazione non esiste.

Soluzione:

• Verifica che il file esista
• Controlla che il percorso corrisponda esattamente (distingue maiuscole e minuscole)
• Non includere l'estensione .mdx in docs.json

Errori di sintassi MDX

Errore: "MDX compilation failed"

Sintassi MDX o JSX non valida.

Cause comuni:

• Tag non chiusi: <Card> senza </Card>
• Parentesi graffe non escapate: { al posto di \{
• Prop non valide: title=value al posto di title="value"

Immagini mancanti

Errore: "Asset not found"

Un'immagine referenziata nell'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 incluso nel commit su Git

Passaggi per il debug

Il problema persiste?

Se non riesci a risolvere il problema:

1. Copia il log completo della build
2. Annota l'ID del tuo progetto
3. Contatta il supporto

Articoli correlati