socorrist.app

Deploy failed

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.

Ya de paso: ¿tu app está exponiendo datos?

Analízala gratis mientras lees. Tarda treinta segundos y no toca nada.

Solo leemos lo que tu app ya le entrega a cualquier visitante.

Por qué te pasa

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.

Lo que este error no significa

Arréglalo tú, gratis

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.

  1. 1Entra en el panel de tu hosting y abre el despliegue fallido. En Vercel es la pestaña Deployments y luego el que aparece en rojo; en Netlify, Deploys. Abre el registro completo.
  2. 2Busca la primera línea con la palabra Error. Ignora los avisos amarillos, que casi nunca son la causa. Copia esa línea entera y las cinco siguientes: eso es lo que hace falta para diagnosticar.
  3. 3Si dice que no encuentra un módulo, comprueba dos cosas: que el paquete esté en la lista de dependencias del proyecto y no solo instalado en tu ordenador, y que el nombre del fichero coincida exactamente en mayúsculas y minúsculas con el que aparece en el código. Tu ordenador no distingue mayúsculas; el servidor sí, y ese detalle rompe despliegues constantemente.
  4. 4Si habla de tipos o de TypeScript, es código que hay que tocar y va en el prompt de abajo.
  5. 5Si menciona una variable de entorno, ve a la configuración del proyecto en el panel, dala de alta marcando todos los entornos y vuelve a desplegar.
  6. 6Si habla de memoria o de tiempo agotado, no es un error de tu código sino de tamaño. Ahí hace falta mirar qué ha crecido tanto, y suele ser un buen momento para pedir ayuda en vez de ir probando.

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.

Y esto para la parte de código

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 pegarle a 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.

¿Lo has intentado y sigue sin salir?

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.

Cita a partir de mañana

Agendar revisión

99 €

Elegimos hueco, miro tu app con calma y te digo qué pasa y cómo se arregla.

  • Sesión de trabajo en directo contigo
  • Diagnóstico del error y del riesgo real
  • Te quedas con el arreglo aplicado
Ver huecos disponibles

Hoy, en cola prioritaria

Rescate exprés

199 €

Entras en la cola de hoy. Reservas hueco y lo dejamos resuelto en el día.

  • Hueco el mismo día
  • Prioridad sobre las revisiones agendadas
  • Mismo trabajo, antes
Ver huecos de hoy

Quién lo arregla

Marc Sala

IT Manager

  • Analista de ciberseguridad certificado por Google

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.

Errores que suelen venir con este