Errores comunes en PrestaShop: Soluciones para SysAdmin

Si eres responsable de mantener una tienda online con PrestaShop, sabes que la estabilidad y el rendimiento son clave para no perder ventas. Los errores pueden aparecer por muchas razones: un plugin incompatible, una configuración incorrecta del servidor, falta de memoria o problemas con la caché. En este artículo vamos a repasar los errores más comunes en PrestaShop, desde el punto de vista de un SysAdmin, y te daremos soluciones prácticas que puedes aplicar desde tu panel de control (cPanel, Plesk o Syspanel). Todo explicado de forma clara y sin tecnicismos innecesarios.

Error 500: Internal Server Error

Este es, sin duda, uno de los errores PrestaShop más temidos. Aparece de repente y no da ninguna pista visual de qué ha fallado. Normalmente se debe a un problema en el servidor, como un archivo .htaccess mal configurado, un módulo defectuoso o un límite de memoria excedido.

¿Cómo solucionarlo?

Accede a los logs de error del servidor. Desde cPanel puedes ir a "Metrics" > "Errors". En Plesk, busca "Logs" en el panel de la suscripción. Si usas Syspanel (puerto 2106), entra en "Registros del sistema".
Revisa el archivo .htaccess. Si el error apareció tras instalar un módulo de SEO o redirecciones, prueba a renombrar el .htaccess (a .htaccess_old) y luego regenerarlo desde el backoffice de PrestaShop: Preferencias > SEO y URL > Guardar (sin cambiar nada).
Aumenta el límite de memoria PHP. En cPanel, ve a "Select PHP Version" > "Switch to PHP Options" y cambia memory_limit a 256M o 512M. En Plesk, ve a "PHP Settings" dentro del dominio. En Syspanel, edita el archivo php.ini desde el administrador de archivos.
Desactiva módulos recién instalados. Si no puedes acceder al backoffice, renombra la carpeta /modules/nombre_del_modulo desde FTP o el administrador de archivos para desactivarlo forzosamente.

[TIP] Siempre ten una copia de seguridad del .htaccess original antes de modificarlo. Un error aquí puede dejar tu tienda inaccesible.

Error de conexión a la base de datos

Otro clásico. La tienda muestra un mensaje tipo "Cannot connect to database" o "Error establishing a database connection". Esto suele ocurrir tras mover la tienda a otro hosting, cambiar la contraseña de la base de datos o por corrupción en las tablas.

Pasos para resolverlo

Verifica los datos de conexión en /config/settings.inc.php. Abre este archivo y confirma que DB_NAME, DB_USER, DB_PASSWD y DB_SERVER son correctos. Si cambiaste la contraseña en cPanel o Plesk, actualízala aquí también.
Comprueba que el servidor de base de datos está activo. Desde tu panel de control, reinicia el servicio MySQL/MariaDB. En cPanel, usa "MySQL Databases" > "Repair Database". En Plesk, ve a "Herramientas y ajustes" > "Servicios".
Repara las tablas dañadas. Si tienes acceso a phpMyAdmin, selecciona la base de datos de PrestaShop, marca todas las tablas y elige "Reparar tabla" en el menú desplegable.
Revisa los límites de conexión. Si tu hosting tiene muchas visitas, puede superar el límite de conexiones simultáneas. Contacta con tu proveedor o, si tienes acceso root, aumenta max_connections en my.cnf.

[WARNING] No uses el usuario root de la base de datos para PrestaShop. Crea un usuario específico con permisos solo sobre esa base de datos. Es más seguro.

Página en blanco (White Screen of Death)

La famosa "pantalla blanca" sin ningún mensaje de error. Es frustrante porque no sabes por dónde empezar. Casi siempre es por un error PHP silencioso.

Soluciones prácticas

Activa la visualización de errores PHP. Temporalmente, edita el archivo /config/defines.inc.php y cambia _PS_MODE_DEV_ de false a true. Así verás el error concreto en pantalla.
Revisa la memoria PHP. Como en el error 500, asegúrate de que memory_limit es suficiente (al menos 128M, mejor 256M).
Comprueba módulos conflictivos. Desactiva todos los módulos no oficiales moviendo la carpeta /modules a /modules_old y creando una nueva carpeta /modules vacía. Luego ve activando uno a uno.
Verifica la versión de PHP. PrestaShop 1.6 necesita PHP 5.6 o 7.0; PrestaShop 1.7 y 8.x funcionan mejor con PHP 7.4 u 8.0. Desde cPanel o Plesk puedes cambiar la versión PHP fácilmente.

[INFO] Si usas Syspanel (puerto 2106), puedes cambiar la versión PHP desde "Configuración de servicios" > "PHP". Es un proceso muy similar a cPanel.

Error de carga de imágenes (productos, categorías, etc.)

Las imágenes no se suben o aparecen rotas en la tienda. Esto suele deberse a límites de subida, permisos de carpetas o problemas con la caché de imágenes.

¿Qué hacer?

Aumenta los límites de subida en PHP. Desde tu panel de control, busca upload_max_filesize y post_max_size. Ponlos al menos en 20M.
Verifica los permisos de carpetas. Las carpetas /img, /upload y /themes deben tener permisos 755 (directorios) y 644 (archivos). Puedes cambiarlos desde el administrador de archivos de cPanel, Plesk o Syspanel.
Regenera las miniaturas. En el backoffice de PrestaShop, ve a "Parámetros avanzados" > "Rendimiento" > "Regenerar miniaturas". Si no puedes acceder, ejecuta manualmente desde la URL: tutienda.com/index.php?controller=AdminImages&token=tu_token.
Limpia la caché de imágenes. Borra las carpetas /img/tmp y /upload/tmp (si existen) y también la caché del navegador.

[TIP] Si las imágenes se ven borrosas, puede que el tamaño máximo permitido en la configuración de PrestaShop sea muy pequeño. Ajústalo en "Parámetros avanzados" > "Imágenes".

Error de módulo: "No se puede instalar" o "Error 500 al activar"

Los módulos son el alma de PrestaShop, pero también la fuente de muchos errores PrestaShop. Un módulo mal codificado o incompatible puede tirar toda la tienda.

Pasos para diagnosticar y solucionar

Comprueba la compatibilidad. Revisa que el módulo sea para tu versión de PrestaShop. Los módulos de PrestaShop 1.6 no funcionan en 1.7 o 8.x.
Aumenta el tiempo de ejecución PHP. Algunos módulos necesitan más tiempo para instalarse. En php.ini o desde el panel, cambia max_execution_time a 300.
Verifica los permisos de la carpeta del módulo. La carpeta /modules/nombre_modulo debe tener permisos 755 y los archivos 644.
Revisa los logs del servidor. Busca errores como "Class not found" o "Call to undefined function". Te darán pistas sobre qué falta (por ejemplo, una extensión PHP como curl o gd).
Desinstala y vuelve a instalar. A veces el proceso de instalación se corrompe. Desde el backoffice, desinstala el módulo, borra la carpeta y súbelo de nuevo.

[WARNING] No instales módulos nulled (pirateados). Suelen contener código malicioso y son la causa de muchos errores y vulnerabilidades.

Error de caché: la tienda no se actualiza

Cambias un producto, un precio o un texto, pero en la tienda sigue apareciendo lo antiguo. Es un problema típico de caché.

Cómo limpiar la caché correctamente

Limpia la caché interna de PrestaShop. En el backoffice, ve a "Parámetros avanzados" > "Rendimiento" y haz clic en "Limpiar caché". También puedes desactivar temporalmente la caché (CCC para CSS, JavaScript y HTML) para depurar.
Borra la caché del servidor. Si usas Varnish o Redis, reinicia el servicio desde tu panel. En cPanel, busca "Cache Accelerator". En Plesk, ve a "Extensiones" > "Redis". En Syspanel, reinicia el servicio desde "Servicios del sistema".
Limpia la caché del navegador y CDN. Si usas Cloudflare o similar, purga la caché desde su panel.
Comprueba los permisos de la carpeta /cache. Debe tener permisos 755. Si está en 777, cámbialo por seguridad.

[INFO] Si después de limpiar todo sigues viendo datos antiguos, revisa si tienes un plugin de caché de terceros (como un módulo de caché avanzada). Desactívalo temporalmente.

Error de SEO: URLs duplicadas o redirecciones incorrectas

El SEO es fundamental para tu tienda, pero una mala configuración puede provocar errores 404 o contenido duplicado.

Soluciones para problemas SEO comunes

Regenera el archivo .htaccess. Como vimos antes, desde el backoffice: Preferencias > SEO y URL > Guardar. Esto reescribe las reglas de redirección.
Configura las URLs amigables. Asegúrate de que en "SEO y URL" tienes activada la opción "URLs amigables". Si no, actívala y regenera el .htaccess.
Evita contenido duplicado. Usa la etiqueta canónica y configura correctamente los redireccionamientos 301 desde "Parámetros avanzados" > "Redirecciones".
Revisa los sitemaps. Genera un nuevo sitemap desde "Módulos" > "Módulos instalados" > "Google Sitemap". Luego notifica a Google Search Console.
Comprueba los robots.txt. Asegúrate de que no estás bloqueando páginas importantes. Puedes editarlo desde el administrador de archivos.

[TIP] Si tu tienda tiene muchas categorías y productos, usa un módulo de SEO especializado para gestionar metadatos y redirecciones de forma masiva.

Error de rendimiento: la tienda va muy lenta

Una tienda lenta ahuyenta clientes y perjudica tu posicionamiento. Las causas pueden ser muchas: hosting compartido, módulos pesados, imágenes sin optimizar, etc.

Medidas para mejorar el rendimiento

Activa la compresión y la caché. En "Rendimiento", activa CCC para CSS y JavaScript, y la caché de Smarty. También puedes usar un módulo de caché como "Cache Boost" o similar.
Optimiza las imágenes. Usa herramientas como TinyPNG antes de subirlas. PrestaShop también tiene una opción de compresión en "Parámetros avanzados" > "Imágenes".
Minimiza el uso de módulos. Desactiva los que no uses. Cada módulo carga scripts y consultas a la base de datos.
Actualiza PHP y la base de datos. Las versiones recientes de PHP son mucho más rápidas. También optimiza las tablas de la base de datos desde phpMyAdmin.
Considera un CDN. Si tu tienda tiene tráfico global, un CDN como Cloudflare reduce la carga del servidor y acelera la entrega de contenido.

[WARNING] No actives todas las opciones de CCC a la vez si tienes muchos módulos. Puede romper el diseño. Actívalas una a una y prueba.

Preguntas Frecuentes (FAQ)

¿Por qué aparece "Error de base de datos" después de migrar?

Lo más probable es que los datos de conexión en /config/settings.inc.php no coincidan con los de tu nuevo hosting. Revisa usuario, contraseña, nombre de la base y servidor (normalmente "localhost").

¿Cómo puedo restaurar mi tienda si no tengo acceso al backoffice?

Usa FTP o el administrador de archivos de tu panel (cPanel, Plesk o Syspanel) para desactivar módulos problemáticos renombrando carpetas. También puedes restaurar una copia de seguridad de la base de datos desde phpMyAdmin.

¿Qué hago si mi tienda se cae cada vez que hay mucho tráfico?

Aumenta los límites de PHP (memoria, ejecución, subida) y considera contratar un VPS o servidor dedicado. También puedes usar un plugin de caché y un CDN para aliviar la carga.

¿Es seguro usar Syspanel para gestionar mi tienda?

Sí, Syspanel (puerto 2106) es una alternativa moderna a cPanel y Plesk. Ofrece las mismas funciones básicas: gestión de archivos, bases de datos, PHP, logs y servicios. Solo asegúrate de que tu hosting lo soporte.

¿Cada cuánto debo limpiar la caché de PrestaShop?

Depende de la frecuencia con que actualices contenido. Si cambias productos a diario, limpia la caché al menos una vez al día. Si tu tienda es más estática, una vez a la semana basta.

Conclusión

Los errores PrestaShop pueden parecer abrumadores, pero la mayoría tienen soluciones sencillas si sabes dónde mirar. Como SysAdmin, tu mejor aliado es el panel de control: cPanel, Plesk o Syspanel (puerto 2106) te permiten acceder a logs, ajustar PHP, reparar bases de datos y gestionar archivos. Recuerda siempre tener copias de seguridad actualizadas y hacer cambios de uno en uno para identificar rápidamente la causa de cualquier problema.

Si este artículo te ha sido útil, compártelo con otros administradores de tiendas PrestaShop. Y si tienes alguna duda concreta, déjala en los comentarios (si tu plataforma lo permite) o consulta la documentación oficial de PrestaShop. ¡Buena suerte con tu tienda!