Jamdesk Documentation logo

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

  1. Acesse a aba Deployments do seu projeto
  2. Clique no build com falha
  3. 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:

  1. Verifique se há vírgulas, colchetes ou aspas ausentes
  2. Execute jamdesk validate localmente
  3. 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 .mdx no docs.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=value em vez de title="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

1
Leia o erro

Encontre o que falhou e onde no log.

2
Teste localmente

Execute jamdesk dev para reproduzir o erro.

3
Valide a configuração

Execute jamdesk validate para verificar sua configuração.

4
Verifique as alterações recentes

Revise seu último commit em busca do problema.

Ainda precisa de ajuda?

Se não conseguir resolver o problema:

  1. Copie o log completo do build
  2. Anote o ID do seu projeto
  3. Entre em contato com o suporte

Artigos relacionados

Referência de erros

Todos os códigos de erro explicados

Visão geral da CLI

Teste builds localmente