deploy
El servidor ha recibido la petición, ha intentado responder y se ha caído por el camino. El 500 es el navegador diciéndote que el fallo está del lado del servidor, no en tu conexión ni en tu navegador. Lo que no te dice es cuál, y eso es deliberado: contar los detalles de un error de servidor al visitante sería un problema de seguridad.
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
Que el despliegue funcionara y esto falle es lo normal, no una contradicción: construir la app y ejecutarla son dos momentos distintos. Todo lo que dependa de datos, de credenciales o de servicios externos no se prueba al construir, sino la primera vez que alguien entra.
Las causas frecuentes, por orden. Una variable de entorno que falta y que el código de servidor necesita para arrancar. Una llamada a base de datos o a un servicio externo que falla y nadie ha previsto qué hacer si falla. Un dato que llega vacío donde el código esperaba algo. O un servicio de terceros caído o dormido, muy típico en los planes gratuitos que se suspenden por inactividad.
Lo importante es que el mensaje real existe, solo que no está en tu pantalla: está en los registros de la función en el panel de tu hosting. Ahí sí aparece el error completo con la línea exacta. Sin abrir eso, cualquier arreglo es adivinar.
Solución
Todo el trabajo está en llegar al mensaje real. Es donde mucha gente se atasca, porque el error que ve en pantalla está diseñado para no decir nada.
Si el 500 aparece solo en algunas páginas y otras van bien, ya tienes acotado el problema: mira qué hacen esas páginas que las demás no, y casi siempre es una llamada externa.
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 app devuelve un 500 Internal Server Error tras desplegarla. En los registros del servidor, el error dice: [PEGA AQUÍ EL ERROR COMPLETO DE LOS LOGS]. Necesito que hagas esto: 1. Identifica qué código provoca ese error y explícame en dos frases por qué falla al ejecutarse y no al construir. 2. Añade manejo de errores en ese punto: que un fallo de una llamada externa devuelva una respuesta controlada con un mensaje comprensible, en lugar de tumbar la petición entera. 3. Revisa todas las variables de entorno que necesita el código de servidor y añade una comprobación al arrancar que diga por su nombre cuál falta. 4. Asegúrate de que los mensajes de error que llegan al navegador no incluyen detalles internos como rutas de ficheros, consultas o credenciales. Esos detalles deben quedarse en los registros del servidor. 5. Dime si hay más sitios en el proyecto con el mismo patrón sin proteger.
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