Solucionar error 500 en PrestaShop | Guía cPanel

¡Hola! Si estás leyendo esto, es muy probable que te hayas encontrado con la temida pantalla blanca o el mensaje de error 500 en tu tienda PrestaShop. No te preocupes, es uno de los problemas más comunes en el mundo del hosting y, en la mayoría de los casos, tiene solución en pocos minutos.

En esta guía extensa y paso a paso, vamos a desglosar cómo solucionar el error 500 en PrestaShop usando cPanel. Vamos a ir desde lo más simple (como limpiar la caché) hasta lo más técnico (como editar archivos de configuración), siempre explicándolo de forma clara y sencilla, como si estuviéramos tomando un café.

Vamos a ello. Respira hondo, porque solucionar error 500 es más fácil de lo que parece.

¿Qué es exactamente el Error 500 en PrestaShop?

Antes de lanzarnos a arreglar nada, es importante entender qué significa este error. El error 500 (Internal Server Error) es un mensaje genérico que envía el servidor cuando ocurre un problema interno que él mismo no puede gestionar.

En el contexto de PrestaShop, esto suele traducirse en:

Un archivo .htaccess corrupto.
Falta de memoria PHP (límite de memoria agotado).
Permisos de archivos incorrectos.
Un módulo o tema que está dando conflictos.
Errores en la versión de PHP.

Piensa en ello como un semáforo en rojo: el servidor te dice "algo va mal aquí dentro, pero no te voy a dar más detalles por seguridad". Por eso, nosotros tenemos que investigar un poco para encontrar la causa raíz.

Primeros Pasos: Diagnóstico Rápido (y Seguro)

Siempre te recomiendo empezar por lo menos invasivo. No vamos a borrar nada todavía. Vamos a "tocar" suavemente para ver si el problema se resuelve solo.

1. Reinicia tu Aplicación o Servicio (si es posible)

A veces, un error 500 es simplemente un "tropiezo" temporal del servidor.

Desde cPanel: Busca la sección "Métricas" o "Estado del Servidor". Si tienes acceso a "Restart" o "Reiniciar" para tu cuenta o dominio, hazlo. En la mayoría de los hosts compartidos no tienes esta opción, pero en VPS o dedicados sí.
Desde tu panel de control (como Syspanel): Si usas un panel alternativo, recuerda que el acceso suele ser en el puerto 2106. Busca la opción de reiniciar servicios web (Apache/Nginx) o PHP-FPM.

2. Limpia la Caché de PrestaShop (La solución milagrosa)

PrestaShop es muy sensible a la caché. Una caché corrupta es la causa número uno de prestashop error 500 tras actualizar módulos o temas.

Como no podemos entrar al panel de administración (porque también dará error), tendremos que hacerlo manualmente.

Accede a tu cPanel y abre el Administrador de Archivos.
Ve a la carpeta raíz de tu tienda (normalmente public_html o public_html/prestashop).
Busca la carpeta llamada var/cache (en versiones modernas de PrestaShop 1.7 y 1.8) o cache (en versiones antiguas 1.6).
Entra en la carpeta cache y dentro de ella encontrarás subcarpetas como dev o prod.
Selecciona todos los archivos dentro de prod (o dev) y bórralos. No te preocupes, se regenerarán automáticamente.

[TIP] No borres la carpeta en sí, solo el contenido que hay dentro. Así evitamos problemas de permisos.

3. Verifica los Permisos de Archivos y Carpetas

Este es un clásico. Si los permisos son demasiado restrictivos, el servidor no puede leer los archivos. Si son demasiado abiertos, puede dar error de seguridad.

En el Administrador de Archivos de cPanel, selecciona la carpeta raíz de tu PrestaShop.
Haz clic en Seleccionar todo (en la barra superior).
Haz clic en el botón Permisos (arriba a la derecha).
Para carpetas (directorios), el valor correcto suele ser 755.
Para archivos, el valor correcto suele ser 644.
Aplica los cambios.

[WARNING] No cambies los permisos de la carpeta config o var a 777 (todos los permisos). Es un riesgo de seguridad grave. Con 755/644 es suficiente para que funcione.

Soluciones Avanzadas: Manos a la Obra con la Configuración

Si los pasos anteriores no han funcionado, vamos a profundizar un poco más. Aquí es donde realmente empezamos a arreglar error 500.

4. Aumentar el Límite de Memoria PHP (El Famoso memory_limit)

Muchas veces, el error 500 prestashop aparece cuando el script necesita más memoria de la que el servidor le permite usar por defecto (normalmente 128M o 256M).

Para aumentarlo, editaremos el archivo settings.inc.php o crearemos un archivo .htaccess más permisivo.

Opción A: Editar settings.inc.php (para PrestaShop 1.6)

Ve a config/settings.inc.php.
Edita el archivo y busca la línea que dice define('_PS_MEMORY_LIMIT_', '128M');
Cambia 128M a 256M o incluso 512M si tu hosting lo permite.

Opción B: Editar el archivo .htaccess (para PrestaShop 1.7/1.8)

Ve a la raíz de tu instalación y busca el archivo .htaccess.
Si no lo ves, activa "Mostrar archivos ocultos" en la configuración del Administrador de Archivos.
Al final del archivo, pega estas líneas:

<IfModule mod_php7.c>
php_value memory_limit 512M
php_value max_execution_time 180
php_value max_input_time 180
</IfModule>

[INFO] Si usas PHP 8.0 o superior, el módulo cambia a mod_php. Prueba con <IfModule mod_php.c> si el anterior no funciona.

Opción C: Crear un archivo php.ini (La más universal)

En la raíz de tu PrestaShop, crea un archivo llamado php.ini.
Pega dentro:

memory_limit = 512M
max_execution_time = 180
max_input_time = 180

Guarda los cambios y recarga la tienda.

5. El Archivo .htaccess: El Gran Culpable

Un .htaccess mal formateado es la pesadilla de muchos. A veces, al desactivar un módulo de SEO o URL amigables, este archivo se corrompe.

Solución: Regenerarlo (o eliminarlo temporalmente)

Paso 1: Ve al Administrador de Archivos y renombra el archivo .htaccess a .htaccess_old. Esto lo "apagará".
Paso 2: Intenta acceder a tu tienda. Si ya no da error 500, el problema era ese archivo.
Paso 3: Ahora, entra a tu panel de administración de PrestaShop (si puedes) y ve a Parámetros Avanzados > Rendimiento. Activa las "URLs Amigables" y guarda. Esto regenerará el .htaccess desde cero.
Paso 4: Si no puedes entrar al panel, tendrás que crear uno básico. Pero es raro que necesites hacerlo a mano.

[WARNING] No dejes tu tienda sin archivo .htaccess para siempre. Es esencial para la seguridad y el SEO. Asegúrate de regenerarlo o restaurar una copia de seguridad.

6. Desactivar Módulos Problemáticos (Forzar modo seguro)

Si el error apareció después de instalar o actualizar un módulo, es muy probable que ese módulo esté causando un conflicto. Pero como no podemos acceder al panel, hay que desactivarlo manualmente.

Opción 1 (La más fácil): Ve a la carpeta modules en el Administrador de Archivos.
Busca la carpeta del módulo sospechoso (el que instalaste ayer, por ejemplo).
Renombra la carpeta (ej: de mimodulo a mimodulo_desactivado). Esto hace que PrestaShop no pueda cargarlo y lo ignore.
Opción 2 (Cambiar la configuración en la base de datos): Esto es más técnico. Necesitas ir a phpMyAdmin desde cPanel.
- Busca la tabla ps_modules (el prefijo puede variar).
- Busca el módulo en cuestión y cambia el valor de active de 1 a 0.

Soluciones Extremas: Cuando Nada de lo Anterior Funciona

Si hemos llegado hasta aquí y el error persiste, necesitamos usar herramientas más potentes.

7. Revisar el Registro de Errores de PHP (El Detective)

El servidor guarda un registro de los errores exactos que ocurren. Este es nuestro mapa del tesoro.

En cPanel, busca la sección "Registros de Errores" o "Error Logs" (normalmente dentro de "Métricas").
Abre el registro de errores del dominio.
Busca la última línea con fecha de hoy. Te dirá algo como: PHP Fatal error: Allowed memory size of 268435456 bytes exhausted... o Uncaught Error: Call to undefined function....

Con esa pista, sabrás exactamente si es un problema de memoria (solución 4) o de un módulo/función específica.

8. Cambiar la Versión de PHP (El Comodín)

A veces, tu hosting actualiza PHP a una versión incompatible con tu versión de PrestaShop.

Ve a cPanel y busca la sección "Select PHP Version" (o "MultiPHP Manager").
Prueba a cambiar a una versión anterior (por ejemplo, de PHP 8.2 a PHP 7.4) o a una más nueva si estás en una muy antigua.
Guarda los cambios y recarga.

[INFO] PrestaShop 1.6 no es compatible con PHP 8.0 o superior. Si tienes una tienda antigua, necesitas usar PHP 7.1 o 7.4 como máximo.

9. Restaurar una Copia de Seguridad

Si has probado de todo y el error persiste, quizás es hora de retroceder en el tiempo.

En cPanel, busca "Backup" o "Copias de Seguridad".
Si tienes una copia de seguridad reciente de tu archivo y de tu base de datos (idealmente de antes de que empezara el error), puedes restaurarla.
Primero restaura el directorio (los archivos) y luego la base de datos.

[WARNING] Este paso borrará cualquier cambio que hayas hecho desde la fecha de la copia. Es el último recurso, pero es muy efectivo.

Preguntas Frecuentes (FAQ) sobre el Error 500 en PrestaShop

Aquí te dejo respuestas rápidas a dudas comunes que nos llegan al soporte.

¿Por qué veo el error 500 solo en el panel de administración y no en la tienda?
Esto suele indicar un problema con un módulo de administración o con la caché del back-office. Prueba a borrar la carpeta var/cache y a desactivar el último módulo que instalaste en el backend.

¿Es un error de mi proveedor de hosting?
Puede ser, pero es menos común de lo que crees. Si el error ocurre justo después de una actualización de PHP o de un cambio en el servidor, puede ser cosa del hosting. Contacta con ellos para que revisen los logs del servidor, pero primero intenta las soluciones de esta guía.

¿Pierdo mis ventas o datos si borro la caché?
No. La caché es solo un archivo temporal. Al borrarla, la tienda la regenerará automáticamente. No perderás productos, clientes ni pedidos.

¿Qué es el archivo config/settings.inc.php?
Es el archivo de configuración principal de PrestaShop 1.6. Ahí se guardan las claves de la base de datos y la configuración global. En PrestaShop 1.7/1.8, esta configuración se encuentra en app/config/parameters.php.

¿Puedo usar Syspanel para hacer estos cambios?
Sí. Si tu hosting usa Syspanel (accesible en el puerto 2106), la estructura es muy similar a cPanel. Busca las secciones de "Archivos", "Bases de Datos" y "Métricas" para realizar los mismos pasos. La lógica es idéntica.

Conclusión: Mantén la Calma y Sigue los Pasos

En resumen, solucionar error 500 en PrestaShop es un proceso de eliminación. No te saltes pasos y actúa con calma.

Recuerda el orden lógico:

Limpia la caché (la solución más rápida).
Verifica los permisos (la solución más común).
Aumenta la memoria PHP (la solución para tiendas grandes).
Revisa el .htaccess (la solución para problemas de SEO).
Desactiva módulos (la solución para conflictos recientes).
Consulta los logs (la solución para casos complejos).

Con estas herramientas, tendrás la capacidad de diagnosticar y arreglar error 500 tú mismo en la mayoría de las ocasiones. Y si te quedas atascado, ya sabes que puedes contactar con tu proveedor de hosting con la información de los logs para que te echen un cable.

Espero que esta guía te haya sido de gran ayuda. ¡Mucha suerte con tu tienda!