deploy
Tu app no ha llegado a publicarse. El servidor intentó construirla, algo se torció por el camino y abortó. La buena noticia inmediata: la versión anterior sigue publicada y funcionando, porque estas plataformas no tiran lo que hay hasta que lo nuevo está listo.
Revisado en agosto de 2026
De paso
Analízala gratis mientras lees. Tarda treinta segundos y no toca nada.
Solo leemos lo que tu app ya le entrega a cualquier visitante.
Diagnóstico
Deploy failed no es una causa, es un titular. La causa está dentro del registro del despliegue, y ahí es donde hay que ir. El truco para leerlo: no mires el final, que suele ser un resumen inútil de que el proceso terminó con error. Busca la primera línea que diga Error, en rojo, y trabaja desde ahí. Todo lo que viene después suele ser consecuencia.
Los cuatro tipos que cubren casi todos los casos. Errores de módulo no encontrado: falta una dependencia o un fichero está referenciado con un nombre que no coincide en mayúsculas, algo que en tu ordenador funciona y en el servidor no. Errores de TypeScript: el editor los toleraba y la compilación de producción no. Variables de entorno que faltan cuando el código las necesita ya al construir. Y quedarse sin memoria o sin tiempo, que aparece en proyectos que han crecido mucho.
Hay un quinto caso que despista mucho porque no es culpa tuya: que el despliegue anterior funcionara con las mismas versiones y este no. Suele significar que una dependencia se actualizó sola porque no estaba fijada a una versión concreta.
Solución
El noventa por ciento del trabajo es leer el registro correctamente. Hazlo antes de tocar nada, porque el arreglo depende por completo de qué diga.
Guarda ese fragmento del registro aunque acabes pidiendo ayuda. Es literalmente lo primero que va a pedir cualquiera que mire esto, y tenerlo a mano ahorra media hora.
Pégaselo tal cual al agente que escribió tu app. Está redactado para que te diga lo que ha hecho, no solo para que lo haga.
Prompt para tu agente
Mi despliegue falla con "Deploy failed". Este es el fragmento del registro donde aparece el primer error: [PEGA AQUÍ LA PRIMERA LÍNEA DE ERROR Y LAS SIGUIENTES]. Necesito que hagas esto: 1. Dime en una frase qué significa ese error concreto y en qué fichero está el origen. 2. Explícame por qué falla al construir en el servidor y no al ejecutarlo en local. Si es un tema de mayúsculas en nombres de fichero o de una dependencia que no está declarada, dímelo explícitamente. 3. Aplica el arreglo mínimo para ese error concreto. No aproveches para reorganizar nada más: quiero un despliegue verde antes de tocar otra cosa. 4. Revisa si el mismo problema se repite en otros sitios del proyecto y dime dónde, sin arreglarlo todavía. 5. Comprueba que todas las dependencias que usa el código están declaradas en el proyecto con una versión fijada, no abierta. Si el error es de tipos de TypeScript, arréglalo escribiendo los tipos correctos. No lo silencies con any ni desactivando la comprobación.
Si no sale
O el escáner de arriba ha encontrado algo y prefieres no tocarlo solo. En cualquiera de los dos casos esto ya es de los gordos y merece un humano: no es que no hayas sabido, es que has llegado al punto en que hace falta alguien que entre y lo vea por dentro.
Las 10 primeras apps son gratis. Estoy empezando y necesito casos reales. A cambio te pido permiso para contar después qué me encontré, sin decir de quién era la app ni enseñar tus datos. Sin tarjeta y sin suscripción: cuando se acaben las plazas empezaré a cobrar y lo diré aquí.
Cita a partir de mañana
Gratis
durante el lanzamiento
Elegimos hueco, miro tu app con calma y te digo qué pasa y cómo se arregla.
Hoy, en cola prioritaria
Gratis
durante el lanzamiento
Entras en la cola de hoy. Reservas hueco y lo dejamos resuelto en el día.
Quién
Marc Sala
IT Manager
No es un rating anónimo de un marketplace: es la persona que va a entrar en tu app. Reviso el código, encuentro qué falla y lo arreglo contigo delante, explicándote qué ha pasado sin jerga.
Relacionados