Errores comunes en PrestaShop y cómo solucionarlos desde el panel

Si estás gestionando tu tienda online con PrestaShop, es muy probable que en algún momento te encuentres con algún error inesperado. La pantalla en blanco, los problemas al cargar el carrito o la imposibilidad de acceder al back office son situaciones más comunes de lo que parecen. Pero no te preocupes; la mayoría de estos errores PrestaShop tienen una solución sencilla que puedes aplicar desde tu panel de control.

En esta guía, te explicaré cómo solucionar PrestaShop paso a paso, centrándonos en lo que puedes hacer desde tu PrestaShop cPanel, PrestaShop Plesk o cualquier otro panel como Syspanel (recuerda, si usas Syspanel, accede por el puerto 2106). Nuestro objetivo es que, sin ser un experto técnico, puedas realizar un mantenimiento PrestaShop básico y resolver los problemas más frecuentes.

El temido "Error 500" o pantalla blanca

Este es, sin duda, el error más común y a la vez el que más asusta. De repente, tu tienda se vuelve completamente blanca o muestra un mensaje genérico de error interno del servidor. La causa suele ser un archivo corrupto, un módulo incompatible o un límite de memoria excedido.

Solución desde cPanel o Plesk

Para empezar, necesitas acceder a tu panel de control. Si usas cPanel, busca la sección "Archivos" y haz clic en "Administrador de Archivos". Si usas Plesk, ve a "Sitios web y dominios" y luego a "Administrador de archivos". En Syspanel (puerto 2106), la opción se llama "Gestor de archivos".

Una vez dentro, sigue estos pasos:

1. Localiza la carpeta raíz de tu tienda: Normalmente es public_html o httpdocs.
2. Busca el archivo config/defines.inc.php: Abre este archivo con el editor de texto del panel.
3. Activa el modo debug: Busca la línea que dice define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. Guarda los cambios.
4. Recarga tu tienda: Ahora, en lugar de la pantalla blanca, verás un mensaje de error detallado. Anota el mensaje, ya que te indicará el archivo y la línea exacta del problema.
5. Solución común: Si el error menciona un módulo, desactívalo cambiando el nombre de su carpeta (por ejemplo, de /modules/nombremodulo a /modules/nombremodulo_old). Si el error es de memoria, deberás aumentar el límite editando el archivo config/defines.inc.php y añadiendo ini_set('memory_limit', '256M'); justo debajo de la línea de apertura <?php.

[TIP] Siempre que edites un archivo, haz una copia de seguridad antes. Así, si algo sale mal, puedes restaurarlo fácilmente.

El carrito de compras no funciona o da error

Otro de los errores PrestaShop más frustrantes es cuando el cliente añade productos al carrito, pero este no se actualiza o muestra un mensaje de error. Esto suele estar relacionado con las cookies, la caché o la configuración de SSL.

Solución desde el panel de control

Aunque la mayoría de estos ajustes se hacen desde el back office, a veces necesitas tocar archivos desde el panel para forzar una solución.

1. Regenerar las cookies del carrito: Accede a tu panel de archivos y navega hasta la carpeta /var/cache. Dentro, encontrarás subcarpetas como dev, prod o cachefs. Elimina todo el contenido de estas carpetas (pero no las carpetas en sí mismas). Esto borrará la caché de PrestaShop y forzará a que se regeneren las cookies.
2. Verifica la configuración de SSL: Si cambiaste recientemente a HTTPS, es posible que haya mezcla de contenidos. Desde el panel de archivos, edita el archivo /config/settings.inc.php (solo en versiones antiguas de PrestaShop 1.6) o /app/config/parameters.php (PrestaShop 1.7 y 1.8). Busca las líneas que contengan _PS_SSL_ENABLED_ y asegúrate de que estén en '1' (true). Si no encuentras estas líneas, no las añadas manualmente; mejor usa la herramienta de "Multishop" desde el back office.
3. Comprueba los permisos de archivos: A veces, el carrito no funciona porque los archivos de sesión no se pueden escribir. Desde el administrador de archivos, selecciona toda la carpeta raíz (excepto las subcarpetas de sistema como dev o proc) y haz clic en "Permisos". Ajusta los permisos a 755 para las carpetas y 644 para los archivos. Si tu panel tiene una opción de "Reparar permisos", úsala.

[WARNING] No cambies los permisos de archivos si no estás seguro. Un permiso incorrecto, como 777, puede dejar tu tienda vulnerable.

No puedo acceder al back office (panel de administración)

Imagina que intentas entrar a /admin y te sale un error de "redireccionamiento en bucle" o "demasiadas redirecciones". Esto suele pasar después de una migración o al cambiar la URL de la tienda.

Solución desde Plesk o Syspanel

La solución aquí es modificar la base de datos directamente desde el panel de control.

1. Accede a la base de datos: En cPanel, busca "phpMyAdmin". En Plesk, ve a "Bases de datos" y haz clic en "phpMyAdmin". En Syspanel (puerto 2106), busca "Base de datos" y luego "phpMyAdmin".
2. Selecciona tu base de datos: Verás una lista de tablas. Busca la tabla ps_configuration (o tb_configuration si usas Thirty Bees).
3. Localiza la URL de la tienda: Ejecuta la siguiente consulta SQL (pégala en la pestaña "SQL"): SELECT * FROM ps_configuration WHERE name LIKE '%PS_SHOP_DOMAIN%';. Esto te mostrará las filas PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.
4. Edita los valores: Haz clic en el lápiz (editar) de cada fila y asegúrate de que el valor coincida exactamente con tu dominio actual, sin http:// ni https://, solo el dominio (ejemplo: tutienda.com). Haz lo mismo con la tabla ps_shop_url.
5. Limpia la caché de PrestaShop: Además de borrar la carpeta /var/cache como vimos antes, desde el mismo phpMyAdmin puedes ejecutar: TRUNCATE TABLE ps_cache; (si existe).

[INFO] Si después de esto sigues sin poder acceder, prueba a acceder con la URL directa: tutienda.com/admin/index.php?controller=AdminLogin. A veces el problema es solo de redirección.

Errores de conexión a la base de datos

Este error suele aparecer como "Error de conexión a la base de datos" o "Link to database cannot be established". Puede deberse a que el servidor de base de datos está caído, las credenciales son incorrectas o la tabla está corrupta.

Solución desde cPanel

1. Verifica el estado del servidor MySQL: En cPanel, busca "Estado del servidor" o "MySQL Databases". Si ves que el servicio está detenido, intenta reiniciarlo desde "Servicios" o contacta a tu proveedor de hosting.
2. Revisa las credenciales: Accede al administrador de archivos y abre el archivo /app/config/parameters.php. Busca las líneas database_host, database_name, database_user y database_password. Compáralas con las credenciales de tu base de datos en cPanel. Si no coinciden, cámbialas.
3. Repara tablas corruptas: Desde phpMyAdmin, selecciona tu base de datos, marca todas las tablas (con el check de arriba), y en el menú desplegable "Con seleccionados" elige "Reparar tabla". Esto suele solucionar errores de lectura/escritura.

Problemas con el envío de correos electrónicos

Tu tienda no envía emails de confirmación de pedido o de registro. Esto es crítico para las ventas.

Solución desde Plesk o Syspanel

1. Verifica la configuración SMTP: Desde el back office de PrestaShop (si puedes acceder), ve a "Parámetros Avanzados" > "Email" y cambia el método de envío a "SMTP". Si no puedes acceder al back office, edita el archivo config/defines.inc.php y añade define('_PS_MAIL_METHOD_', 2); (2 = SMTP). Luego, desde el panel de archivos, busca el archivo config/parameters.php y añade las credenciales SMTP (servidor, puerto, usuario, contraseña) en el array mail.
2. Configura el SPF y DKIM: Esto se hace desde el panel de control. En Plesk, ve a "Correo" > "Configuración de DNS". Añade un registro SPF que incluya tu servidor de envío. En Syspanel, busca "Zonas DNS" y añade los registros necesarios. Sin estos registros, los correos pueden ir a la carpeta de spam o ser rechazados.
3. Prueba el envío: Desde tu panel de control, usa la herramienta "Enviar correo de prueba" (en cPanel está en "Correo" > "Enviar correo de prueba"). Si el correo llega, el problema es de PrestaShop. Si no, es del servidor.

Mantenimiento preventivo: la clave para evitar errores

La mejor forma de solucionar errores PrestaShop es no tenerlos. Un buen mantenimiento PrestaShop desde tu panel de control incluye estas tareas:

• Actualizaciones periódicas: Desde tu panel de archivos, antes de actualizar PrestaShop, haz una copia de seguridad completa de los archivos y la base de datos. Muchos paneles (como cPanel) tienen un asistente de "Copias de seguridad" que te permite descargar un zip de todo.
• Monitorización de logs: En cPanel, busca "Logs de errores" o "Raw Access Logs". En Plesk, está en "Sitios web y dominios" > "Logs". Revisa estos logs semanalmente para detectar errores incipientes.
• Optimización de la base de datos: Desde phpMyAdmin, selecciona tu base de datos y en la pestaña "Operaciones" usa "Optimizar tabla". Esto reduce el tamaño y mejora la velocidad.
• Gestión de la caché: Además de borrar la caché manualmente, puedes configurar un cron job desde tu panel (en cPanel: "Tareas programadas") para que ejecute periódicamente la limpieza de la carpeta /var/cache.

[TIP] Programa una tarea cron diaria que ejecute: php /ruta/a/tutienda/admin/autoupgrade/backup.php (si tienes el módulo de actualización) o simplemente un script que borre la caché.

Preguntas frecuentes (FAQ)

¿Qué hago si no encuentro el archivo defines.inc.php?

En PrestaShop 1.7 y superiores, este archivo está en la raíz, no en /config. Si no lo ves, puede que tu versión lo haya movido a /config/defines.inc.php o que esté oculto. En tu panel de archivos, activa la opción "Mostrar archivos ocultos" (en cPanel está en la esquina superior derecha del Administrador de Archivos).

¿Puedo solucionar un error 500 desde el back office?

No, si el error es grave, el back office también estará caído. Siempre deberás usar el panel de control (cPanel, Plesk o Syspanel) para acceder a los archivos o la base de datos.

¿Cada cuánto debo hacer mantenimiento a mi PrestaShop?

Recomiendo hacer una revisión básica cada mes: limpiar caché, revisar logs y optimizar la base de datos. Las actualizaciones de seguridad, cada vez que salga un parche (suele ser cada 2-3 meses).

¿Qué es Syspanel y por qué usas ese nombre?

Syspanel es un panel de control de hosting alternativo a cPanel y Plesk. Es muy común en servidores VPS optimizados. Si tu hosting usa Syspanel, recuerda que el puerto de acceso es el 2106 (ejemplo: tudominio.com:2106). Las funciones son similares, pero la interfaz es más limpia.

Conclusión

Los errores PrestaShop son parte del día a día de cualquier tienda online, pero no tienen por qué ser un dolor de cabeza. Con un poco de conocimiento sobre cómo usar tu PrestaShop cPanel, PrestaShop Plesk o Syspanel, puedes resolver la mayoría de problemas en minutos. La clave está en mantener la calma, seguir los pasos de esta guía y, sobre todo, hacer copias de seguridad regulares.

Recuerda que solucionar PrestaShop no es magia, es simplemente saber dónde mirar. Ya sea desde el administrador de archivos, phpMyAdmin o los logs del servidor, tu panel de control es la herramienta más poderosa que tienes. Si algo sale muy mal, siempre puedes restaurar una copia de seguridad y empezar de nuevo. ¡No te rindas!