socorrist.app

500 Internal Server Error

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.

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

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.

Lo que este error no significa

Arréglalo tú, gratis

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.

  1. 1Entra en el panel de tu hosting y busca los registros de ejecución. En Vercel están en el proyecto, pestaña Logs, o dentro del propio despliegue en la sección de funciones. Filtra por errores.
  2. 2Recarga la página que da el 500 con los registros abiertos, para que la entrada aparezca en el momento y no tengas que buscarla entre las viejas.
  3. 3Lee el mensaje completo. Ahí sí sale el error de verdad con el fichero y la línea.
  4. 4Si menciona una variable de entorno, ve a la configuración del proyecto, dala de alta en todos los entornos y vuelve a desplegar. Es la causa más común con diferencia.
  5. 5Si menciona una conexión rechazada o un tiempo agotado, entra en el panel del servicio al que llama tu app y comprueba que está despierto. Los proyectos gratuitos de Supabase se pausan solos tras un tiempo sin uso y se reactivan con un botón.
  6. 6Si menciona que algo es undefined o null, es un dato que no llegó y que el código daba por hecho. Eso se arregla en el código, con el prompt de abajo.

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.

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

¿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