🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Solucionar errores comunes en PrestaShop (cPanel)

Actualizado el 7 de noviembre de 2025

Si tienes una tienda online con PrestaShop alojada en un servidor con cPanel y empiezas a notar que algo no funciona bien —la página se vuelve lenta, aparecen errores en blanco, o no puedes acceder al back office—, no te preocupes. Estos problemas son muy comunes en entornos compartidos o VPS gestionados con cPanel, y lo bueno es que la mayoría tienen una solución sencilla. En esta guía extensa, te voy a explicar paso a paso cómo solucionar los errores más frecuentes de PrestaShop en cPanel, con un enfoque práctico de SysAdmin para Linux. Usaremos términos claros, comandos básicos y herramientas que ya tienes en tu panel de control.

¿Por qué ocurren errores en PrestaShop con cPanel?

PrestaShop es un sistema de gestión de contenidos (CMS) potente, pero también es exigente con los recursos del servidor. Cuando tu tienda crece o instalas muchos módulos, pueden surgir conflictos. cPanel, por su parte, es un panel de control que facilita la gestión del hosting, pero a veces la configuración predeterminada no está optimizada para PrestaShop. Los errores más habituales se deben a:

  • Límites de memoria PHP insuficientes.
  • Permisos de archivos incorrectos.
  • Conflictos con módulos o temas.
  • Problemas de caché o de base de datos.
  • Actualizaciones incompletas o fallidas.

Vamos a ver cómo identificar y resolver cada uno de estos escenarios.

## 1. Error de memoria PHP: "Allowed memory size exhausted"

Este es, con diferencia, el error más común en PrestaShop. Aparece cuando el script de PHP intenta usar más memoria de la que tiene asignada. Lo verás como un mensaje en blanco o un error como:

Fatal error: Allowed memory size of 134217728 bytes exhausted

### Solución: Aumentar el límite de memoria PHP desde cPanel

  1. Accede a cPanel y busca la sección "Seleccionar versión de PHP" o "MultiPHP Manager".
  2. Dentro, verás una lista de opciones de configuración. Busca memory_limit.
  3. Cambia el valor a 256M o 512M (recomendado para tiendas grandes). Si no ves la opción, puedes hacerlo manualmente:
    • Ve a "Administrador de archivos" de cPanel.
    • Navega hasta la raíz de tu PrestaShop (normalmente public_html).
    • Busca el archivo php.ini (si no existe, créalo).
    • Añade esta línea: memory_limit = 256M
  4. Guarda los cambios y recarga la tienda.

[TIP] Si tu hosting usa CloudLinux, también puedes ajustar estos límites desde el "Selector de PHP" de cPanel. A veces el valor máximo lo impone el plan de hosting, así que si no puedes subirlo, contacta con tu proveedor.

## 2. Pantalla blanca o error 500 sin mensaje

Una página en blanco (también llamada "White Screen of Death") suele deberse a un error de PHP que no se muestra por culpa de la configuración de errores. Para ver el error real, debemos activar la visualización de errores.

### Solución temporal para ver el error

  1. Conéctate a tu cPanel y abre el "Administrador de archivos".
  2. Localiza el archivo config/defines.inc.php en la raíz de PrestaShop.
  3. Busca la línea: define('_PS_MODE_DEV_', false);
  4. Cámbiala a: define('_PS_MODE_DEV_', true);
  5. Guarda y recarga la página. Ahora verás el error real en lugar de la pantalla blanca.

[WARNING] No olvides volver a poner false cuando termines de depurar, o tu tienda quedará expuesta.

### Solución definitiva: Aumentar límites y revisar logs

  • Aumenta también max_execution_time a 120 o 180 en el mismo php.ini.
  • Revisa los logs de errores en cPanel: ve a "Registros de errores" (dentro de "Métricas") para ver el error exacto.
  • Si el error es de un módulo, desactívalo desde el back office o renombrando la carpeta del módulo en /modules/.

## 3. Error de conexión a la base de datos

Cuando PrestaShop no puede conectar con MySQL, verás un mensaje como:

Link to database cannot be established.

Esto puede deberse a que la base de datos está caída, los datos de conexión son incorrectos o hay un problema de permisos.

### Pasos para solucionarlo

  1. Verifica que MySQL esté funcionando desde cPanel: ve a "MySQL Databases" y comprueba que tu base de datos aparece en la lista.
  2. Revisa el archivo app/config/parameters.php (en PrestaShop 1.7+) o config/settings.inc.php (en versiones antiguas). Asegúrate de que los datos de database_host, database_name, database_user y database_password coinciden con los de cPanel.
  3. Prueba la conexión manualmente desde la herramienta phpMyAdmin en cPanel. Si no puedes acceder, puede que el usuario de la base de datos no tenga permisos. En ese caso, desde "MySQL Databases" asigna todos los privilegios al usuario sobre la base de datos.
  4. Reinicia MySQL desde la terminal de tu VPS (si tienes acceso root) o pide a tu hosting que lo hagan.

[INFO] Si usas un servidor con Syspanel (HestiaCP), recuerda que el acceso se hace por el puerto 2106. Allí también puedes gestionar bases de datos de forma similar.

## 4. Errores de permisos de archivos y carpetas

PrestaShop necesita permisos específicos para que el sistema pueda escribir en ciertas carpetas (cache, log, uploads, etc.). Si ves errores al instalar módulos o al subir imágenes, el problema suele ser de permisos.

### Cómo corregir permisos desde cPanel

  1. En el "Administrador de archivos", selecciona toda la carpeta de PrestaShop (normalmente public_html).
  2. Haz clic en "Cambiar permisos".
  3. Establece los siguientes valores:
    • Carpetas: 755 (rwxr-xr-x)
    • Archivos: 644 (rw-r--r--)

Para aplicar esto de forma masiva, es mejor usar comandos SSH (si tienes acceso). Conéctate por terminal y ejecuta:

find /home/tuusuario/public_html -type d -exec chmod 755 {} \;
find /home/tuusuario/public_html -type f -exec chmod 644 {} \;

Luego, da permisos especiales a las carpetas que necesitan escritura:

chmod -R 775 /home/tuusuario/public_html/cache
chmod -R 775 /home/tuusuario/public_html/log
chmod -R 775 /home/tuusuario/public_html/img
chmod -R 775 /home/tuusuario/public_html/modules
chmod -R 775 /home/tuusuario/public_html/themes

[TIP] Si no tienes SSH, puedes pedir a tu hosting que ejecuten estos comandos. Es una tarea típica de SysAdmin.

## 5. Error al actualizar PrestaShop o módulos

Las actualizaciones fallidas son una fuente habitual de errores PrestaShop cPanel. Pueden dejar la tienda en un estado inconsistente.

### Solución: Activar el modo mantenimiento y restaurar copia de seguridad

  1. Antes de cualquier actualización, haz una copia de seguridad completa (archivos + base de datos) desde cPanel usando "Backup".
  2. Si la actualización falla:
    • Restaura los archivos desde la copia de seguridad.
    • Restaura la base de datos desde phpMyAdmin.
  3. Vuelve a intentar la actualización pero esta vez con todos los módulos desactivados (renombra la carpeta /modules a /modules_old y crea una nueva vacía).
  4. Si el error persiste, revisa el archivo /app/logs/ (PrestaShop 1.7) o /log/ (versiones anteriores) para ver el error concreto.

## 6. Errores de caché y compilación de temas

A veces, después de modificar un tema o instalar un módulo, la tienda se ve desconfigurada o no se muestran los cambios. Esto se debe a que PrestaShop guarda en caché las plantillas.

### Cómo limpiar la caché desde el back office

  1. Ve a "Parámetros avanzados" > "Rendimiento".
  2. Haz clic en "Forzar compilación" (en la pestaña "Plantillas").
  3. También puedes limpiar la caché desde "Parámetros avanzados" > "Caché" y seleccionar "Vaciar caché".

Si no puedes acceder al back office, hazlo manualmente desde cPanel:

  • Borra el contenido de las carpetas:
    • /var/cache/ (PrestaShop 1.7)
    • /cache/smarty/ (versiones anteriores)
  • También puedes renombrar la carpeta /themes/tu_tema/cache/ a algo como /themes/tu_tema/cache_old/ y luego crearla de nuevo.

## 7. Errores de PHP: versión incompatible o extensiones faltantes

PrestaShop requiere una versión de PHP específica (7.4, 8.0 o 8.1 según la versión de PrestaShop). Además, necesita extensiones como mysqli, gd, curl, mbstring, etc.

### Cómo verificar y cambiar la versión de PHP en cPanel

  1. Ve a "Seleccionar versión de PHP".
  2. Elige la versión recomendada para tu PrestaShop (consulta la documentación oficial).
  3. En la misma pantalla, asegúrate de que las extensiones necesarias estén marcadas. Las más importantes son:
    • mysqli
    • gd
    • curl
    • mbstring
    • openssl
    • json
    • xml
    • zip

[WARNING] Si cambias la versión de PHP, algunos módulos antiguos pueden dejar de funcionar. Siempre verifica la compatibilidad antes.

## 8. Error de "500 Internal Server Error" al acceder a la tienda

Este error genérico puede deberse a un archivo .htaccess corrupto o a un problema con las reglas de reescritura de URL.

### Solución: Regenerar el .htaccess

  1. Desde cPanel, ve al "Administrador de archivos".
  2. Renombra el archivo .htaccess a .htaccess_old (por si acaso).
  3. Accede a tu back office de PrestaShop (si puedes) y ve a "Parámetros avanzados" > "SEO y URLs".
  4. Haz clic en "Guardar" sin cambiar nada; esto regenerará el .htaccess.
  5. Si no puedes acceder al back office, crea un nuevo .htaccess con el contenido básico de PrestaShop que puedes encontrar en la documentación oficial.

## 9. Errores de módulos: incompatibilidad o conflictos

Los módulos son la causa de muchos errores PrestaShop cPanel. A veces, un módulo mal programado puede bloquear toda la tienda.

### Cómo identificar y desactivar módulos problemáticos

  1. Desde el back office: Ve a "Módulos" > "Gestor de módulos" y desactiva los que sospeches.
  2. Si no puedes acceder al back office: Conéctate por FTP o cPanel y renombra la carpeta del módulo en /modules/ (por ejemplo, micodigo a micodigo_off). Esto lo desactivará automáticamente.
  3. Prueba la tienda después de cada desactivación para identificar el culpable.

[TIP] Mantén siempre una lista de módulos esenciales y evita instalar módulos de fuentes no oficiales.

## 10. Errores de SSL: contenido mixto o certificado caducado

Si tu tienda tiene SSL pero ves errores de "contenido mixto" (HTTP y HTTPS mezclados), PrestaShop puede no cargar correctamente.

### Solución: Forzar HTTPS desde PrestaShop

  1. Ve a "Parámetros avanzados" > "General".
  2. Activa "Forzar SSL" y "Forzar SSL en todas las páginas".
  3. Luego, en "Parámetros de la tienda" > "SEO y URLs", asegúrate de que la URL base comience con https://.

Si el error persiste, revisa que todos los recursos (imágenes, CSS, JS) se sirvan por HTTPS. Puedes usar herramientas online como "Why No Padlock" para detectar el contenido mixto.

## Preguntas frecuentes (FAQ) sobre errores PrestaShop cPanel

### ¿Qué hago si no puedo acceder al back office?

Intenta acceder a través de la URL directa: https://tutienda.com/admin1234. Si no funciona, revisa los logs de errores en cPanel. También puedes desactivar módulos problemáticos renombrando carpetas.

### ¿Cómo sé qué versión de PHP usa mi PrestaShop?

En cPanel, ve a "Seleccionar versión de PHP" y verás la versión activa. También puedes crear un archivo info.php con <?php phpinfo(); ?> en la raíz y acceder a él desde el navegador.

### ¿Por qué mi tienda se vuelve lenta de repente?

Puede deberse a un módulo mal optimizado, a que la base de datos necesita ser optimizada (desde phpMyAdmin ejecuta OPTIMIZE TABLE), o a que el servidor tiene poca memoria. Revisa los logs de recursos en cPanel.

### ¿Es seguro usar el modo de desarrollo permanente?

No. El modo de desarrollo (_PS_MODE_DEV_) expone información sensible. Úsalo solo para depurar y luego desactívalo.

### ¿Necesito conocimientos de Linux para solucionar estos errores?

No necesariamente. La mayoría de las soluciones se pueden hacer desde la interfaz gráfica de cPanel. Sin embargo, tener nociones básicas de comandos Linux (como chmod, find, etc.) te ayudará a resolver problemas más rápido.

## Consejos finales de SysAdmin para PrestaShop en cPanel

  • Mantén copias de seguridad periódicas desde cPanel. Programa backups automáticos si tu hosting lo permite.
  • Actualiza PrestaShop y los módulos solo después de probar en un entorno de pruebas (puedes crear un subdominio para ello).
  • Monitoriza los logs de errores y de acceso. En cPanel tienes herramientas como "AWStats" y "Registros de errores".
  • Si usas Syspanel (HestiaCP), recuerda que el acceso es por el puerto 2106. Allí también puedes gestionar archivos, bases de datos y dominios, aunque la interfaz es diferente a cPanel.

[INFO] Si después de seguir todos estos pasos el error persiste, contacta con el soporte de tu hosting. Ellos pueden revisar la configuración del servidor a nivel de sistema operativo (Linux) y detectar problemas que escapan al control de PrestaShop.

Con esta guía, espero que puedas solucionar la mayoría de los errores PrestaShop cPanel que te encuentres. Recuerda: la paciencia y el método son tus mejores aliados. Ve paso a paso, documenta lo que haces y, sobre todo, no olvides hacer copias de seguridad antes de cualquier cambio. ¡Tu tienda online te lo agradecerá!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel