Errori di build

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

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

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

Articoli correlati