Errores comunes en PrestaShop con Syspanel y cómo solucionarlos

Instalar PrestaShop puede ser un proceso sencillo, pero es habitual encontrarse con algunos errores PrestaShop Syspanel que pueden frenar tu proyecto. En esta guía, te explicamos paso a paso cómo solucionar PrestaShop Syspanel y resolver los problemas instalación PrestaShop más frecuentes, sin necesidad de ser un experto técnico.

Requisitos previos antes de instalar PrestaShop en Syspanel

Antes de comenzar, es importante que tu servidor cumpla con los requisitos mínimos de PrestaShop. Syspanel (antes conocido como HestiaCP) gestiona tu hosting de forma visual, y el acceso a su panel se realiza a través del puerto 2106 (ejemplo: https://tudominio.com:2106).

Asegúrate de tener:

PHP 7.4, 8.0 o 8.1 (PrestaShop 8.x requiere PHP 8.0 como mínimo).
MySQL 5.7+ o MariaDB 10.2+.
Apache con mod_rewrite activado.
Memoria PHP suficiente (al menos 256 MB, recomendado 512 MB).
Extensiones PHP necesarias: gd, curl, json, mbstring, openssl, pdo_mysql, xml, zip, intl.

[TIP] Puedes verificar la versión de PHP y extensiones desde Syspanel > Ajustes de servidor o contactando con tu proveedor de hosting.

Error 1: “Falta la extensión PHP” o “Requisitos no cumplidos”

Uno de los problemas instalación PrestaShop más comunes es que el asistente de instalación te muestre una lista de extensiones PHP deshabilitadas.

Causa

Syspanel puede tener una versión de PHP que no incluye todas las extensiones que PrestaShop necesita.

Solución paso a paso

Accede a Syspanel usando https://tudominio.com:2106 con tus credenciales.
Ve a Ajustes del servidor o Configuración de PHP (dependiendo de la versión de Syspanel, puede estar en “Servidor” o “Paquetes”).
Selecciona el paquete de hosting que estás usando (por ejemplo, “default”).
Activa las extensiones que falten: gd, curl, json, mbstring, openssl, pdo_mysql, xml, zip, intl.
Guarda los cambios y reinicia Apache desde la misma sección.
Vuelve a ejecutar el instalador de PrestaShop.

[WARNING] Si no encuentras la opción de activar extensiones, contacta con tu proveedor de hosting para que lo haga desde el servidor.

Error 2: “No se puede conectar a la base de datos”

Este error aparece cuando introduces mal los datos de conexión o la base de datos no está creada correctamente.

Causa

Syspanel crea bases de datos con nombres y usuarios específicos que debes copiar exactamente.

Solución paso a paso

En Syspanel, ve a Base de datos y crea una nueva base de datos (si no la tienes).
Anota exactamente:
- Nombre de la base de datos (suele ser usuario_nombrebd).
- Usuario de la base de datos (suele ser usuario_usuario).
- Contraseña (la que asignaste).
- Servidor de base de datos: normalmente localhost.
Durante la instalación de PrestaShop, en el paso de “Base de datos”, copia y pega estos datos sin errores tipográficos.
Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos (lo puedes verificar desde Syspanel > Base de datos > Editar).

[INFO] Si usas MariaDB en lugar de MySQL, funciona exactamente igual. PrestaShop es compatible con ambos.

Error 3: “Error 500” o pantalla en blanco después de la instalación

Un error 500 interno del servidor suele deberse a permisos incorrectos o a un archivo .htaccess mal configurado.

Causa

Los archivos de PrestaShop no tienen los permisos adecuados para ser leídos y ejecutados por Apache.

Solución paso a paso

Conéctate por FTP o desde el administrador de archivos de Syspanel (en Syspanel, ve a Archivos > Administrador de archivos).
Navega hasta la carpeta donde instalaste PrestaShop (normalmente public_html o una subcarpeta).
Cambia los permisos de la carpeta config y cache a 755 (clic derecho > Permisos).
Asegúrate de que el archivo .htaccess existe en la raíz. Si no, renombra el archivo htaccess.txt a .htaccess.
Borra el archivo cache/class_index.php (si existe) para regenerar la caché.
Desde Syspanel, reinicia Apache (Servidor > Servicios > Reiniciar Apache).

[TIP] Si el error persiste, revisa el log de errores de Apache desde Syspanel > Registros > Error log. Busca líneas que digan “PHP Fatal error” para más detalles.

Error 4: “La URL de la tienda no es accesible” o “Error de redirección”

Este error aparece cuando la URL que configuraste en PrestaShop no coincide con la real, o hay un problema con el SSL.

Causa

PrestaShop guarda la URL base en la base de datos, y si la cambias de dominio o de protocolo (HTTP a HTTPS), se rompe.

Solución paso a paso

Accede a la base de datos desde Syspanel > Base de datos > phpMyAdmin.
Selecciona tu base de datos de PrestaShop.
Busca la tabla ps_configuration (o el prefijo que hayas usado).
Localiza las filas con PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.
Edita los valores para que coincidan con tu dominio actual (ejemplo: tudominio.com).
También revisa la tabla ps_shop_url y actualiza el campo domain y domain_ssl.

[WARNING] Si cambiaste de HTTP a HTTPS, asegúrate de que tu certificado SSL esté instalado en Syspanel (puedes hacerlo desde Web > Ajustes SSL).

Error 5: “Tiempo de ejecución excedido” durante la instalación

A veces la instalación se queda “cargando” y termina en un error de timeout.

Causa

El límite de tiempo de ejecución de PHP es demasiado bajo para descargar e instalar los módulos de PrestaShop.

Solución paso a paso

Aumenta el tiempo de ejecución desde Syspanel:
- Ve a Ajustes del servidor > Configuración de PHP.
- Busca max_execution_time y cámbialo a 300 (segundos).
- Guarda y reinicia Apache.
Alternativa: Si no puedes modificar PHP desde Syspanel, crea un archivo php.ini en la raíz de la instalación con el siguiente contenido:
```
max_execution_time = 300
memory_limit = 512M
```
Vuelve a intentar la instalación.

[INFO] También puedes instalar PrestaShop manualmente subiendo los archivos por FTP y luego ejecutando el instalador. Esto evita el timeout de descarga.

Error 6: “El archivo settings.inc.php no se puede escribir”

Este error aparece cuando PrestaShop intenta guardar la configuración pero no tiene permisos de escritura.

Causa

Los permisos de la carpeta config son incorrectos.

Solución paso a paso

Desde el administrador de archivos de Syspanel o FTP, ve a la carpeta config.
Cambia los permisos a 755 (o 777 temporalmente durante la instalación, y luego vuelve a 755).
Si el archivo settings.inc.php ya existe, borra el archivo y vuelve a ejecutar el instalador.
Una vez finalizada la instalación, vuelve a poner los permisos de la carpeta config a 755 y del archivo settings.inc.php a 644.

[TIP] Nunca dejes los permisos en 777 después de la instalación por seguridad.

Error 7: “Módulos no se pueden instalar” o “Error al descargar módulos”

Después de instalar PrestaShop, algunos módulos oficiales no se instalan correctamente.

Causa

Falta la extensión allow_url_fopen o problemas con la conexión a los servidores de PrestaShop.

Solución paso a paso

Activa allow_url_fopen desde Syspanel > Configuración de PHP (búscalo y ponlo en “On”).
Revisa el firewall de tu servidor: asegúrate de que permita conexiones salientes a api.prestashop.com y download.prestashop.com.
Instala los módulos manualmente: descarga el módulo desde el marketplace de PrestaShop, súbelo por FTP a la carpeta modules y actívalo desde el panel de administración.

[WARNING] Si tu hosting tiene un proxy o CDN, puede bloquear las descargas. Contacta con tu proveedor para que lo desbloquee.

Error 8: “Error de compatibilidad con la versión de PHP”

PrestaShop 8.x no funciona con PHP 7.3 o inferior, y algunas versiones antiguas de PrestaShop no funcionan con PHP 8.x.

Causa

La versión de PHP asignada a tu dominio en Syspanel no es compatible con la versión de PrestaShop que quieres instalar.

Solución paso a paso

Verifica la versión de PHP desde Syspanel > Web > Editar dominio (busca la opción “Versión de PHP”).
Cambia la versión de PHP a 8.0 o 8.1 si usas PrestaShop 8.x, o a 7.4 si usas PrestaShop 1.7.x.
Guarda los cambios y espera unos segundos a que se actualice.
Borra la caché del navegador y vuelve a ejecutar el instalador.

[INFO] Syspanel permite tener diferentes versiones de PHP para distintos dominios. No afecta a otros sitios.

Error 9: “El carrito no funciona” o “Error de sesión”

Después de la instalación, los usuarios no pueden añadir productos al carrito o se cierra la sesión constantemente.

Causa

Problemas con las cookies de sesión o el archivo config/defines.inc.php.

Solución paso a paso

Edita el archivo config/defines.inc.php y busca la línea:
```
define('_COOKIE_KEY_', '...');
define('_COOKIE_IV_', '...');
```
No los modifiques, pero asegúrate de que no estén vacíos.
Borra la carpeta var/cache (o cache en versiones antiguas) para regenerar la sesión.
Verifica el dominio y SSL en la tabla ps_configuration como en el Error 4.
Prueba con otro navegador o borra las cookies del sitio.

[TIP] Si usas Cloudflare o un CDN, desactiva la opción “Rocket Loader” y asegúrate de que las cookies de sesión no se bloqueen.

Error 10: “La página de administración no carga” o “Error 404 en /admin”

Después de la instalación, no puedes acceder al panel de administración.

Causa

La carpeta admin fue renombrada durante la instalación por seguridad, o el enlace es incorrecto.

Solución paso a paso

Busca la carpeta de administración en la raíz de tu instalación. Por defecto, PrestaShop la renombra como adminXXXXXX (donde XXXXXX es un código aleatorio).
Anota el nombre exacto de la carpeta (ejemplo: admin123abc).
Accede a https://tudominio.com/admin123abc (cambia admin123abc por tu carpeta real).
Si no aparece, revisa el archivo .htaccess y asegúrate de que no esté bloqueando el acceso a la carpeta admin.

[WARNING] No cambies el nombre de la carpeta admin manualmente, ya que está vinculada a la base de datos. Si lo haces, tendrás que actualizar la tabla ps_configuration.

Consejos finales para evitar errores PrestaShop Syspanel

Realiza copias de seguridad antes de cualquier cambio.
Usa siempre la última versión estable de PrestaShop.
Mantén Syspanel actualizado (versión 3.8 o superior recomendada).
Si tienes dudas, consulta los logs de error desde Syspanel > Registros > Error log.
Para instalaciones complejas, considera usar el instalador automático de Syspanel (Softaculous o similar) que a menudo evita estos errores.

[INFO] Recuerda que Syspanel es una herramienta potente, y la mayoría de los problemas instalación PrestaShop se solucionan ajustando los permisos, la versión de PHP o las extensiones. Si después de seguir esta guía sigues teniendo errores, contacta con tu proveedor de hosting con los logs de error a mano.

¡Esperamos que esta guía te haya sido útil! Ahora ya sabes cómo solucionar PrestaShop Syspanel y disfrutar de tu tienda online sin dolores de cabeza.