Falhas de build
Associe o erro do build a uma solução: erros de configuração, erros de sintaxe MDX, arquivos ausentes, problemas de OpenAPI e timeouts.
Abra o build com falha na aba Deployments e associe a mensagem de erro a uma das seções abaixo.
Encontrar o erro
- Acesse a aba Deployments do seu projeto
- Clique no build com falha
- Revise a mensagem de erro e o log
O log mostra o que falhou e onde.
Falhas comuns
Configuração inválida
Erro: "Invalid docs.json"
Seu docs.json tem erros de sintaxe ou de schema.
Solução:
- Verifique se há vírgulas, colchetes ou aspas ausentes
- Execute
jamdesk validatelocalmente - Compare com a referência do schema
Páginas ausentes
Erro: "Page 'path/to/page' not found"
Uma página na navegação não existe.
Solução:
- Verifique se o arquivo existe
- Confirme que o caminho corresponde exatamente (diferencia maiúsculas de minúsculas)
- Não inclua a extensão
.mdxnodocs.json
Erros de sintaxe MDX
Erro: "MDX compilation failed"
Sintaxe MDX ou JSX inválida.
Causas comuns:
- Tags não fechadas:
<Card>sem</Card> - Chaves não escapadas:
{em vez de\{ - Props inválidas:
title=valueem vez detitle="value"
Imagens ausentes
Erro: "Asset not found"
Uma imagem referenciada no MDX não existe.
Solução:
- Verifique se o caminho da imagem está correto
- Os caminhos são relativos ao seu diretório de documentação
- Confirme que o arquivo foi enviado ao Git
Etapas de depuração
Encontre o que falhou e onde no log.
Execute jamdesk dev para reproduzir o erro.
Execute jamdesk validate para verificar sua configuração.
Revise seu último commit em busca do problema.
Ainda precisa de ajuda?
Se não conseguir resolver o problema:
- Copie o log completo do build
- Anote o ID do seu projeto
- Entre em contato com o suporte
