Errores de build
Relaciona tu error de build con una solución: errores de configuración, errores de sintaxis MDX, archivos faltantes, problemas de OpenAPI y timeouts.
Abre el build fallido en tu pestaña Deployments y relaciona el mensaje de error con una sección a continuación.
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 log
El log muestra exactamente qué salió mal y dónde.
Fallas comunes
Configuración inválida
Error: "Invalid docs.json"
Tu docs.json tiene errores de sintaxis o de esquema.
Solución:
- Revisa si faltan comas, corchetes o comillas
- 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 (distingue mayúsculas y minúsculas)
- No incluyas la extensión
.mdxendocs.json
Errores de sintaxis MDX
Error: "MDX compilation failed"
Sintaxis MDX o JSX inválida.
Causas comunes:
- Etiquetas sin cerrar:
<Card>sin</Card> - Llaves sin escapar:
{en lugar de\{ - Props inválidas:
title=valueen lugar detitle="value"
Imágenes faltantes
Error: "Asset not found"
Una imagen referenciada en MDX no existe.
Solución:
- Verifica que la ruta de la imagen sea correcta
- Las rutas son relativas a tu directorio de docs
- Verifica que el archivo se haya subido a Git
Pasos de depuración
El log te indica exactamente qué falló y dónde.
Ejecuta jamdesk dev para reproducir el error.
Ejecuta jamdesk validate para revisar tu configuración.
Revisa tu último commit en busca del problema.
¿Sigues atascado?
Si no puedes resolver el problema:
- Copia el log completo del build
- Anota el ID de tu proyecto
- Contacta con soporte