---
title: Errores de build
description: "Relaciona el error de tu build con una solución: errores de configuración, 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

1. Ve a la pestaña **Deployments** de tu proyecto
2. Haz clic en el build fallido
3. 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:**
1. Busca comas, corchetes o comillas faltantes
2. Ejecuta `jamdesk validate` localmente
3. Compara con la [referencia del esquema](/es/config/docs-json-reference)

### 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 `.mdx` en `docs.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=value` en lugar de `title="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

<Steps>
  <Step title="Lee el error">
    El registro te indica exactamente qué falló y dónde.
  </Step>
  <Step title="Prueba localmente">
    Ejecuta `jamdesk dev` para reproducir el error.
  </Step>
  <Step title="Valida la configuración">
    Ejecuta `jamdesk validate` para revisar tu configuración.
  </Step>
  <Step title="Revisa los cambios recientes">
    Examina tu último commit para encontrar el problema.
  </Step>
</Steps>

## ¿Sigues sin resolverlo?

Si no puedes resolver el problema:

1. Copia el registro completo del build
2. Anota el ID de tu proyecto
3. [Contacta con soporte](/es/help/support/contact)

## Artículos relacionados

<Columns cols={2}>
  <Card title="Referencia de errores" icon="book" href="/es/help/troubleshooting/error-reference">
    Todos los códigos de error explicados
  </Card>
  <Card title="Descripción general de la CLI" icon="terminal" href="/es/cli/overview">
    Prueba los builds localmente
  </Card>
</Columns>