Errores comunes en PrestaShop con Syspanel: soluciones prácticas

¿Tu tienda PrestaShop se ha quedado congelada, da un error 500 o no puedes acceder al panel de administración? No te preocupes, es más común de lo que crees. Cuando gestionas tu tienda online con Syspanel (nuestro panel de control basado en HestiaCP, accesible por el puerto 2106), algunos fallos típicos de PrestaShop pueden solucionarse con unos pocos clics y ajustes básicos.

En esta guía extensa y muy visual, vamos a desglosar los errores PrestaShop Syspanel más frecuentes y te daremos pasos claros para solucionar PrestaShop Syspanel sin necesidad de ser un experto en programación. Al final, tendrás un checklist de PrestaShop fallos comunes y sus remedios inmediatos.

1. Error 500 (Internal Server Error) en PrestaShop

Este es, sin duda, el más temido. Una pantalla en blanco o un mensaje de error 500 suele deberse a un problema de memoria, un plugin conflictivo o un archivo .htaccess corrupto.

¿Cómo solucionarlo desde Syspanel?

Accede a Syspanel: Abre tu navegador y ve a tudominio.com:2106. Inicia sesión con tus credenciales.
Ve a la sección de Archivos: Busca la opción "Administrador de archivos" o "File Manager".
Localiza la carpeta de tu tienda: Normalmente está en public_html o en una subcarpeta personalizada.
Renombra el archivo .htaccess: Busca el archivo .htaccess (puede estar oculto, activa "Mostrar archivos ocultos"). Cámbiale el nombre a .htaccess_old. Si el error desaparece, el problema está en ese archivo. Puedes regenerarlo desde el panel de administración de PrestaShop (si logras entrar) o subir uno limpio.
Aumenta el límite de memoria PHP: En Syspanel, busca "Configuración PHP" o "PHP Options". Aumenta memory_limit a 256M o 512M. Guarda los cambios y reinicia el servicio.

[TIP] Si el error persiste, revisa los logs de errores en Syspanel (sección "Logs" > "Error log"). Allí verás la línea exacta del fallo, a menudo relacionada con un módulo.

2. Error de conexión a la base de datos (Error establishing a database connection)

Este error suele aparecer cuando cambias de servidor, restauras una copia de seguridad o modificas la contraseña de la base de datos desde Syspanel.

Pasos para restaurar la conexión

Verifica los datos de la base de datos: En Syspanel, ve a "Base de datos" y anota el nombre, usuario y contraseña actuales.
Edita el archivo de configuración de PrestaShop: Usa el Administrador de archivos para abrir app/config/parameters.php (en PrestaShop 1.7+) o config/settings.inc.php (en versiones antiguas).
Actualiza los valores: Busca las líneas database_host, database_name, database_user, database_password. Asegúrate de que coincidan exactamente con los datos de Syspanel.
Prueba la conexión: En Syspanel, usa la herramienta "phpMyAdmin" para acceder a la base de datos con esas credenciales. Si no puedes entrar, el problema está en los datos, no en PrestaShop.

[WARNING] Nunca modifiques el puerto de la base de datos a menos que sepas lo que haces. Por defecto es 3306.

3. Pantalla blanca al acceder al back office

¿Puedes ver la tienda pero no el panel de administración? Esto suele deberse a un tema o módulo incompatible.

Solución rápida desde Syspanel

Desactiva todos los módulos no esenciales: En Syspanel, ve a la base de datos con phpMyAdmin. Selecciona la tabla ps_module (o el prefijo que uses) y ejecuta la consulta SQL:
UPDATE ps_module SET active = 0 WHERE id_module > 1;
Esto desactivará todos los módulos excepto los básicos. Luego intenta acceder al back office.
Cambia temporalmente el tema: Si el problema es el tema, edita la tabla ps_configuration y busca PS_THEME_NAME. Cámbialo a classic (el tema por defecto).
Limpia la caché de PrestaShop: Aún desde phpMyAdmin, busca la tabla ps_cache y vacíala. O, si tienes acceso a la terminal, usa el comando rm -rf var/cache/* desde la carpeta raíz de la tienda.

[INFO] Si no te sientes cómodo con SQL, puedes desactivar módulos desde el back office si logras entrar. Pero si no puedes, esta es la vía más rápida.

4. Error al subir imágenes o productos

Los errores de carga suelen estar relacionados con límites de tamaño o permisos de archivos.

Ajustes necesarios en Syspanel

Aumenta el límite de subida de archivos: En "Configuración PHP", cambia upload_max_filesize y post_max_size a 64M o más.
Verifica los permisos de carpetas: Las carpetas img, upload y download deben tener permisos 755 (o 775 en algunos casos). En el Administrador de archivos, haz clic derecho sobre la carpeta y selecciona "Permisos".
Comprueba el espacio en disco: En Syspanel, ve a "Estadísticas" o "Uso de disco". Si está al 100%, libera espacio eliminando copias de seguridad antiguas o logs.

[TIP] Si el error es "No se puede escribir en la carpeta", el problema es casi siempre de permisos. Usa chmod 755 -R sobre la carpeta problemática desde la terminal de Syspanel.

5. Error "El servidor no responde" o timeout

Esto ocurre cuando un script tarda demasiado en ejecutarse, por ejemplo al importar productos o generar un sitemap.

Cómo evitar los timeouts

Aumenta el tiempo de ejecución de PHP: En Syspanel, busca max_execution_time y ponlo a 300 (5 minutos).
Divide las tareas grandes: Si estás importando un CSV, hazlo en lotes de 100 productos.
Usa el modo CLI: Si tienes acceso a la terminal (SSH desde Syspanel), ejecuta scripts largos con php -d max_execution_time=0 importar.php. Esto evita el límite de tiempo del servidor web.

[WARNING] No aumentes max_execution_time a valores extremos (ej. 99999) a menos que sea necesario, ya que podría afectar el rendimiento general del servidor.

6. Error de SSL o HTTPS (contenido mixto)

Después de instalar un certificado SSL, tu tienda puede mostrar el error "contenido mixto" (imágenes o scripts cargados sin HTTPS).

Corrección desde Syspanel

Verifica la URL base: En app/config/parameters.php, busca PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL. Deben apuntar a tudominio.com con https://.

Fuerza HTTPS desde el .htaccess: Añade estas líneas al inicio del archivo .htaccess:

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

Limpia la caché de imágenes: En el back office (si puedes entrar), ve a "Parámetros de la tienda" > "Rendimiento" y limpia la caché. Si no, borra manualmente las carpetas img/tmp y var/cache.

[INFO] Si usas Syspanel, puedes instalar un certificado SSL gratuito desde la sección "SSL" > "Let's Encrypt". Asegúrate de que el dominio esté apuntando correctamente.

7. Error "El módulo no se puede instalar" o "Clase no encontrada"

Este fallo aparece cuando subes un módulo manualmente pero falta algún archivo o la carpeta no tiene los permisos correctos.

Solución paso a paso

Sube el módulo correctamente: En Syspanel, usa el Administrador de archivos para ir a modules/ y crea una carpeta con el nombre del módulo (ej. mimodulo). Sube todos los archivos del módulo allí.
Verifica los permisos: La carpeta del módulo debe tener permisos 755 y los archivos 644.
Comprueba el nombre de la clase: Abre el archivo principal del módulo (ej. mimodulo.php). Busca la línea class MiModulo extends Module. El nombre de la clase debe coincidir exactamente con el nombre de la carpeta (con mayúsculas y minúsculas).
Reinstala desde el back office: Ve a "Módulos" > "Módulos y servicios" y busca tu módulo. Si no aparece, usa el botón "Subir módulo" y selecciona el archivo ZIP.

[TIP] Si el módulo es de pago, asegúrate de que esté diseñado para tu versión de PrestaShop. Los módulos antiguos suelen dar este error.

8. Error de caché o rendimiento lento

Una tienda lenta puede deberse a una caché mal configurada o a que no se ha activado la compilación.

Optimización desde Syspanel

Activa la compilación de plantillas: En "Configuración PHP", asegúrate de que opcache.enable esté en On. Luego, en el back office de PrestaShop, ve a "Parámetros de la tienda" > "Rendimiento" y activa:
- Combinar, comprimir y almacenar en caché (CSS/JS)
- Caché de Smarty: "Recompilar las plantillas si se han modificado"
- Caché de la base de datos: "Usar caché de MySQL"
Limpia la caché del servidor: En Syspanel, usa la opción "Limpiar caché" o ejecuta systemctl restart apache2 (o nginx) desde la terminal.
Reduce el tamaño de las imágenes: Usa herramientas externas o módulos de optimización para comprimir imágenes antes de subirlas.

[WARNING] No actives todas las opciones de caché a la vez sin probar. Puede generar conflictos con algunos módulos.

Preguntas frecuentes (FAQ)

¿Por qué aparecen errores después de actualizar PrestaShop?

Las actualizaciones pueden cambiar la estructura de la base de datos o requerir nuevas versiones de PHP. Siempre haz una copia de seguridad completa desde Syspanel antes de actualizar.

¿Cómo restauro una copia de seguridad desde Syspanel?

Ve a "Copia de seguridad" > "Restaurar". Selecciona el archivo de backup (archivo .tar.gz). Asegúrate de que incluya tanto los archivos como la base de datos.

¿El error 500 puede deberse a un plugin de SEO?

Sí, especialmente si el plugin modifica el .htaccess o las URLs amigables. Desactívalo desde la base de datos como explicamos antes.

¿Syspanel tiene un límite de tráfico que pueda causar errores?

No directamente, pero si tu hosting tiene límites de recursos (CPU, RAM), un pico de visitas puede saturarlo. Revisa las estadísticas de Syspanel para ver el uso de recursos.

Conclusión

La mayoría de los errores PrestaShop Syspanel tienen solución con unos pocos ajustes en la configuración de PHP, permisos de archivos o base de datos. Recuerda que Syspanel te da control total sobre tu servidor, pero conlleva la responsabilidad de mantenerlo optimizado.

Si después de seguir estos pasos el error persiste, no dudes en contactar a nuestro equipo de soporte. Estaremos encantados de ayudarte a solucionar PrestaShop Syspanel para que tu tienda vuelva a funcionar al 100%.

[INFO] Guarda esta guía en favoritos. Te será útil cada vez que enfrentes PrestaShop fallos comunes relacionados con el panel de control.