Error 500 en PrestaShop después de una migración
Diagnóstico paso a paso de un error 500 en PrestaShop tras cambiar de servidor: logs, caché, PHP, permisos y configuración.
- Revisado
- Compatibilidad
- PrestaShop 1.7.x–9.x; revisar versión
- Lectura
- 2 min
- Autor
- Gabriel — infinit8
Un error 500 es una respuesta genérica del servidor. Después de una migración, las causas más frecuentes son una versión de PHP incompatible, extensiones ausentes, caché con rutas antiguas, permisos o reglas del servidor que ya no son válidas.
Leer el error antes de cambiar cosas
Reproduce una sola petición y revisa el log de PHP y el log del servidor en la misma marca de tiempo. No borres archivos ni cambies permisos globalmente antes de guardar el mensaje y la traza: son la vía más corta hacia la causa.
Activar depuración temporalmente
En PrestaShop 1.7 y posteriores puede activarse el modo de desarrollo en un entorno controlado. Desactívalo al terminar porque una traza puede revelar rutas, consultas o credenciales.
define('_PS_MODE_DEV_', true);No dejes el modo debug visible en producción. Si el back office funciona, actívalo desde sus parámetros avanzados y limita el acceso durante la prueba.
Comprobaciones en orden
- Versión de PHP admitida por tu versión exacta de PrestaShop.
- Extensiones PHP necesarias y límites de memoria.
- Credenciales y host de base de datos.
- Rutas antiguas conservadas en caché.
- Propietario y permisos de archivos.
- Reglas de
.htaccessincompatibles con el servidor nuevo. - Módulos que fallan con la versión de PHP.
Caché y recuperación
Borra únicamente los directorios de caché documentados para tu versión y conserva sus archivos de seguridad. Si el error aparece solo en una página, revisa primero el controlador o módulo implicado en la traza.
Preguntas frecuentes
¿Dar permisos 777 soluciona el error?
No es una solución segura. Corrige propietario, grupo y permisos mínimos según la configuración del servidor.
¿Debo borrar .htaccess?
Guarda una copia y prueba a regenerarlo desde PrestaShop cuando el back office sea accesible. No lo elimines sin comprobar si contiene reglas necesarias ajenas a PrestaShop.
Referencias y revisión
Contenido contrastado con documentación oficial. Comprueba siempre el comportamiento en un entorno de pruebas antes de desplegar cambios.