Errores comunes en PrestaShop con cPanel | Soluciones fáciles

¿Te has encontrado con un error inesperado en tu tienda PrestaShop y no sabes por dónde empezar? No te preocupes, es una situación más común de lo que parece. Como SysAdmin o usuario de hosting, resolver estos problemas es parte del día a día. En esta guía, te explicaré paso a paso cómo solucionar los errores más frecuentes en PrestaShop cuando está alojado en un servidor con cPanel. Vamos a desglosar cada problema, desde el temido "error 500" hasta problemas de conexión a la base de datos, con un lenguaje claro y sencillo.

¿Por qué ocurren errores en PrestaShop?

PrestaShop es un sistema de gestión de contenidos (CMS) potente y flexible, pero su complejidad también lo hace propenso a ciertos fallos. Los errores suelen deberse a:

Problemas de configuración del servidor: Límites de memoria, permisos de archivos o versiones de PHP incorrectas.
Conflictos entre módulos o temas: Una mala combinación puede romper la tienda.
Actualizaciones incompletas: Saltar versiones o no seguir el orden correcto.
Base de datos corrupta o con errores: Por cortes de energía o consultas mal formadas.
Archivos de configuración dañados: Como el settings.inc.php.

La buena noticia es que la mayoría tienen solución, y con cPanel tienes herramientas a tu alcance para diagnosticar y reparar.

Error 500 (Internal Server Error) en PrestaShop

Este es, sin duda, el error más temido. Se muestra una pantalla en blanco o un mensaje genérico. Las causas más comunes son:

Límite de memoria PHP excedido.
Archivo .htaccess corrupto.
Módulo o tema defectuoso.
Permisos de archivos incorrectos.

### Solución paso a paso

Activar el modo debug de PrestaShop: Esto te mostrará el error real. Accede a tu cPanel, ve a Administrador de archivos y localiza el archivo config/defines.inc.php. Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. Guarda los cambios y recarga la tienda. Verás un mensaje de error detallado.
Aumentar el límite de memoria PHP: Desde cPanel, ve a Seleccionar versión de PHP (o MultiPHP). Haz clic en Opciones y cambia memory_limit a al menos 256M. También puedes editar el archivo .htaccess en la raíz de PrestaShop añadiendo: php_value memory_limit 256M.
Restaurar un .htaccess limpio: Si el error persiste, renombra el archivo .htaccess a .htaccess_backup y genera uno nuevo desde el back office de PrestaShop (Parámetros de la tienda > Tráfico y SEO > SEO y URLs > Guardar). Si no puedes acceder al back office, crea uno manualmente con el contenido básico:
```
<IfModule mod_rewrite.c>
RewriteEngine On
</IfModule>
```
Deshabilitar módulos sospechosos: Si el error apareció tras instalar un módulo, renombra la carpeta del módulo en /modules/nombre_del_modulo a /modules/nombre_del_modulo_desactivado. Esto lo desactivará temporalmente.
Verificar permisos de archivos: Los archivos deben tener permisos 644 y las carpetas 755. Desde cPanel, selecciona todos los archivos y cambia los permisos de forma recursiva.

[TIP] Si usas Syspanel (HestiaCP), recuerda que el puerto de acceso es el 2106. Allí puedes gestionar archivos y bases de datos de forma similar a cPanel.

Error de conexión a la base de datos en PrestaShop

Este error suele mostrar "Unable to connect to database server" o "Error de base de datos". Las causas típicas son:

Credenciales incorrectas en el archivo de configuración.
Servidor MySQL caído o sobrecargado.
Base de datos corrupta.

### Solución paso a paso

Verificar credenciales de la base de datos: Accede a tu cPanel, ve a Bases de datos MySQL y anota el nombre de la base de datos, el usuario y la contraseña. Luego, desde el Administrador de archivos, abre config/settings.inc.php y asegúrate de que los valores coincidan exactamente. Busca líneas como:
```
define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_bd');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');
```
Comprobar el estado del servidor MySQL: En cPanel, ve a Estado del servidor o MySQL Databases y verifica que el servicio esté activo. Si está detenido, solicita a tu proveedor de hosting que lo reinicie.
Reparar la base de datos: Desde phpMyAdmin en cPanel, selecciona tu base de datos, marca todas las tablas y en el menú desplegable elige Reparar tabla. Esto corrige errores comunes de corrupción.
Aumentar el límite de conexiones: Si el error es intermitente, puede deberse a muchas conexiones simultáneas. En el archivo config/settings.inc.php, añade justo después de las definiciones de DB: define('_DB_PREFIX_', 'ps_'); y luego define('_MYSQL_ENGINE_', 'InnoDB'); (si usas InnoDB).

[WARNING] No compartas nunca tu contraseña de base de datos en foros públicos. Si sospechas que ha sido comprometida, cámbiala desde cPanel.

Problemas con la caché y la compilación de plantillas

A veces, PrestaShop muestra una versión antigua de la tienda o errores visuales. Esto se debe a la caché del sistema o a plantillas no compiladas correctamente.

### Solución paso a paso

Limpiar la caché de PrestaShop: Desde el back office, ve a Parámetros avanzados > Rendimiento. Haz clic en Forzar compilación y luego en Limpiar caché. Si no puedes acceder, hazlo manualmente desde cPanel: elimina todos los archivos dentro de las carpetas cache/smarty/cache y cache/smarty/compile, excepto el archivo index.php.
Deshabilitar la caché temporalmente: En la misma sección de Rendimiento, cambia la opción de Caché a No. Esto ayuda a identificar si el problema es de caché.
Recompilar las plantillas: En el archivo config/defines.inc.php, busca y cambia define('_PS_SMARTY_CACHING_', true); a false. Guarda y recarga la tienda. Luego vuelve a ponerlo en true.

[INFO] Si tienes muchos productos, la compilación puede tardar unos segundos. No te alarmes si la tienda se carga lenta la primera vez.

Error de memoria insuficiente (Allowed memory size exhausted)

Este error es común al instalar módulos pesados o al ejecutar procesos como la generación de sitemaps. El mensaje típico es: "Fatal error: Allowed memory size of X bytes exhausted".

### Solución paso a paso

Aumentar el límite de memoria PHP: Como vimos antes, desde cPanel ve a Seleccionar versión de PHP y ajusta memory_limit a 256M o 512M. También puedes hacerlo desde .htaccess añadiendo: php_value memory_limit 512M.
Optimizar el uso de memoria: Desactiva módulos que no uses, especialmente aquellos que consumen muchos recursos (como analíticas o chat en vivo). Revisa la sección de Módulos en el back office.
Aumentar el tiempo de ejecución: Si el error ocurre al hacer una tarea larga, aumenta max_execution_time a 300 (5 minutos) en las opciones de PHP.

[WARNING] No subas el límite de memoria más de lo necesario, ya que podría afectar el rendimiento del servidor compartido.

Problemas con las URLs amigables (SEO)

Si tus URLs no se ven como tutienda.com/producto-ejemplo sino como index.php?id_product=123, es un problema de configuración de URLs amigables.

### Solución paso a paso

Activar URLs amigables: En el back office, ve a Parámetros de la tienda > Tráfico y SEO > SEO y URLs. Marca la opción Activar URLs amigables y guarda.
Regenerar el archivo .htaccess: Si ya están activadas pero no funcionan, en la misma pantalla haz clic en Guardar sin cambiar nada. Esto fuerza la regeneración del .htaccess.
Verificar el módulo rewrite de Apache: Desde cPanel, ve a Seleccionar versión de PHP y asegúrate de que el módulo mod_rewrite esté activo. Si no, contacta a tu hosting.

[TIP] Si usas Syspanel, el proceso es similar: accede por puerto 2106, ve a la sección de dominios y activa el soporte para .htaccess.

Error al actualizar PrestaShop

Las actualizaciones pueden fallar por varias razones: archivos bloqueados, falta de espacio en disco o incompatibilidad de PHP.

### Solución paso a paso

Verificar la versión de PHP: PrestaShop 1.7 requiere PHP 7.1 o superior, y la versión 8.0 es recomendada. Desde cPanel, cambia la versión de PHP a la recomendada para tu versión de PrestaShop.
Aumentar el tiempo de ejecución: Como antes, ajusta max_execution_time a 600 (10 minutos) para que la actualización no se interrumpa.
Hacer una copia de seguridad: Antes de actualizar, desde cPanel usa Backup para descargar una copia completa de archivos y base de datos. Si algo sale mal, podrás restaurar.
Actualizar manualmente: Si el asistente falla, descarga la última versión de PrestaShop, sube los archivos por FTP (sobrescribiendo los existentes, excepto config/settings.inc.php y la carpeta themes), y luego ejecuta yourtiense.com/install/upgrade/upgrade.php para completar la migración.

[WARNING] Nunca actualices desde una versión muy antigua a la última directamente. Sigue el orden de versiones (ej. 1.6 -> 1.7.0 -> 1.7.8) para evitar errores.

Preguntas Frecuentes (FAQ)

¿Cómo accedo a phpMyAdmin en cPanel?

Desde el panel de cPanel, busca el icono de phpMyAdmin en la sección de Bases de Datos. Haz clic y se abrirá una ventana con acceso a todas tus bases de datos.

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

Edita el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ a true para ver el error. Luego, si es por un módulo, renombra la carpeta del módulo sospechoso en /modules. También puedes intentar restaurar un backup reciente.

¿Por qué mi tienda se carga muy lenta?

Revisa el uso de memoria, desactiva módulos innecesarios, activa la caché (si es estable) y optimiza las imágenes. Desde cPanel, puedes habilitar la compresión Gzip en la sección de Optimizar sitio web.

¿Cómo cambio el prefijo de la base de datos?

No es recomendable hacerlo a menos que sea necesario. Si debes, exporta la base de datos, edita el archivo SQL con un editor de texto (reemplazando el prefijo antiguo por el nuevo), y luego impórtalo. Luego actualiza config/settings.inc.php con el nuevo prefijo.

¿Puedo usar Syspanel (HestiaCP) para gestionar mi PrestaShop?

Sí, Syspanel es una alternativa a cPanel. Recuerda que el puerto de acceso es el 2106. Desde allí puedes gestionar archivos, bases de datos y dominios de forma similar.

Consejos finales para evitar errores en PrestaShop

Mantén todo actualizado: PrestaShop, módulos y temas. Las actualizaciones corrigen bugs y vulnerabilidades.
Haz copias de seguridad periódicas: Desde cPanel, programa backups automáticos semanales.
Usa un entorno de pruebas: Antes de aplicar cambios grandes, prueba en un subdominio o copia local.
Monitorea los logs: En cPanel, revisa Error Log y Raw Access Log para detectar problemas antes de que afecten a los usuarios.

Con esta guía, espero que puedas resolver la mayoría de los errores comunes en PrestaShop alojado en cPanel. Recuerda que la paciencia y el método son clave: identifica el error, busca la causa y aplica la solución paso a paso. Si el problema persiste, no dudes en contactar a tu proveedor de hosting, ya que algunos fallos requieren intervención a nivel de servidor.

¡Buena suerte con tu tienda online!