Errores de build
Relaciona el error de tu build con una solución: errores de configuración, errores de sintaxis MDX, archivos faltantes, problemas de OpenAPI y tiempos de espera.
Abre el build fallido en la pestaña Deployments y relaciona el mensaje de error con una sección a continuación.
Cómo encontrar el error
- Ve a la pestaña Deployments de tu proyecto
- Haz clic en el build fallido
- Revisa el mensaje de error y el registro
El registro muestra exactamente qué salió mal y dónde.
Errores comunes
Configuración no válida
Error: "Invalid docs.json"
Tu docs.json tiene errores de sintaxis o de esquema.
Solución:
- Busca comas, corchetes o comillas faltantes
- Ejecuta
jamdesk validatelocalmente - Compara con la referencia del esquema
Páginas faltantes
Error: "Page 'path/to/page' not found"
Una página en la navegación no existe.
Solución:
- Verifica que el archivo exista
- Comprueba que la ruta coincida exactamente (sensible a mayúsculas/minúsculas)
- No incluyas la extensión
.mdxendocs.json
Errores de sintaxis MDX
Error: "MDX compilation failed"
Sintaxis MDX o JSX no válida.
Causas comunes:
- Etiquetas sin cerrar:
<Card>sin</Card> - Llaves sin escapar:
{en lugar de\{ - Props no válidos:
title=valueen lugar detitle="value"
Imágenes faltantes
Error: "Asset not found"
Una imagen referenciada en MDX no existe.
Solución:
- Comprueba que la ruta de la imagen sea correcta
- Las rutas son relativas al directorio de tu documentación
- Verifica que el archivo fue confirmado en Git
Pasos de depuración
El registro te indica exactamente qué falló y dónde.
Ejecuta jamdesk dev para reproducir el error.
Ejecuta jamdesk validate para revisar tu configuración.
Examina tu último commit para encontrar el problema.
¿Sigues sin resolverlo?
Si no puedes resolver el problema:
- Copia el registro completo del build
- Anota el ID de tu proyecto
- Contacta con soporte