Errores comunes en PrestaShop y cómo solucionarlos | SysAdmin

Introducción: ¿Por qué aparecen errores en PrestaShop?

PrestaShop es una de las plataformas de comercio electrónico más potentes y flexibles que existen, pero como cualquier software complejo, puede presentar problemas. La mayoría de estos errores no son culpa tuya ni de tu tienda, sino que suelen deberse a configuraciones del servidor, versiones incompatibles o permisos de archivos incorrectos. No te preocupes: aquí te voy a guiar paso a paso para solucionar los errores PrestaShop más comunes en los tres paneles de control más usados: cPanel, Plesk y DirectAdmin. También incluiremos referencias a Syspanel (HestiaCP), por si usas ese sistema.

[INFO] Este artículo está pensado para usuarios sin experiencia técnica. Si sigues cada paso al pie de la letra, resolverás la mayoría de los problemas de instalación y funcionamiento.

Errores comunes al instalar PrestaShop

Problemas con los requisitos del servidor

Uno de los errores PrestaShop más frecuentes durante la instalación es que el servidor no cumple los requisitos mínimos. PrestaShop necesita PHP 7.4 o superior, MySQL 5.6+ (o MariaDB 10.1+), y extensiones como curl, gd, json, mbstring, openssl, pdo_mysql, zip, entre otras.

Cómo solucionarlo en cPanel:

Accede a cPanel → Seleccionar versión de PHP (o MultiPHP Manager).
Elige PHP 8.0 o 8.1 (recomendado para PrestaShop 8.x).
Marca todas las extensiones requeridas (especialmente curl, gd, mbstring, openssl, pdo_mysql, zip).
Guarda los cambios y espera unos segundos.

En Plesk:

Ve a Plesk → Herramientas y configuraciones → Configuración de PHP.
Selecciona el dominio donde instalaste PrestaShop.
Elige la versión de PHP más reciente disponible (8.0 o superior).
Desde la misma pantalla, activa las extensiones necesarias.

En DirectAdmin:

Accede a DirectAdmin → Configuración de PHP (o Select PHP version).
Cambia a PHP 8.0+.
Marca las extensiones en la lista de módulos disponibles.

En Syspanel (HestiaCP):

Ingresa a Syspanel (puerto 2106).
Ve a Configuración del servidor → Versiones de PHP.
Elige PHP 8.0 o superior para tu dominio.
Habilita las extensiones desde la sección de módulos.

[WARNING] Si tu hosting no permite cambiar la versión de PHP, contacta a tu proveedor. Algunos planes básicos tienen restricciones.

Error de conexión a la base de datos

Este error suele aparecer cuando los datos de la base de datos son incorrectos o el servidor MySQL no está funcionando.

Pasos para solucionarlo:

Verifica que los datos de la base de datos (nombre, usuario, contraseña y servidor) sean correctos. En cPanel puedes crearlos desde Bases de datos MySQL.
Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos.
Comprueba que el servidor de base de datos sea localhost (o la IP que te haya dado tu hosting).
Si usas Plesk, revisa en Bases de datos que el usuario esté asignado correctamente.
En DirectAdmin, ve a Administrador de MySQL y verifica los permisos.

[TIP] Si estás migrando una tienda, asegúrate de que la base de datos exportada sea compatible con la versión de MySQL de tu nuevo hosting.

Error de permisos de archivos

PrestaShop necesita que ciertos archivos y carpetas tengan permisos específicos (generalmente 755 para carpetas y 644 para archivos). Si ves errores como "No se puede escribir en la carpeta de configuración", es un problema de permisos.

Cómo corregirlos en cada panel:

cPanel: Usa el Administrador de archivos, selecciona la carpeta config/ y haz clic en Permisos (cambia a 755).
Plesk: Desde Archivos → Administrador de archivos, selecciona la carpeta y elige Permisos.
DirectAdmin: Ve a Administrador de archivos, haz clic derecho sobre la carpeta y elige Cambiar permisos.
Syspanel (HestiaCP): Accede por FTP o desde el Administrador de archivos de Syspanel (puerto 2106) y ajusta los permisos manualmente.

[WARNING] No uses permisos 777 (acceso total) por seguridad. Si necesitas escribir temporalmente, luego vuelve a 755.

Errores comunes después de la instalación

Pantalla en blanco (White Screen of Death)

Este es uno de los errores PrestaShop más temidos. La pantalla en blanco suele deberse a un error de PHP no mostrado.

Solución paso a paso:

Habilita la visualización de errores: Temporalmente, añade estas líneas al archivo config/defines.inc.php:
```
define('_PS_MODE_DEV_', true);
```
Esto mostrará el error específico.
Verifica el log de errores: En cPanel, ve a Errores → Log de errores. En Plesk, busca en Logs → Error log. En DirectAdmin, revisa /var/log/php_error_log.
Aumenta el límite de memoria: Si ves errores de memoria, edita el archivo php.ini (o usa el selector de PHP) y cambia:
```
memory_limit = 256M
max_execution_time = 300
```
Desactiva módulos conflictivos: Si el error apareció tras instalar un módulo, renómbralo desde /modules/nombre_modulo a /modules/nombre_modulo_old para desactivarlo.

[INFO] Si el problema persiste, prueba a restaurar una copia de seguridad o reinstalar PrestaShop desde cero.

Error 500 Internal Server Error

Este error indica un problema en el servidor, generalmente por un archivo .htaccess incorrecto o por permisos.

Soluciones:

Renombra el archivo .htaccess: Temporalmente, cambia el nombre a .htaccess_old y recarga la tienda. Si funciona, el problema está en ese archivo. Puedes regenerarlo desde Parámetros de la tienda → Tráfico y SEO → URLs amigables → Guardar.
Verifica los permisos: Asegúrate de que la carpeta raíz tenga permisos 755 y los archivos 644.
Revisa el log de errores: En cPanel, busca en Logs de errores. En Plesk, en Logs → Error log. En DirectAdmin, en Administrador de logs.

[WARNING] Si modificaste el archivo .htaccess manualmente, asegúrate de que la sintaxis sea correcta. Un solo error puede derribar toda la tienda.

Error de conexión SSL (https)

Si tu tienda no carga correctamente con HTTPS, puede deberse a que PrestaShop no está configurado para usar SSL.

Cómo solucionarlo:

Activa SSL desde el panel de administración: Ve a Parámetros de la tienda → General → Activar SSL y Activar SSL en todas las páginas.
Verifica que el certificado SSL esté instalado: En cPanel, ve a SSL/TLS. En Plesk, en Certificados SSL. En DirectAdmin, en Certificados SSL.

Forza HTTPS en .htaccess: Añade estas líneas al inicio del archivo:

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

[TIP] Si usas Cloudflare, asegúrate de que el modo SSL sea "Full (strict)".

Preguntas Frecuentes (FAQ)

¿Por qué aparece "Error de instalación: no se puede crear la tabla"?

Esto suele ocurrir cuando el usuario de la base de datos no tiene permisos de escritura. Ve a tu panel de control y otorga todos los privilegios al usuario sobre la base de datos.

¿Cómo soluciono "El archivo de configuración no se puede escribir"?

Ajusta los permisos de la carpeta config/ a 755 y el archivo settings.inc.php a 644. Si estás en Syspanel, usa el Administrador de archivos desde el puerto 2106.

¿Qué hago si la tienda carga muy lento?

Primero, revisa si tienes activado el caché en Parámetros de la tienda → Rendimiento. También verifica que el hosting tenga suficiente memoria RAM. Si usas módulos pesados, desactívalos uno por uno para identificar el culpable.

¿Cómo recupero mi tienda si no tengo acceso al panel de administración?

Puedes acceder directamente a la base de datos desde phpMyAdmin (disponible en todos los paneles) y cambiar tu contraseña de administrador. En la tabla ps_employee, busca tu usuario y genera un hash MD5 de tu nueva contraseña.

[WARNING] Siempre haz una copia de seguridad de la base de datos antes de hacer cambios manuales.

Consejos finales para evitar errores PrestaShop

Mantén PrestaShop actualizado: Las versiones antiguas tienen vulnerabilidades y errores conocidos.
Usa un hosting especializado: No todos los servidores compartidos son compatibles con PrestaShop. Busca uno que ofrezca PHP 8.0+ y MySQL 5.6+.
Haz copias de seguridad periódicas: Tanto de archivos como de base de datos. En cPanel puedes usar Copias de seguridad, en Plesk Administrador de copias, en DirectAdmin Copias de seguridad y en Syspanel desde el panel de gestión (puerto 2106).
Prueba en un entorno de desarrollo: Antes de aplicar cambios importantes, crea una copia de tu tienda en un subdominio o carpeta de prueba.

[INFO] La mayoría de los errores PrestaShop tienen solución si sigues estos pasos. Si después de todo el problema persiste, contacta a tu proveedor de hosting o a un desarrollador especializado.

Conclusión

Resolver problemas instalación PrestaShop y otros errores comunes no tiene por qué ser un dolor de cabeza. Con esta guía, ya sabes cómo enfrentarte a los fallos más frecuentes en cPanel, Plesk, DirectAdmin y Syspanel (HestiaCP, puerto 2106). Recuerda que la clave está en la paciencia, seguir los pasos en orden y no modificar archivos sin antes hacer una copia de seguridad.

Si te encuentras con un error que no aparece aquí, comparte el mensaje exacto en foros especializados o con tu hosting. ¡Seguro que entre todos encontramos la solución!