Cómo solucionar errores comunes en PrestaShop (cPanel)

¿Tu tienda PrestaShop se ha vuelto lenta, muestra una pantalla en blanco o te lanza un temido error 500? No te preocupes. Como técnico de soporte, he visto cientos de casos como el tuyo. La mayoría de los errores PrestaShop cPanel tienen solución en pocos minutos si sabes dónde mirar. En esta guía completa, te explicaré paso a paso cómo solucionar problemas PrestaShop desde el panel de control de tu hosting, sin necesidad de ser un experto en programación. Vamos a empezar.

[INFO] Esta guía está pensada para usuarios que gestionan su tienda a través de cPanel. Si tu proveedor usa otro panel, como Syspanel (accesible por el puerto 2106), los pasos son muy similares pero la interfaz cambiará ligeramente.

¿Por qué aparecen errores en PrestaShop con cPanel?

Antes de lanzarnos a las soluciones, es útil entender el origen. Los errores más comunes en PrestaShop suelen deberse a:

• Problemas de permisos de archivos (los más frecuentes).
• Límites de memoria PHP insuficientes.
• Conflictos entre módulos o temas.
• Errores de base de datos (MySQL).
• Archivos .htaccess corruptos.

Vamos a ver cómo atacar cada uno de estos puntos desde tu panel cPanel.

Solución #1: El error 500 (Internal Server Error) – El más común

El cPanel PrestaShop error 500 es un clásico. Aparece de repente y no te dice nada más. Es un error genérico que significa "algo salió mal en el servidor". Aquí tienes la ruta de diagnóstico.

Paso 1: Activar el modo debug de PrestaShop

El primer paso es hacer que PrestaShop te cuente qué falla exactamente. Para ello, edita el archivo de configuración principal.

1. Accede a cPanel y busca el Administrador de Archivos (File Manager).
2. Navega hasta la carpeta raíz de tu tienda (normalmente public_html o una subcarpeta).
3. Busca el archivo config/defines.inc.php.
4. Haz clic derecho y selecciona Editar.
5. Busca la línea: define('_PS_MODE_DEV_', false);
6. Cámbiala por: define('_PS_MODE_DEV_', true);
7. Guarda el archivo.

[WARNING] No olvides desactivar el modo debug cuando termines, volviendo a poner false. Si lo dejas activo, cualquier visitante podrá ver errores internos de tu tienda.

Ahora recarga la página que daba error. Verás un mensaje de error detallado (por ejemplo, "Fatal error: Allowed memory size exhausted"). Eso ya nos da una pista.

Paso 2: Aumentar la memoria PHP

Si el error dice algo de "memory size", la solución es sencilla desde cPanel.

1. En cPanel, busca la sección Software y haz clic en Seleccionar versión de PHP (o "MultiPHP Manager").
2. Una vez dentro, busca la opción Opciones o Switch to PHP Options.
3. Localiza el parámetro memory_limit y cámbialo a un valor más alto, por ejemplo 256M o incluso 512M.
4. También puedes subir max_execution_time a 120 y upload_max_filesize a 64M.
5. Guarda los cambios.

[TIP] Si no ves estas opciones, contacta con tu hosting. Algunos planes básicos tienen límites muy restrictivos.

Paso 3: Restaurar el archivo .htaccess

Un archivo .htaccess dañado también provoca el error 500.

1. En el Administrador de Archivos, asegúrate de mostrar archivos ocultos (opción "Mostrar archivos ocultos").
2. Busca el archivo .htaccess en la raíz de tu tienda.
3. Renómbralo a .htaccess_old (por si acaso).
4. Ve al panel de administración de PrestaShop (si puedes acceder) y ve a Configuración de la tienda > Tráfico y SEO > URL amigables. Desmarca y vuelve a marcar "URLs amigables" y guarda. Esto regenerará el .htaccess automáticamente.
5. Si no puedes acceder al admin, crea un archivo nuevo vacío llamado .htaccess y pégalo dentro con este contenido básico:

   # START PrestaShop
   <IfModule mod_rewrite.c>
   RewriteEngine on
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteCond %{REQUEST_FILENAME} !-d
   RewriteRule . index.php [L]
   </IfModule>
   # END PrestaShop
   

Solución #2: Pantalla en blanco (White Screen of Death)

Este es otro de los errores PrestaShop cPanel más desconcertantes. La página carga pero no se ve nada. Generalmente es por un error PHP fatal o un módulo conflictivo.

Paso 1: Deshabilitar módulos manualmente

Si no puedes entrar al back office, tendrás que hacerlo desde la base de datos o el sistema de archivos.

Opción A: Desde el Administrador de Archivos

1. Ve a la carpeta modules de tu instalación de PrestaShop.
2. Localiza la carpeta del módulo que instalaste justo antes de que empezara el problema.
3. Renombra la carpeta añadiendo _old al final (ej: superplugin_old). Esto desactiva el módulo.
4. Prueba a cargar la tienda. Si funciona, ya sabes quién es el culpable.

Opción B: Desde phpMyAdmin (base de datos)

1. En cPanel, busca phpMyAdmin.
2. Selecciona la base de datos de tu tienda.
3. Busca la tabla ps_module (el prefijo ps_ puede variar).
4. Busca el módulo problemático y cambia su estado active de 1 a 0.

[WARNING] Ten cuidado al editar la base de datos. Si no estás seguro, mejor pide ayuda a tu hosting.

Paso 2: Limpiar la caché de PrestaShop

A veces la caché se corrompe y da una pantalla en blanco.

1. En el Administrador de Archivos, elimina todo el contenido de la carpeta var/cache (o cache en versiones antiguas).
2. También puedes eliminar la carpeta cache/smarty/cache y cache/smarty/compile.
3. Vuelve a cargar la tienda. Si no funciona, prueba a crear un archivo llamado parameters.php vacío en la carpeta app/config/ (esto fuerza a PrestaShop a regenerar la configuración).

Solución #3: Errores de conexión a la base de datos

Si ves mensajes como "Error de conexión a la base de datos" o "Table not found", el problema está en MySQL.

Paso 1: Verificar credenciales en settings.inc.php

1. En el Administrador de Archivos, ve a app/config/ y busca parameters.php (o settings.inc.php en versiones antiguas).
2. Ábrelo y verifica que los datos del servidor, usuario y contraseña de la base de datos sean correctos. Puedes obtenerlos desde la sección Bases de datos MySQL de cPanel.
3. Si has cambiado la contraseña recientemente, actualízala aquí.

Paso 2: Reparar tablas desde phpMyAdmin

1. Entra a phpMyAdmin y selecciona tu base de datos.
2. Marca todas las tablas (clic en "Seleccionar todo").
3. En el menú desplegable "Con seleccionados", elige Reparar tabla.
4. Espera a que termine. Esto arregla tablas corruptas.

Solución #4: Errores de permisos de archivos

PrestaShop necesita permisos específicos para funcionar. Si ves errores de "no se puede escribir" o "no se puede crear archivo", es por esto.

Cómo corregir permisos desde cPanel

1. En el Administrador de Archivos, selecciona toda la carpeta de tu tienda (marca la raíz).
2. Haz clic derecho y elige Cambiar permisos.
3. Aplica estos valores:
   • Carpetas: 755 (o 775 si tu hosting lo requiere).
   • Archivos: 644 (o 664).
4. Marca la opción "Recursivo" para que se aplique a todas las subcarpetas.
5. Haz clic en Cambiar permisos.

[INFO] Algunos archivos específicos como config/settings.inc.php o la carpeta cache pueden necesitar permisos 777 temporalmente durante la instalación o actualización, pero nunca los dejes así por seguridad.

Solución #5: Errores de módulos o temas incompatibles

Después de una actualización de PrestaShop, muchos módulos dejan de funcionar. Esto provoca errores como "Class not found" o "Method does not exist".

Paso 1: Actualizar módulos manualmente

1. Desde el back office (si puedes entrar), ve a Módulos > Catálogo de módulos y actualiza todo.
2. Si no puedes entrar, descarga la última versión del módulo desde el sitio del desarrollador y sube la carpeta a modules mediante FTP o el Administrador de Archivos, sobrescribiendo la anterior.

Paso 2: Cambiar al tema predeterminado

1. En el Administrador de Archivos, ve a la carpeta themes.
2. Renombra la carpeta de tu tema actual (ej: mi_tema_old).
3. PrestaShop usará automáticamente el tema por defecto (normalmente "classic"). Si la tienda vuelve a funcionar, el problema es tu tema.

Preguntas frecuentes (FAQ) sobre errores PrestaShop cPanel

P: ¿Por qué mi tienda da error 500 después de una actualización?
R: Es muy común. Prueba a aumentar la memoria PHP a 256M, desactivar todos los módulos no nativos y limpiar la caché. Si sigue, revisa el archivo .htaccess.

P: No puedo acceder al back office, ¿cómo soluciono errores PrestaShop?
R: Usa el Administrador de Archivos de cPanel para editar defines.inc.php y activar el modo debug. También puedes deshabilitar módulos renombrando carpetas.

P: ¿Los errores de PrestaShop pueden deberse a mi hosting?
R: Sí, especialmente si tienes un plan compartido muy básico. Los límites de memoria, el tiempo de ejecución y la versión de PHP son críticos. PrestaShop 1.7+ necesita PHP 7.1 o superior.

P: ¿Cómo sé si mi base de datos está corrupta?
R: Si ves errores de "Table 'ps_product' doesn't exist" o mensajes similares en el modo debug, entra a phpMyAdmin y repara las tablas como te expliqué.

P: ¿Qué hago si después de todo sigue el error?
R: Contacta con el soporte de tu hosting. A veces el problema está en el servidor (mod_security, límites de inodos, etc.). Diles que has seguido estos pasos y necesitas que revisen los logs del servidor.

Consejo final: Prevención

Para evitar futuros errores PrestaShop cPanel, te recomiendo:

• Siempre hacer una copia de seguridad antes de actualizar o instalar módulos. En cPanel puedes usar "Copias de seguridad" o un plugin de backup.
• Mantener PrestaShop, módulos y tema actualizados a la última versión estable.
• No instalar módulos de fuentes no oficiales. Son la principal causa de errores y vulnerabilidades.
• Revisar los logs de errores de vez en cuando. En cPanel, busca "Error Log" o "Apache Logs".

[TIP] Si tu hosting usa Syspanel (puerto 2106), el proceso es el mismo pero las herramientas se llaman diferente. Busca "Administrador de archivos" y "Base de datos" en el menú principal.

Espero que esta guía te haya servido para solucionar problemas PrestaShop desde cPanel. Recuerda, la paciencia es clave. Si un paso no funciona, prueba el siguiente. Y si te quedas atascado, no dudes en pedir ayuda a tu proveedor de hosting o a la comunidad de PrestaShop. ¡Buena suerte con tu tienda!