Solucionar error 500 en PrestaShop: guía práctica
¿Tu tienda PrestaShop muestra una pantalla en blanco o el temido mensaje "Error 500: Internal Server Error"? No te preocupes. Este es uno de los problemas más comunes en servidores de hosting, y en la mayoría de los casos tiene solución sin necesidad de ser un experto en programación.
En esta guía práctica, paso a paso, te enseñaré cómo solucionar el error 500 en PrestaShop, qué significa, por qué ocurre y cómo prevenirlo. Vamos a convertir ese error en un recuerdo lejano.
¿Qué significa el error 500 en PrestaShop?
El error 500 PrestaShop es un error genérico del servidor. Significa que algo falló internamente, pero el servidor no puede dar más detalles por razones de seguridad. Las causas pueden ser muy variadas: desde un plugin incompatible, un archivo .htaccess corrupto, hasta problemas de memoria o permisos incorrectos en los archivos.
¿Qué verás en pantalla?
- Pantalla completamente blanca (White Screen of Death).
- Mensaje "Error 500: Internal Server Error".
- A veces, solo un mensaje escueto como "This page isn’t working".
Primeros pasos: antes de tocar nada
Antes de lanzarte a modificar archivos, sigue estos pasos previos. Te ahorrarán tiempo y posibles errores adicionales.
1. Limpia la caché de PrestaShop
A veces el error es temporal y se soluciona borrando la caché.
- Accede a tu panel de administración de PrestaShop (si puedes).
- Ve a Parámetros avanzados > Rendimiento.
- Haz clic en "Limpiar la caché" (tanto de Smarty como de la caché del sistema).
[TIP] Si no puedes acceder al panel, borra manualmente la carpeta
/var/cache/desde el FTP. Elimina todo su contenido, pero no la carpeta en sí.
2. Revisa si el error es general o puntual
Prueba a acceder a diferentes páginas de tu tienda (home, categorías, producto, etc.). Si solo falla una página concreta, el problema suele estar en un módulo o en el contenido de esa página. Si falla todo, el error es global (servidor, .htaccess, configuración).
3. Comprueba el estado de tu hosting
El error 500 PrestaShop también puede deberse a una sobrecarga del servidor. Contacta con tu proveedor de hosting o revisa el panel de control (cPanel, Syspanel, etc.) para ver si hay alertas de recursos.
[WARNING] Si tu hosting tiene límites muy ajustados de memoria PHP o ejecución, PrestaShop puede dar error 500 en momentos de alta demanda. Considera escalar tu plan si esto ocurre a menudo.
Cómo acceder a los logs de errores (la clave de todo)
Para solucionar error 500 hosting, necesitas saber qué está fallando exactamente. Los logs de errores son tu mejor aliado. Aquí te explico cómo encontrarlos según tu panel.
Si usas cPanel
- Entra a cPanel.
- Busca la sección "Métricas" o "Registros".
- Haz clic en "Error Log" o "Registro de errores".
- Busca las líneas más recientes que contengan "PHP Fatal error" o "500".
Si usas Syspanel (antes conocido como HestiaCP)
- Accede a tu Syspanel a través del puerto 2106 (ejemplo:
https://tudominio.com:2106). - Ve a la sección "Web" y selecciona tu dominio.
- Busca el enlace "Logs" o "Registros".
- Allí encontrarás el log de errores del servidor web (Apache o Nginx).
Si no tienes acceso al panel
Puedes activar la visualización de errores temporalmente editando el archivo config/defines.inc.php en la raíz de PrestaShop.
- Conéctate por FTP.
- Abre el archivo
config/defines.inc.php. - Busca la línea:
define('_PS_MODE_DEV_', false); - Cámbiala a:
define('_PS_MODE_DEV_', true); - Guarda el archivo y recarga la página. Ahora verás el error detallado en pantalla.
[INFO] Recuerda volver a poner
falsecuando termines de diagnosticar. Dejar el modo desarrollo activado en producción es un riesgo de seguridad.
Causas comunes y soluciones paso a paso
Aquí tienes las causas más frecuentes del PrestaShop error servidor y cómo arreglarlas.
1. Archivo .htaccess corrupto o mal generado
El .htaccess de PrestaShop se regenera automáticamente, pero a veces se corrompe.
Solución:
- Conéctate por FTP.
- Renombra el archivo
.htaccessa.htaccess_old(esto lo desactiva). - Ve a tu panel de administración de PrestaShop > Parámetros avanzados > SEO y URLs.
- Sin cambiar nada, haz clic en "Guardar". Esto regenerará un nuevo
.htaccess. - Vuelve a probar tu tienda.
[TIP] Si no puedes acceder al panel, crea un archivo
.htaccessnuevo con el contenido básico de PrestaShop (puedes copiarlo de una instalación limpia o pedirlo a soporte).
2. Módulo o tema incompatible
Un módulo recién instalado o actualizado suele ser el culpable.
Solución:
- Accede a tu panel de administración.
- Ve a Módulos > Gestor de módulos.
- Desactiva los módulos que hayas instalado o actualizado recientemente.
- Si no puedes acceder al panel, renombra la carpeta del módulo sospechoso desde FTP (por ejemplo, de
/modules/nombremoduloa/modules/nombremodulo_desactivado). - Prueba la tienda después de cada desactivación.
3. Límite de memoria PHP excedido
PrestaShop necesita al menos 128 MB de memoria PHP, aunque 256 MB es lo recomendado.
Solución:
- Crea o edita un archivo llamado
php.inien la raíz de tu PrestaShop. - Añade esta línea:
memory_limit = 256M - Guarda y sube el archivo.
- Si no funciona, contacta con tu hosting para que aumenten el límite desde el panel.
[WARNING] No todos los hostings permiten sobrescribir el
php.inidesde FTP. En ese caso, pide a soporte que lo hagan ellos.
4. Permisos incorrectos en archivos o carpetas
Los permisos incorrectos pueden impedir que PrestaShop lea o escriba archivos necesarios.
Solución:
- Conéctate por FTP.
- Los permisos correctos son:
- Carpetas: 755
- Archivos: 644
- Carpeta
config: 755 - Carpeta
cache: 755 - Archivo
settings.inc.php: 644
- Puedes usar la herramienta de "Permisos" de tu FTP para corregir todo el árbol de directorios.
5. Problemas con la versión de PHP
PrestaShop 1.6 funciona bien con PHP 5.6 o 7.0, mientras que PrestaShop 1.7 y 8 necesitan PHP 7.1 o superior (idealmente 7.4 u 8.0).
Solución:
- Accede a tu panel de hosting (cPanel, Syspanel, etc.).
- Busca la opción "Seleccionar versión de PHP" o "PHP Selector".
- Cambia a la versión recomendada para tu PrestaShop.
- Guarda los cambios y limpia la caché.
[INFO] En Syspanel, esta opción suele estar en la sección "Web" > "PHP Settings" de tu dominio.
6. Archivos corruptos o faltantes
Una actualización fallida o una subida incompleta por FTP puede dejar archivos dañados.
Solución:
- Descarga una copia limpia de PrestaShop de la versión exacta que tienes (mismo número de versión).
- Sustituye los archivos sospechosos (especialmente los de las carpetas
classes,controllersyoverride). - Si no sabes cuáles están dañados, puedes hacer una reinstalación de los archivos del core (sin borrar la base de datos). Sigue las instrucciones oficiales de PrestaShop para "reinstalar solo los archivos".
Preguntas frecuentes (FAQ)
¿El error 500 puede deberse a un ataque?
Sí, aunque no es lo más común. Si sospechas de un ataque, revisa los logs en busca de peticiones extrañas y cambia todas las contraseñas.
¿Pierdo datos si borro la carpeta cache?
No, la caché se regenera automáticamente. No pierdes productos, clientes ni pedidos.
¿Qué hago si no encuentro el log de errores?
Pide a tu hosting que te facilite el log de errores del servidor. Es su responsabilidad proporcionártelo.
¿Puedo evitar el error 500 en el futuro?
Sí, con estas buenas prácticas:
- Mantén PrestaShop, módulos y tema actualizados.
- Haz copias de seguridad periódicas.
- No instales módulos de fuentes no fiables.
- Aumenta los límites de memoria PHP si tu tienda crece.
- Usa un hosting optimizado para PrestaShop.
Resumen: checklist rápido para solucionar el error 500
- ✅ Limpia la caché de PrestaShop (manual o por FTP).
- ✅ Revisa los logs de errores (cPanel, Syspanel puerto 2106, o modo desarrollo).
- ✅ Desactiva módulos recientes.
- ✅ Regenera el archivo
.htaccess. - ✅ Aumenta el límite de memoria PHP.
- ✅ Corrige permisos de archivos y carpetas.
- ✅ Cambia la versión de PHP si es necesario.
- ✅ Contacta con tu hosting si nada funciona.
Solucionar error 500 hosting no tiene por qué ser una pesadilla. Con paciencia y siguiendo esta guía, la mayoría de las veces encontrarás la causa en pocos minutos. Recuerda que los logs son tu brújula: sin ellos, estarás dando palos de ciego.
Si después de todo sigues con el error 500 PrestaShop, no dudes en pedir ayuda a tu proveedor de hosting o a un desarrollador especializado. A veces, el problema está en la configuración del servidor y escapa a nuestro control.
¡Buena suerte con tu tienda y que no vuelvas a ver ese molesto error!
