Solucionar errores PrestaShop en cPanel | Guía de troubleshooting

¡Hola! Si estás leyendo esto, probablemente estés viendo una pantalla en blanco, un mensaje de error feo en tu tienda PrestaShop o no puedas acceder a tu panel de administración. No te preocupes, es más común de lo que parece.

Como técnico de soporte, he visto cientos de casos de errores PrestaShop en cPanel. La buena noticia es que la mayoría se solucionan con unos pocos pasos que no requieren ser un experto en programación.

En esta guía completa y muy visual, vamos a desglosar los errores más habituales: el temido error 500, el frustrante error 404 y los problemas con la base de datos. Usaremos herramientas que ya tienes en tu cPanel (o en tu panel de hosting, como Syspanel, que se accede por el puerto 2106). Al final, tendrás un checklist para solucionar error 500 PrestaShop y cualquier otro tropiezo.

Vamos paso a paso, como si estuviéramos al teléfono.

1. El temido Error 500: Error Interno del Servidor

Este es, sin duda, el rey de los errores PrestaShop cPanel. Aparece de repente, sin avisar. La causa más común es un archivo de configuración dañado o un módulo incompatible. Pero no te asustes, se soluciona.

¿Qué es exactamente?

El error 500 significa que el servidor no puede procesar tu solicitud, pero no te da más detalles. Es como si tu coche no arrancara y el mecánico solo te dijera "algo falla". Nosotros vamos a ser ese mecánico que busca la pieza rota.

Paso 1: Activar el modo debug de PrestaShop (La clave)

Por defecto, PrestaShop esconde los errores para no mostrar información sensible a los visitantes. Pero para nosotros, es como trabajar con una venda en los ojos. Vamos a quitarla.

Accede a tu cPanel (o Syspanel en el puerto 2106) y busca el Administrador de Archivos. Normalmente está en la sección "Archivos".
Navega hasta la carpeta raíz de tu tienda (suele ser public_html o una subcarpeta como tienda).
Busca el archivo llamado config/defines.inc.php. Ábrelo con el editor de texto (clic derecho -> Editar).
Busca esta línea (normalmente está al principio):
define('_PS_MODE_DEV_', false);
Cámbiala por:
define('_PS_MODE_DEV_', true);
Importante: Guarda los cambios. Ahora, en lugar de la pantalla blanca, verás un mensaje de error real (por ejemplo: "Fatal error: Class 'MyModule' not found...").

[WARNING] No dejes el modo debug activado en una tienda en producción. Una vez solucionado el error, vuelve a poner false para que tus clientes no vean mensajes técnicos.

Paso 2: Soluciones rápidas para el Error 500

Una vez que tienes el modo debug activado, puedes leer el error. Pero si no aparece nada o quieres ir a lo seguro, prueba esto:

Desactiva módulos desde la base de datos (método infalible): A veces un módulo malo bloquea todo. No puedes entrar al back-office, pero sí a la base de datos.
1. Ve a phpMyAdmin desde cPanel (sección "Bases de datos").
2. Selecciona la base de datos de tu tienda.
3. Busca la tabla ps_module (o ps_modules). Haz clic en "Examinar" (o "Browse").
4. Busca el módulo que instalaste justo antes de que empezara el error. Usa el botón "Editar" (lápiz) y cambia el valor de active de 1 a 0. Guarda. Esto lo desactiva sin necesidad del panel.
Limpia la caché de PrestaShop: A veces la caché guarda datos corruptos. Ve a /var/cache/ en tu Administrador de Archivos y borra todo el contenido de las carpetas dev, prod y class_index.php. No borres las carpetas, solo su interior.
Revisa los permisos de archivos: Los archivos de PrestaShop deben tener permisos 644 (lectura/escritura para el dueño, solo lectura para otros) y las carpetas 755. En el Administrador de Archivos, selecciona todos los archivos, clic derecho -> "Cambiar permisos". Pon 644 en archivos y 755 en carpetas.

Paso 3: Aumentar el límite de memoria PHP

Si el error 500 aparece al cargar páginas grandes o al instalar módulos, puede ser falta de memoria.

En tu cPanel, busca la sección "Software" o "Configuración de PHP" (Select PHP Version).
Haz clic en la pestaña "Opciones" o "Switch to PHP Options".
Busca memory_limit y cámbialo a 256M o 512M. Guarda los cambios.

2. El Error 404: Página No Encontrada

Este error es menos grave que el 500, pero igual de molesto. Significa que la URL que buscas no existe. Puede pasar al migrar la tienda, cambiar la URL amigable o borrar una página por accidente.

Causas principales del 404 en PrestaShop

URLs amigables mal configuradas: Especialmente después de migrar a un nuevo servidor.
Archivo .htaccess corrupto o faltante: Este archivo es el mapa de rutas de tu tienda.
Enlaces rotos en menús o productos.

Paso 1: Regenerar el archivo .htaccess (Solución mágica)

Este es el primer paso y suele resolver el 90% de los casos.

Desde tu Administrador de Archivos en cPanel, busca el archivo .htaccess en la raíz de tu tienda.
No lo borres. Simplemente, cambia su nombre a .htaccess_old. Esto lo desactiva temporalmente.
Ahora, accede a tu back-office de PrestaShop (si puedes). Ve a Configuración de la tienda -> Tráfico y SEO -> URLs amigables.
Sin cambiar nada, haz clic en el botón "Guardar" (aunque esté todo correcto). Esto regenera automáticamente el archivo .htaccess con las rutas correctas.
Vuelve a tu tienda. El error 404 debería haber desaparecido.

[TIP] Si no puedes acceder al back-office, puedes crear un archivo .htaccess básico manualmente. Busca en Google "PrestaShop htaccess default" y pega el contenido en un archivo nuevo que subas a la raíz.

Paso 2: Verificar las URLs amigables en la base de datos

A veces el problema es que la configuración de la URL amigable está corrupta.

Ve a phpMyAdmin.
Busca la tabla ps_configuration (o ps_configuracion).
Ejecuta esta consulta SQL (puedes usar la pestaña "SQL"):
```
SELECT * FROM ps_configuration WHERE name LIKE '%URL%';
```
Busca las filas con nombres como PS_REWRITING_SETTINGS y PS_FRIENDLY_URL. Asegúrate de que PS_REWRITING_SETTINGS tenga el valor 1 (activado) y PS_FRIENDLY_URL tenga 1 (si usas URLs amigables).
Si no es así, edita la fila y cambia el valor.

Paso 3: Reindexar productos y categorías

Si el 404 afecta a productos o categorías específicas, la tabla de rutas puede estar desactualizada.

En tu back-office, ve a Catálogo -> Productos.
Abajo del todo, verás un botón que dice "Actualizar índices" o "Reindexar". Púlsalo.
Haz lo mismo en Catálogo -> Categorías.
Limpia la caché de PrestaShop (recuerda: desde /var/cache/).

3. Error de Base de Datos: "Error de conexión" o "Tabla no existe"

Este error suele aparecer cuando la tienda no puede comunicarse con la base de datos. Las causas: contraseña incorrecta, servidor de BD caído, o tablas corruptas.

Síntomas comunes

"Error de conexión a la base de datos" al cargar la tienda.
"Table 'ps_product' doesn't exist" al intentar acceder a un producto.
Página en blanco con un mensaje de error de MySQL.

Paso 1: Verificar los datos de conexión en settings.inc.php

Este es el archivo que guarda la "llave" para entrar a la base de datos.

En el Administrador de Archivos, ve a app/config/parameters.php. (En versiones antiguas era config/settings.inc.php).

Ábrelo. Verás algo como:

'database_host' => 'localhost',
'database_name' => 'tu_usuario_bd',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Comprueba que estos datos sean correctos. Si hace poco cambiaste la contraseña de la base de datos desde cPanel, debes actualizarla aquí también.
Si no estás seguro, ve a cPanel -> Bases de datos MySQL y crea un usuario nuevo o verifica el existente. Luego, actualiza el archivo parameters.php.

[WARNING] Nunca edites este archivo con un editor de texto normal. Usa siempre el editor del Administrador de Archivos de cPanel. Un error de sintaxis (una comilla mal puesta) puede romper toda la tienda.

Paso 2: Reparar tablas corruptas con phpMyAdmin

Si la conexión funciona pero ves errores de "tabla no existe" o "corrupta", es hora de reparar.

Ve a phpMyAdmin y selecciona tu base de datos.
Verás una lista de tablas. Marca la casilla de selección de todas (suele haber un check en la parte inferior).
En el menú desplegable "Con seleccionados:" (o "With selected:"), elige "Reparar tabla" (o "Repair table").
phpMyAdmin ejecutará el comando mágico REPAIR TABLE. Espera a que termine. Si alguna tabla no se puede reparar, te dirá que está "in use" o "crash". En ese caso, necesitarás restaurar una copia de seguridad.

Paso 3: Optimizar la base de datos (Mantenimiento preventivo)

Una base de datos desordenada puede causar lentitud y errores aleatorios.

En el mismo phpMyAdmin, con todas las tablas seleccionadas, elige "Optimizar tabla" (o "Optimize table").
Esto reordena los datos y libera espacio. Hazlo una vez al mes.

Preguntas Frecuentes (FAQ)

¿Qué hago si no puedo acceder ni al back-office ni al cPanel?

Si no tienes acceso a nada, contacta a tu proveedor de hosting. Ellos pueden reiniciar servicios o darte acceso temporal. Si tienes acceso SSH, puedes usar comandos como php -v para verificar que PHP funciona.

¿Cómo evitar estos errores en el futuro?

Siempre haz copias de seguridad antes de instalar módulos o actualizar PrestaShop. En cPanel, usa la herramienta "Copias de seguridad" (Backups).
No instales módulos de fuentes no oficiales. Son la principal causa de errores 500.
Mantén PrestaShop y sus módulos actualizados. Las actualizaciones corrigen bugs de seguridad y compatibilidad.
Usa un tema compatible con tu versión de PrestaShop.

Mi tienda da error 500 después de migrar a un nuevo hosting. ¿Qué hago?

Este es un clásico. Sigue estos pasos en orden:

Verifica el archivo parameters.php (o settings.inc.php) con los datos de la nueva base de datos.
Regenera el .htaccess desde el back-office (si puedes acceder) o créalo manualmente.
Limpia la caché (/var/cache/).
Si el error persiste, activa el modo debug para ver el mensaje exacto. Suele ser por un módulo que espera una ruta antigua.

¿Qué es Syspanel? ¿Es como cPanel?

Syspanel es el nombre que le damos a HestiaCP, un panel de control de hosting. Es igual de potente que cPanel. Para acceder a él, usa la dirección https://tudominio.com:2106. Allí encontrarás el Administrador de Archivos, phpMyAdmin y las herramientas de bases de datos que hemos usado en esta guía. El proceso es idéntico.

Resumen final

Los errores PrestaShop en cPanel pueden parecer aterradores, pero con un enfoque metódico, se resuelven rápido. Recuerda:

Error 500: Activa el modo debug, desactiva módulos desde phpMyAdmin, limpia caché y aumenta la memoria PHP.
Error 404: Regenera el .htaccess desde el back-office, verifica las URLs amigables en la BD y reindexa productos.
Error de base de datos: Revisa parameters.php, repara tablas con phpMyAdmin y optimiza periódicamente.

Si después de seguir todos estos pasos el error persiste, no dudes en contactar al soporte de tu hosting. Diles exactamente qué error ves (con el modo debug activado) y los pasos que ya has probado. Te ahorrarás tiempo.

¡Espero que tu tienda vuelva a funcionar perfectamente! Si te surge otra duda, ya sabes dónde encontrarme.