---
title: Solución de problemas de builds
description: "Soluciona fallos de build comunes: mensajes de error, causas y soluciones. Cubre errores de config, dependencias, sintaxis MDX y problemas con iconos."
---

Cuando un build falla, revisa el mensaje de error en el log del build y encuentra la sección correspondiente a continuación.

## Ver detalles del 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 log del build

El log muestra exactamente dónde y por qué falló el build.

## Errores comunes

### Errores de configuración

**"Invalid docs.json"** — Tu archivo de configuración tiene errores de sintaxis.

<Steps>
  <Step title="Verifica la sintaxis JSON">
    Busca comas, corchetes o comillas faltantes.
  </Step>
  <Step title="Valida localmente">
    Ejecuta `jamdesk validate` para ver los errores detallados.
  </Step>
  <Step title="Corrige y sube">
    Corrige los errores y haz push para activar un nuevo build.
  </Step>
</Steps>

### Páginas faltantes

**"Page not found"** — Una página de tu navegación no existe.

- Verifica que el nombre del archivo coincida con la ruta en `docs.json`
- Las rutas distinguen entre mayúsculas y minúsculas
- No incluyas la extensión `.mdx`

### Errores de sintaxis MDX

**"MDX compilation failed"** — Sintaxis MDX o JSX no válida.

Causas comunes:
- Etiquetas sin cerrar (`<Card>` sin `</Card>`)
- Caracteres especiales sin escapar (`{` en lugar de `\{`)
- Sintaxis de props no válida

### Timeout del build

**"Build exceeded time limit"** — El build tardó demasiado.

Prueba:
- Optimizar imágenes grandes
- Dividir páginas muy extensas
- Reducir el número total de páginas

## Pasos de depuración

<Accordion title="Paso 1: Revisa el log del build">
  El log muestra la línea y el archivo exactos que causan el error. Empieza por ahí.
</Accordion>

<Accordion title="Paso 2: Prueba localmente">
  Ejecuta `jamdesk dev` localmente para reproducir y depurar el problema.
</Accordion>

<Accordion title="Paso 3: Valida la configuración">
  Ejecuta `jamdesk validate` para verificar tu `docs.json` y `jamdesk broken-links` para detectar enlaces internos rotos.
</Accordion>

<Accordion title="Paso 4: Revisa los cambios recientes">
  Revisa tu último commit. ¿Añadiste una nueva página? ¿Cambiaste la configuración?
</Accordion>

## ¿Sigues sin resolverlo?

Si no puedes resolver el problema:

1. Copia el log completo del build
2. Anota el ID de tu proyecto (en la URL)
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="Monitorear builds" icon="chart-line" href="/es/builds/monitoring">
    Seguimiento del progreso del build
  </Card>
</Columns>