Lección 5 de 5
Vídeo próximamente
Casi todos los errores de deploy caen en un puñado de categorías predecibles. Antes de entrar en pánico, revisa esto en orden — en ese orden, no al azar, porque la primera categoría cubre la gran mayoría de los casos reales.
Variables de entorno faltantes. La causa más común, por lejos. Tu código funciona en local porque tiene un archivo .env con las claves correctas — en producción (Vercel, Coolify, etc.) esas variables hay que configurarlas manualmente en el panel del servicio. Si el build falla mencionando algo "undefined" o "not set", empieza aquí: compara la lista de variables que tu código espera contra las que realmente están configuradas en el panel de producción.
Diferencias entre tu entorno local y el de producción. Node.js en una versión distinta, un paquete que se instaló diferente, una dependencia que funciona en tu sistema operativo pero no en el del servidor. Revisa los logs de build completos — casi siempre dicen exactamente qué falló, aunque el mensaje parezca críptico a primera vista. No te quedes solo con la última línea del log; el error real suele estar unas líneas arriba.
Base de datos no migrada. Si tu esquema de base de datos cambió pero nunca corriste la migración contra la base de datos real (no la de tu computadora), el deploy puede "funcionar" — la aplicación arranca sin errores — pero la app falla al intentar leer o escribir datos que dependen de una columna o tabla que en producción todavía no existe. Este tipo de error es engañoso porque no aparece en el momento del build, sino después, cuando alguien intenta usar esa parte específica de la app.
Cuando algo falle: copia el mensaje de error completo (no un resumen tuyo) y pégaselo a Claude junto con qué esperabas que pasara y en qué paso ocurrió. El 90% de las veces la causa real está en ese mensaje, aunque no sea obvio a simple vista — resistir la tentación de resumir el error con tus propias palabras y pegar el texto exacto suele ahorrar varias idas y vueltas innecesarias.