Errores comunes al instalar PrestaShop y cómo solucionarlos

Antes de Empezar: Entendiendo el Problema

Instalar PrestaShop puede parecer una tarea compleja, pero la mayoría de los problemas que surgen durante el proceso tienen soluciones muy concretas y, a menudo, sencillas. Cuando hablamos de instalar PrestaShop problemas, normalmente nos referimos a errores de permisos de archivos, configuraciones de PHP incorrectas o incompatibilidades con el panel de control que estés utilizando.

Este artículo está diseñado para que, paso a paso, puedas identificar y resolver los fallos más comunes. Tanto si usas PrestaShop cPanel como PrestaShop Plesk, aquí encontrarás la guía definitiva para la solución problemas PrestaShop.

Requisitos Previos para una Instalación Exitosa

Antes de lanzarte a corregir errores, es fundamental que tu servidor cumpla con los requisitos mínimos de PrestaShop. Muchos errores PrestaShop ocurren precisamente porque el entorno no es el adecuado.

Versión de PHP Compatible

PrestaShop es exigente con la versión de PHP. Si usas una versión demasiado antigua o demasiado nueva, verás pantallas en blanco o errores de compatibilidad.

PrestaShop 1.7 y 8.x: Requiere PHP 7.1 o superior (idealmente PHP 7.4 u 8.0).
PrestaShop 1.6: Funciona mejor con PHP 5.6 o 7.0.

[INFO] La mayoría de los paneles de control modernos (cPanel, Plesk, Syspanel) permiten cambiar la versión de PHP fácilmente. Si no sabes cómo, busca la sección "Select PHP Version" en cPanel o "PHP Settings" en Plesk.

Extensiones PHP Necesarias

Además de la versión, PrestaShop necesita ciertas extensiones activadas. Si faltan, verás errores de "Clase no encontrada" o funciones deshabilitadas.

Las más críticas son:

curl
gd
intl
mbstring
openssl
pdo_mysql
zip

Memoria Límite de PHP

Un límite de memoria bajo es una causa frecuente de errores PrestaShop durante la instalación, especialmente si tu tienda tiene muchos módulos o temas. Se recomienda un mínimo de 256 MB.

Solución de Problemas en cPanel (PrestaShop cPanel)

cPanel es uno de los paneles más usados en el mundo. Aquí tienes los problemas típicos y sus soluciones.

Error 500: Internal Server Error

Este es, sin duda, el error más común. Aparece una pantalla blanca o un mensaje genérico. Las causas suelen ser:

Archivos .htaccess corruptos: Durante la instalación, PrestaShop genera un .htaccess que a veces entra en conflicto.
Permisos de archivos incorrectos: Los archivos deben tener permiso 644 y las carpetas 755.

Cómo solucionarlo:

Accede a tu Administrador de archivos en cPanel.
Ve a la carpeta public_html (o la carpeta donde instalaste PrestaShop).
Busca el archivo .htaccess. Si no lo ves, activa "Mostrar archivos ocultos".
Renómbralo a .htaccess.bak (esto lo desactiva temporalmente).
Intenta acceder a tu tienda. Si el error desaparece, el problema era el .htaccess.
Ve a Configuración de PHP y asegúrate de que allow_url_fopen esté en On.
Si el problema persiste, revisa los permisos. Haz clic derecho en la carpeta raíz y selecciona "Cambiar permisos". Pon 755 y marca "Recursivo".

[WARNING] No dejes el .htaccess desactivado para siempre. Si ese era el problema, tendrás que regenerarlo desde el panel de administración de PrestaShop (Parámetros avanzados > Rendimiento > "Generar .htaccess").

Error "Fatal error: Allowed memory size of X bytes exhausted"

Este error es claro: tu límite de memoria PHP es demasiado bajo.

Soluciones:

Aumentar el límite desde cPanel: Ve a "Select PHP Version" > "Options" o "Switch to PHP Options". Busca memory_limit y cámbialo a 512M.
Crear un archivo php.ini: Si no puedes cambiarlo desde cPanel, crea un archivo llamado php.ini en la raíz de tu instalación y añade esta línea:
```
memory_limit = 512M
max_execution_time = 300
upload_max_filesize = 64M
```

[TIP] Si usas Syspanel (puerto 2106), el proceso es muy similar, pero la opción se llama "Administrador de PHP" o "PHP Settings". Busca la pestaña de "Opciones" y modifica el valor de memory_limit.

Error de Conexión a la Base de Datos

"No se puede conectar a la base de datos" es otro clásico. Esto suele ser por:

Nombre de usuario o contraseña incorrectos.
Nombre de la base de datos incorrecto.
El usuario no tiene privilegios sobre esa base de datos.

Solución paso a paso:

Ve a "Bases de datos MySQL" en cPanel.
Asegúrate de que el usuario que creaste está asignado a la base de datos con TODOS los privilegios.
Verifica que el nombre de la base de datos y el usuario tengan el prefijo que añade cPanel (ej: usuario_prestashop).
Revisa que el nombre del servidor de base de datos es localhost. Si tu hosting usa un servidor remoto, deberás usar el hostname que te proporcionaron.

Solución de Problemas en Plesk (PrestaShop Plesk)

Plesk tiene una interfaz diferente, pero los problemas son similares. Aquí van las soluciones específicas.

El Instalador de Aplicaciones (Installatron) Falla

Plesk incluye un instalador automático. Si falla, suele ser por falta de permisos en la carpeta o por una versión de PHP incompatible.

Cómo arreglarlo:

Ve a "Aplicaciones" o "Installatron" en tu panel de Plesk.
Busca PrestaShop y haz clic en "Instalar".
En la sección de "Configuración de PHP", selecciona una versión compatible (7.4 u 8.0).
En "Configuración del sitio web", asegúrate de que el campo "Directorio" esté vacío o apunte a la raíz del dominio (ej: /httpdocs).
Si el instalador se queda atascado, cancela y crea la base de datos manualmente desde "Bases de datos" y luego usa el instalador manual de PrestaShop (subiendo los archivos por FTP).

Problemas con la Redacción de Archivos

A veces, Plesk da errores de "Permiso denegado" al escribir archivos de configuración.

Solución:

Conecta por FTP o usa el Administrador de archivos de Plesk.
Navega a la carpeta de tu dominio (httpdocs o subdominio).
Haz clic derecho en la carpeta y selecciona "Cambiar permisos".
Asegúrate de que el usuario del sistema (normalmente psaserv o el usuario del dominio) tenga permisos de lectura y escritura.
Marca la casilla "Aplicar a todos los archivos y subcarpetas" y guarda.

[INFO] A diferencia de cPanel, en Plesk es crucial que el propietario de los archivos sea el usuario del dominio, no el usuario FTP. Si cambias el propietario, PrestaShop no podrá escribir el archivo parameters.php y fallará.

Errores Comunes Durante la Instalación (Independientes del Panel)

Independientemente de si usas PrestaShop cPanel, PrestaShop Plesk o cualquier otro panel, hay errores que trascienden la interfaz.

La Pantalla Blanca en el Paso 3 (Configuración de la Tienda)

Este es uno de los errores PrestaShop más frustrantes. Sueles llegar al paso de crear la tienda y, de repente, todo se congela.

Causas:

Timeout del servidor: El script tarda demasiado en ejecutarse.
Errores de memoria (ya comentados).
Problemas con el módulo de reescritura de URLs (mod_rewrite).

Cómo solucionarlo:

Aumenta el max_execution_time: En tu php.ini, añade max_execution_time = 300.
Desactiva el "mod_rewrite" temporalmente: Si tienes acceso a la configuración del servidor, o si estás en un hosting compartido, intenta instalar PrestaShop con la opción "Amigable URLs" desactivada (aunque el instalador no te lo pida, puedes forzarlo editando el archivo settings.inc.php después de la instalación).
Revisa el log de errores: En cPanel, ve a "Errores" o "Error Log". En Plesk, busca en "Logs" > "Error Log". El mensaje exacto te dará la pista definitiva.

Error "The requested URL /install was not found on this server"

Esto significa que PrestaShop no encuentra la carpeta install. Esto ocurre porque:

Ya has instalado PrestaShop antes y la carpeta fue renombrada o eliminada.
Subiste los archivos a una carpeta incorrecta (por ejemplo, dentro de public_html/public_html).

Solución:

Verifica que los archivos estén directamente en public_html (o httpdocs).
Si ya habías instalado antes, debes eliminar el archivo config/settings.inc.php (para PrestaShop 1.6) o app/config/parameters.php (para PrestaShop 1.7 y 8) para que el instalador se ejecute de nuevo.

Problemas con la Zona Horaria o Configuración Regional

Algunos usuarios ven errores como "Error de zona horaria" o problemas con la configuración de idioma.

Solución:

Ve a tu panel de control y busca la sección de "Configuración de PHP" o "PHP Options".
Busca la directiva date.timezone y configúrala correctamente (ej: date.timezone = "Europe/Madrid" o "America/Mexico_City").
Guarda los cambios y reinicia PHP si es necesario.

Guía Rápida de Solución de Problemas (FAQ)

Para finalizar, aquí tienes una tabla de los problemas más buscados y su solución directa.

¿Por qué me sale "Error de conexión a la base de datos"?

Solución: Revisa el prefijo del usuario y la base de datos en tu panel. En cPanel, suelen llevar tu nombre de usuario delante. Asegúrate de que el usuario tiene todos los privilegios.

¿Cómo aumento el límite de memoria en mi hosting?

Solución: Usa un archivo php.ini en la raíz con memory_limit = 512M. Si no funciona, contacta con tu proveedor de hosting.

¿Qué hago si la instalación se queda al 50%?

Solución: Borra la base de datos y la carpeta de instalación. Sube de nuevo los archivos de PrestaShop (asegúrate de que la descarga no esté corrupta) y vuelve a intentarlo. Verifica que el archivo ZIP no esté dañado.

¿Puedo instalar PrestaShop en un subdominio?

Solución: Sí. Solo asegúrate de que la carpeta de instalación esté dentro del subdominio correspondiente en tu panel de control.

¿Qué significa el error "Class 'PrestaShop\PrestaShop\Adapter...' not found"?

Solución: Este error es común en PrestaShop 1.7 y 8. Suele deberse a archivos corruptos o incompletos. Vuelve a subir todos los archivos de la carpeta src y vendor por FTP, sobrescribiendo los existentes.

[WARNING] Nunca instales PrestaShop en la raíz de un dominio que ya tenga un sitio web funcionando. Podrías sobrescribir archivos importantes. Crea siempre una subcarpeta o utiliza un subdominio para pruebas.

Conclusión: La Paciencia y el Método son Clave

La solución problemas PrestaShop es un proceso de eliminación. No te frustres si el primer intento falla. Sigue estos pasos en orden:

Verifica los requisitos del servidor (PHP, extensiones, memoria).
Comprueba los permisos de archivos y carpetas.
Revisa los logs de error de tu panel de control (cPanel, Plesk o Syspanel).
Aumenta los límites de memoria y tiempo de ejecución.

Con esta guía, la mayoría de los errores PrestaShop se resuelven en cuestión de minutos. Si después de todo sigue fallando, el problema puede estar en el servidor a nivel de configuración de Apache o Nginx, y ahí será necesario contactar con el soporte de tu hosting, pero mencionando los pasos que ya has realizado.

Recuerda que si usas Syspanel, el acceso es a través del puerto 2106, y la lógica es idéntica a cPanel, solo cambia la interfaz. ¡Mucha suerte con tu tienda online!