RunnerSoft

BLOG · Desarrollo web

Error 500 en PHP: cómo comenzar un diagnóstico ordenado

Registra el alcance del error 500, revisa logs y cambios recientes, y prueba una corrección a la vez sin exponer datos del servidor.

Actualizado: 2026-10-03

El estado HTTP 500 indica que el servidor encontró un problema inesperado al procesar una solicitud. No identifica una causa única. Una configuración incorrecta, una excepción o un problema de recursos pueden producir un resultado similar para el visitante.

Anota qué falla

Registra la URL, la hora y la acción realizada. Distingue si falla todo el sitio, una página o una operación específica. Por ejemplo, que la portada abra no descarta que el acceso al administrador falle por una consulta a la base de datos.

También identifica cuándo comenzó. Si el problema apareció después de cambiar la versión de PHP o una regla del servidor, esa información ayuda a delimitar la investigación; no demuestra por sí sola que ese cambio sea la causa.

Consulta los registros del servidor

Busca el evento correspondiente a la hora de la prueba en los logs disponibles. Conserva el mensaje técnico para el responsable y oculta contraseñas, datos personales y rutas sensibles antes de compartirlo.

La respuesta pública no debería mostrar trazas completas ni credenciales. No habilites avisos detallados en producción para todos los visitantes solo para conseguir una captura.

Cambia una cosa a la vez

  1. Obtén una copia antes de modificar archivos.
  2. Reproduce el fallo en un entorno de pruebas cuando sea posible.
  3. Aplica una corrección relacionada con el mensaje del registro.
  4. Repite la misma acción y registra el resultado.
  5. Revisa otras funciones antes de dar el incidente por resuelto.

Evita borrar configuraciones o ampliar permisos indiscriminadamente. Si no tienes acceso a los logs, solicita al hosting la revisión indicando hora y URL. Consulta también cómo preparar una copia recuperable.

Referencia

MDN: significado de 500 Internal Server Error.