Error 500 en PrestaShop con cPanel: Causas y soluciones rápidas

¿Qué es el error 500 en PrestaShop y por qué aparece en cPanel?

El error 500 es un mensaje genérico que indica "Error interno del servidor". En PrestaShop, suele aparecer cuando algo sale mal en la configuración del servidor o en los archivos de la tienda. Si estás usando cPanel, es probable que el problema esté relacionado con los permisos de archivos, la memoria PHP o un módulo defectuoso. No te preocupes, es un error común y tiene solución paso a paso.

[INFO] El error 500 en PrestaShop no siempre muestra detalles específicos por seguridad. Por eso, vamos a revisar las causas más frecuentes y cómo solucionarlas desde cPanel.

Causas comunes del error 500 en PrestaShop con cPanel

Antes de empezar, identifica si el error aparece:

Al cargar toda la tienda.
Solo en el panel de administración.
Al instalar o actualizar un módulo.
Después de cambiar la configuración del hosting.

Las causas más típicas incluyen:

Permisos de archivos incorrectos (muy común en cPanel).
Límite de memoria PHP insuficiente.
Archivo .htaccess dañado.
Módulo o tema incompatible.
Versión de PHP incorrecta.
Archivos de caché corruptos.

Cómo solucionar el error 500 en PrestaShop paso a paso desde cPanel

Sigue estos pasos en orden. Cada uno resuelve una causa posible.

1. Activar el modo debug de PrestaShop para ver el error exacto

Por defecto, PrestaShop oculta los detalles del error 500. Activar el modo debug te mostrará el mensaje real (por ejemplo, "Allowed memory size exhausted").

Pasos:

Accede a cPanel y abre el Administrador de archivos.
Ve a la carpeta raíz de tu PrestaShop (normalmente public_html).
Busca el archivo config/defines.inc.php.
Edítalo y cambia la línea:
define('_PS_MODE_DEV_', false);
por:
define('_PS_MODE_DEV_', true);
Guarda los cambios.
Vuelve a cargar tu tienda. Ahora verás el error específico.

[WARNING] No olvides volver a poner false después de solucionar el problema. Dejarlo activo en producción puede exponer información sensible.

Si el error dice "Allowed memory size of X bytes exhausted", salta al paso 3. Si menciona un archivo específico (como un módulo), ve al paso 5.

2. Restaurar los permisos de archivos a los valores correctos

Los permisos incorrectos son una causa frecuente del error 500 en PrestaShop con cPanel.

Pasos:

En cPanel, abre el Administrador de archivos.
Selecciona toda la carpeta de tu tienda (por ejemplo, public_html).
Haz clic en Permisos (arriba).
Aplica los siguientes valores:
- Carpetas: 755 (rwxr-xr-x).
- Archivos: 644 (rw-r--r--).
Marca Recursivo para que se aplique a todas las subcarpetas.
Haz clic en Cambiar permisos.

[TIP] Si tienes muchos archivos, este proceso puede tardar unos segundos. No cierres la ventana hasta que termine.

3. Aumentar el límite de memoria PHP

PrestaShop requiere al menos 128 MB de memoria, pero recomendamos 256 MB o más.

Pasos desde cPanel:

Ve a Seleccionar versión de PHP (dentro de la sección "Software").
Haz clic en Opciones (o Switch to PHP Options).
Busca memory_limit y cámbialo a 256M o 512M.
Haz clic en Guardar.
También revisa max_execution_time y ponlo en 180.
Guarda y cierra.

Si no ves esta opción, puedes hacerlo manualmente:

Abre el Administrador de archivos.
Busca el archivo php.ini en la raíz de tu tienda (si no existe, créalo).

Agrega estas líneas:

memory_limit = 256M
max_execution_time = 180
upload_max_filesize = 64M
post_max_size = 64M

Guarda el archivo.

4. Regenerar el archivo .htaccess

Un .htaccess dañado puede causar el error 500. Es fácil regenerarlo desde el panel de administración de PrestaShop.

Pasos:

Si puedes acceder al back office, ve a Parámetros de la tienda > Tráfico y SEO.
En la sección URL amigables, desmarca y vuelve a marcar la opción.
Haz clic en Guardar.
Si no puedes acceder al back office, desde cPanel:
- Abre el Administrador de archivos.
- Renombra el archivo .htaccess a .htaccess_old (por si acaso).
- Ve a tu tienda; PrestaShop generará uno nuevo automáticamente.

[WARNING] Si renombras el .htaccess, tu tienda puede verse sin CSS temporalmente. Esto se soluciona al regenerarlo.

5. Deshabilitar módulos problemáticos (sin acceso al back office)

Si el error 500 apareció después de instalar un módulo, puedes desactivarlo desde la base de datos.

Pasos:

En cPanel, abre phpMyAdmin.
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_module (el prefijo puede variar, por ejemplo ps_).
Haz clic en Examinar (Browse).
Identifica el módulo problemático (por nombre) y anota su id_module.
Ve a la tabla ps_module_shop y elimina la fila con ese ID.
También en ps_hook_module, elimina las filas con ese ID.

[INFO] Si no sabes qué módulo es, puedes desactivar todos los módulos no esenciales. Una forma más segura es renombrar la carpeta modules desde cPanel (por ejemplo, a modules_old) y luego crear una carpeta modules vacía. Esto desactivará todos los módulos y la tienda debería cargar.

6. Verificar la versión de PHP

PrestaShop 1.7 requiere PHP 7.1 o superior, pero no más de PHP 8.0 en versiones antiguas. Usa una versión compatible.

Pasos:

En cPanel, ve a Seleccionar versión de PHP.
Elige una versión recomendada (por ejemplo, PHP 7.4 o 8.0 para PrestaShop 1.7).
Haz clic en Guardar.

[TIP] Si usas un PrestaShop muy antiguo (1.6), prueba con PHP 5.6 o 7.0.

7. Limpiar la caché de PrestaShop manualmente

A veces la caché corrupta causa el error 500.

Pasos:

Desde cPanel, abre el Administrador de archivos.
Ve a la carpeta var/cache dentro de tu PrestaShop.
Elimina todo el contenido de las subcarpetas (no borres las carpetas vacías).
También puedes borrar la carpeta cache/smarty/compile y cache/smarty/cache.

8. Revisar los logs del servidor en cPanel

Si nada funciona, revisa los logs para obtener pistas.

Pasos:

En cPanel, ve a Registros de errores (dentro de "Métricas").
Busca errores recientes con la fecha del problema.
Anota cualquier mensaje que mencione "PHP Fatal error" o "require_once".

[INFO] Los logs suelen mostrar la línea exacta del error, lo que te ayudará a identificar el archivo problemático.

Preguntas frecuentes (FAQ) sobre error 500 en PrestaShop con cPanel

¿Puedo solucionar el error 500 sin acceso al back office?

Sí, todos los pasos anteriores se hacen desde cPanel, sin necesidad de entrar al panel de administración de PrestaShop.

¿Qué hago si después de todo el error persiste?

Prueba a restaurar una copia de seguridad reciente de tu tienda (archivos y base de datos). Si no tienes, contacta al soporte de tu hosting. También puedes revisar si tu plan de hosting tiene recursos suficientes (CPU, RAM).

¿El error 500 puede ser por un plugin de caché?

Sí, los plugins de caché como PrestaShop Cache o módulos de terceros pueden generar conflictos. Desactívalos siguiendo el paso 5.

¿Cómo evito futuros errores 500?

Mantén PrestaShop y todos los módulos actualizados.
Usa versiones de PHP compatibles.
No instales módulos de fuentes no confiables.
Realiza copias de seguridad periódicas.

Conclusión

El error 500 en PrestaShop al usar cPanel es frustrante, pero siguiendo estos pasos podrás resolverlo sin necesidad de ser un experto. Recuerda empezar siempre por activar el modo debug para ver el error exacto, luego revisa permisos, memoria PHP y el .htaccess. Si el problema persiste, desactiva módulos y limpia la caché. Con un poco de paciencia, tu tienda volverá a funcionar.

[TIP] Si después de todo sigues con problemas, considera migrar a un hosting especializado en PrestaShop o usar un panel como Syspanel (accesible por puerto 2106) que facilita la gestión de tu servidor.

¡Esperamos que esta guía te haya sido útil! No olvides compartirla con otros usuarios de PrestaShop que puedan tener el mismo problema.