Risoluzione problemi di build
Risolvi i guasti comuni di build abbinando i messaggi di errore a cause e soluzioni. Copre errori di configurazione, dipendenze mancanti, sintassi MDX e problemi di icone.
Il log di build mostra cosa si è rotto e dove. Trova il tuo messaggio di errore qui sotto.
Visualizzare i dettagli dell'errore
- Apri la scheda Deployments del tuo progetto
- Clicca sulla build non riuscita
- Leggi il messaggio di errore e scorri il log di build
Il log indica il file e la riga esatta che hanno interrotto la build.
Errori comuni
Errori di configurazione
Invalid docs.json significa che il file di configurazione non può essere analizzato. La causa più comune è una virgola fuori posto, una parentesi non chiusa o un apice mancante.
Cerca virgole, parentesi o apici mancanti.
Esegui jamdesk validate per vedere gli errori esatti.
Correggili e fai push per avviare una nuova build.
Pagine mancanti
Page not found significa che la tua navigazione punta a un file che non esiste. Controlla il nome del file rispetto al percorso in docs.json. Le maiuscole devono corrispondere esattamente. Ometti l'estensione .mdx.
Errori di sintassi MDX
MDX compilation failed indica MDX o JSX malformato in una pagina. Di solito si tratta di un tag non chiuso (un <Card> senza il corrispondente </Card>), di un carattere non escapato come una { letterale dove intendevi \{, oppure di una sintassi di prop non valida.
Timeout della build
Build exceeded time limit significa che la build ha superato il tempo massimo consentito. La causa più comune sono immagini grandi e non ottimizzate. Comprimile, dividi le pagine molto grandi e rimuovi quelle che non pubblichi più.
Avvisi della build
Gli avvisi non fanno mai fallire una build. Il tuo sito viene comunque pubblicato. Gli avvisi compaiono nell'email degli avvisi di build, nella voce della build nella scheda Deployments e nel terminale quando esegui jamdesk validate o jamdesk dev.
Immagini mancanti
Image not found avvisa che una pagina fa riferimento a un'immagine che il tuo progetto non contiene.
Jamdesk verifica ogni riferimento a un'immagine (Markdown  più il src nei tag <img loading="lazy"> e <Image>) rispetto ai file del tuo repository. L'avviso indica la pagina, il numero di riga e il percorso che non è stato possibile risolvere.
Carica l'immagine oppure indica un percorso verso un file esistente. I percorsi sono sensibili alle maiuscole. Un percorso che inizia con / si risolve dalla radice del progetto. Ogni altro percorso si risolve in relazione alla pagina. Un riferimento a photo.png continua a funzionare dopo che l'ottimizzazione delle immagini la converte in WebP.
Jamdesk ignora gli URL esterni, gli URI data: e la sintassi delle immagini all'interno dei blocchi di codice.
Passaggi di debug
Il log indica il file e la riga esatta alla base dell'errore. Inizia da lì.
Esegui jamdesk dev per riprodurre il problema in locale.
Esegui jamdesk validate per controllare docs.json. Esegui jamdesk broken-links per trovare i link interni non funzionanti.
Osserva il tuo ultimo commit. Hai aggiunto una pagina o modificato la configurazione?
Il problema persiste?
Se nessuna delle soluzioni sopra funziona:
- Copia l'intero log di build
- Annota il tuo ID progetto (si trova nell'URL)
- Contatta il supporto