Errores comunes en PrestaShop y soluciones con Syspanel | Guía

Errores comunes en PrestaShop y cómo solucionarlos desde Syspanel

¿Te has encontrado con un error en tu tienda PrestaShop y no sabes por dónde empezar? Es una situación más común de lo que parece. La buena noticia es que muchos de estos problemas tienen una solución sencilla si sabes dónde mirar. En esta guía, vamos a explorar los errores PrestaShop más frecuentes y te enseñaremos a solucionarlos paso a paso utilizando Syspanel (tu panel de control de hosting, que se accede a través del puerto 2106).

[INFO] Syspanel es la herramienta que te permite gestionar tu servidor. Piensa en él como el cuadro de mandos de tu tienda online. Aquí podrás gestionar bases de datos, archivos, dominios y mucho más.

Antes de empezar, es importante que sepas que la mayoría de los problemas PrestaShop se deben a tres causas principales: conflictos entre módulos o temas, problemas de configuración del servidor (como la memoria PHP) o errores en los archivos de la tienda. Syspanel te da acceso directo a todas estas áreas para que puedas diagnosticar y reparar.

1. El famoso "Error 500" o "Página en blanco"

Este es, sin duda, uno de los errores PrestaShop más temidos. Ver una pantalla en blanco o un mensaje de "Error interno del servidor" puede ser desesperante. No te preocupes, casi siempre tiene solución.

¿Por qué ocurre?

Un módulo o tema está generando un conflicto.
La memoria PHP asignada es insuficiente.
Un archivo importante de PrestaShop está dañado o tiene permisos incorrectos.

Cómo solucionarlo desde Syspanel

Accede a Syspanel: Abre tu navegador y escribe https://tudominio.com:2106. Introduce tus credenciales de acceso.
Activa el modo debug de PrestaShop: Esta es la clave para ver el error real. Ve a la sección "Archivos" > "Administrador de archivos". Navega hasta la carpeta raíz de tu tienda (normalmente public_html o www). Busca el archivo config/defines.inc.php. Ábrelo para editarlo.
Edita la línea clave: Busca la línea que dice:
define('_PS_MODE_DEV_', false);
Cámbiala por:
define('_PS_MODE_DEV_', true);
Guarda los cambios.

[TIP] Con el modo debug activado, en lugar de la página en blanco, verás un mensaje de error detallado. Anota ese mensaje, te ayudará a identificar el problema exacto (por ejemplo, "Fatal error: Call to undefined function...").
Aumenta la memoria PHP: Desde Syspanel, ve a "Ajustes del servidor" > "PHP" > "Opciones de PHP". Busca la variable memory_limit y cámbiala a un valor más alto, por ejemplo, 256M o 512M. Guarda los cambios.
Desactiva módulos desde la base de datos (si no puedes entrar al back office): Si el error te impide acceder a tu panel de administración, tendrás que desactivar los módulos manualmente.
- En Syspanel, ve a "Bases de datos" > "phpMyAdmin".
- Selecciona la base de datos de tu PrestaShop.
- Busca la tabla ps_module (el prefijo ps_ puede variar según tu instalación).
- Haz clic en "Examinar". Verás una lista de todos los módulos. Para desactivarlos todos, haz clic en "SQL" y ejecuta la siguiente consulta:
```
UPDATE ps_module SET active = 0 WHERE 1;
```
- Esto desactivará todos los módulos. Después, intenta acceder a tu tienda. Si funciona, el problema está en uno de los módulos. Actívalos de uno en uno desde el back office para identificar al culpable.
Vuelve a desactivar el modo debug: Una vez solucionado, no olvides volver a poner define('_PS_MODE_DEV_', false); en el archivo defines.inc.php.

2. Error de conexión a la base de datos

Este error suele aparecer como "Cannot connect to database" o "Error de conexión a la base de datos". Es un problema PrestaShop que impide que tu tienda cargue cualquier página.

¿Por qué ocurre?

Los datos de conexión en el archivo de configuración son incorrectos.
La base de datos ha sido eliminada o está corrupta.
El usuario de la base de datos no tiene los permisos adecuados.

Cómo solucionarlo desde Syspanel

Verifica los datos de conexión: En Syspanel, ve a "Bases de datos" > "Bases de datos MySQL". Aquí verás el nombre de tu base de datos, el usuario y la contraseña. Anótalos.
Corrige el archivo de configuración: Ve a "Archivos" > "Administrador de archivos" y abre la carpeta raíz. Busca el archivo app/config/parameters.php. Ábrelo y verifica que los valores de database_host, database_name, database_user y database_password coincidan exactamente con los que viste en Syspanel. Corrígelos si es necesario y guarda.
Repara la base de datos: Si los datos son correctos, el problema puede ser una tabla corrupta. En Syspanel, ve a "Bases de datos" > "phpMyAdmin". Selecciona tu base de datos. En la parte inferior, verás un enlace que dice "Marcar todas". En el menú desplegable "Con seleccionados", elige "Reparar tabla". Esto intentará reparar cualquier error en las tablas.
Verifica los permisos del usuario: En la sección de "Bases de datos MySQL" de Syspanel, asegúrate de que el usuario asociado tenga marcados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). Si no, edita el usuario y asígnaselos.

[WARNING] Si después de estos pasos el error persiste, es posible que tu base de datos esté dañada de forma irreversible. En ese caso, tendrás que restaurar una copia de seguridad. Syspanel te permite hacerlo desde la misma sección de bases de datos, siempre que tengas un backup reciente.

3. El carrito no funciona o no se añaden productos

Este es uno de los problemas PrestaShop más molestos para los clientes. Puede manifestarse de varias formas: al hacer clic en "Añadir al carrito" no pasa nada, el carrito se vacía solo o da un error de "token" o "sesión".

¿Por qué ocurre?

Problemas con la caché de PrestaShop o del servidor.
Módulo de carrito desactualizado o conflictivo.
Problemas con las cookies o la sesión del navegador.

Cómo solucionarlo desde Syspanel

Limpia la caché de PrestaShop: Desde el back office de tu tienda, ve a "Parámetros de la tienda" > "Rendimiento" y haz clic en "Limpiar caché". Si no puedes acceder al back office, tendrás que hacerlo manualmente.
Limpia la caché manualmente desde Syspanel:
- Ve a "Archivos" > "Administrador de archivos".
- Navega a la carpeta var/cache dentro de la raíz de tu tienda.
- Dentro de cache, verás carpetas como dev y prod. Elimina todo el contenido de ambas carpetas (no las carpetas en sí, solo los archivos que contienen).
- También puedes eliminar la carpeta cache/smarty para forzar la regeneración de las plantillas.
Verifica el módulo del carrito: Desde tu back office (si puedes acceder), ve a "Módulos" > "Gestor de módulos" y busca el módulo "Carrito" o "Bloque carrito". Desactívalo y actívalo de nuevo. Si el problema persiste, intenta reinstalarlo.
Aumenta el tiempo de vida de la sesión: En Syspanel, ve a "Ajustes del servidor" > "PHP" > "Opciones de PHP". Busca session.gc_maxlifetime y cámbialo a un valor más alto, como 14400 (4 horas). Guarda los cambios.
Comprueba la configuración de cookies: En el back office, ve a "Parámetros de la tienda" > "Rendimiento" y asegúrate de que la opción "Forzar compilación" esté desactivada. También puedes ir a "Parámetros avanzados" > "Rendimiento" y activar la opción "Cache de Smarty" si no lo está.

[TIP] A veces, el problema del carrito se debe a un tema o plantilla mal codificada. Si has instalado un tema recientemente, pruébalo cambiando temporalmente al tema predeterminado de PrestaShop (por ejemplo, "classic").

4. Problemas con las imágenes (no se ven, aparecen rotas)

Las imágenes son esenciales en una tienda online. Si no se cargan, los clientes no confiarán en tu producto. Este error PrestaShop puede deberse a varias causas.

¿Por qué ocurre?

Los permisos de la carpeta de imágenes son incorrectos.
Las imágenes no se han generado correctamente (por ejemplo, al cambiar el tema).
El servidor no tiene suficiente memoria para procesar las imágenes.

Cómo solucionarlo desde Syspanel

Verifica los permisos de la carpeta de imágenes: En Syspanel, ve a "Archivos" > "Administrador de archivos" y navega a la carpeta img en la raíz de tu tienda. Haz clic derecho en la carpeta y selecciona "Permisos". Asegúrate de que tenga permisos 755 (para carpetas) o 644 (para archivos). Si no es así, cámbialos.
Regenera las imágenes desde el back office: Ve a "Parámetros de la tienda" > "Imágenes" y haz clic en "Regenerar miniaturas". Selecciona la opción "Regenerinar todas las imágenes" y espera a que termine. Esto puede tardar unos minutos.
Aumenta el límite de memoria PHP: Como vimos antes, desde Syspanel, en "Ajustes del servidor" > "PHP" > "Opciones de PHP", aumenta memory_limit a 256M o 512M. También puedes aumentar max_execution_time a 300 para evitar que el proceso se detenga.
Comprueba el tamaño de las imágenes originales: Si estás subiendo imágenes muy grandes (por ejemplo, más de 2MB), PrestaShop puede tener problemas para procesarlas. Redimensiona las imágenes antes de subirlas (máximo 1920px de ancho) y comprímelas.

[WARNING] Si las imágenes se ven rotas solo en ciertas páginas (como la página de producto), es posible que el problema sea del tema. Prueba a cambiar al tema predeterminado para descartarlo.

5. Error "El token de seguridad no es válido" al acceder al back office

Este problema PrestaShop puede impedirte acceder a tu panel de administración. Es frustrante, pero solucionable.

¿Por qué ocurre?

La sesión ha caducado o hay un conflicto de cookies.
La URL del back office está mal configurada.
Hay un problema con la base de datos (tabla ps_employee).

Cómo solucionarlo desde Syspanel

Limpia las cookies del navegador: A veces es tan simple como eso. Cierra sesión, borra las cookies de tu navegador y vuelve a intentarlo.
Accede por la URL directa: Asegúrate de que estás usando la URL correcta. Normalmente es tudominio.com/adminXXXXX/index.php (donde adminXXXXX es el nombre de tu carpeta de administración, que puede ser aleatorio por seguridad). Si no la recuerdas, puedes encontrarla en Syspanel, en la sección "Sitios web" > "Ajustes de dominio", o mirando en el administrador de archivos la carpeta raíz.
Reinicia el token desde la base de datos: Si el error persiste, tendrás que forzar un nuevo token.
- En Syspanel, ve a "Bases de datos" > "phpMyAdmin".
- Selecciona tu base de datos.
- Busca la tabla ps_employee (el prefijo puede variar).
- Haz clic en "Examinar" y busca tu usuario (normalmente con ID 1).
- Haz clic en "Editar" (el icono de lápiz).
- Busca el campo token y bórralo (déjalo en blanco). Guarda los cambios.
- Ahora, al intentar acceder al back office, PrestaShop generará un nuevo token automáticamente.
Verifica la URL de la tienda: En la misma tabla ps_employee, busca el campo url y asegúrate de que coincida con la URL real de tu tienda (por ejemplo, https://tudominio.com/adminXXXXX/).

6. La tienda está muy lenta o se cae constantemente

Un rendimiento pobre puede ahuyentar a los clientes y afectar tu SEO. Este error PrestaShop suele estar relacionado con la configuración del servidor.

¿Por qué ocurre?

El servidor no tiene suficientes recursos (RAM, CPU).
La caché de PrestaShop no está optimizada.
Hay módulos pesados o mal optimizados.

Cómo solucionarlo desde Syspanel

Optimiza la caché: En Syspanel, ve a "Ajustes del servidor" > "PHP" > "Opciones de PHP" y activa la opción opcache si no lo está. Esto acelera la ejecución de PHP. También puedes instalar un sistema de caché como Redis o Varnish si tu plan de hosting lo permite (consulta con tu proveedor).
Habilita la compresión Gzip: En Syspanel, ve a "Ajustes del servidor" > "Nginx" (o "Apache", según tu servidor) y busca la opción de compresión Gzip. Actívala. Esto reducirá el tamaño de los archivos que se envían al navegador.
Reduce el número de módulos activos: Desde el back office, desactiva los módulos que no uses. Cada módulo consume recursos.
Aumenta los recursos del servidor: Si tienes un plan de hosting compartido, considera cambiar a un plan VPS o dedicado. Desde Syspanel, en el plan VPS, puedes ajustar la cantidad de RAM y CPU asignada a tu tienda.
Utiliza una CDN: Una Red de Entrega de Contenidos (CDN) puede acelerar la carga de imágenes y archivos estáticos. Syspanel puede integrarse con servicios como Cloudflare.

[INFO] La lentitud también puede deberse a un tema mal optimizado. Si tu tienda es muy lenta incluso con pocos productos, prueba a cambiar al tema predeterminado.

Preguntas Frecuentes (FAQ)

P: ¿Qué hago si no recuerdo la contraseña de Syspanel?
R: En la pantalla de inicio de sesión de Syspanel (puerto 2106), haz clic en "¿Olvidó su contraseña?". Recibirás un correo electrónico para restablecerla. Si no, contacta a tu proveedor de hosting.

P: ¿Puedo usar Syspanel para hacer una copia de seguridad de mi tienda?
R: Sí. Ve a "Copias de seguridad" > "Programar copia de seguridad" y configura la frecuencia. También puedes hacer una copia manual en cualquier momento.

P: ¿Es seguro editar archivos desde Syspanel?
R: Sí, pero ten cuidado. Siempre haz una copia de seguridad del archivo antes de editarlo. Si cometes un error, puedes restaurarlo.

P: ¿Qué hago si el modo debug muestra un error de "Class not found"?
R: Esto indica que un