Errores comunes en PrestaShop y cómo solucionarlos

¡Hola! Soy el técnico de soporte de tu hosting. Hoy vamos a ponernos manos a la obra para resolver esos errores de instalación de PrestaShop que a veces pueden asustar un poco. No te preocupes, porque en esta guía vamos a ver paso a paso cómo solucionar los problemas más comunes.

Cuando decides montar tu tienda online, PrestaShop es una opción fantástica, pero a veces durante la instalación pueden aparecer pantallazos blancos, errores de base de datos o problemas con los permisos de archivos. Aquí te voy a explicar de forma sencilla cómo solucionar cada uno de ellos.

Errores comunes al instalar PrestaShop

Antes de lanzarnos a las soluciones, es importante que identifiques qué tipo de error estás viendo. Los más frecuentes son:

Pantalla blanca o error 500 (nada aparece, solo un fondo blanco).
Error de conexión a la base de datos (no encuentra la base o no puede conectarse).
Error de permisos de archivos (no se pueden escribir o leer carpetas).
Problemas con la versión de PHP (incompatible con PrestaShop).
Errores de memoria PHP (límite de memoria excedido).
Problemas con módulos o temas (que se cuelgan durante la instalación).

Vamos a ver cada uno con calma.

1. Pantalla blanca o error 500 (Error interno del servidor)

Este es el error más desesperante porque no ves ningún mensaje, solo una página en blanco. No te asustes, suele ser por un problema de configuración de PHP o de permisos.

¿Por qué ocurre?

Límite de memoria PHP insuficiente (PrestaShop necesita al menos 128 MB, mejor 256 MB).
Error en el archivo .htaccess (sobre todo si vienes de un hosting anterior).
Módulo o tema defectuoso que se carga al inicio.
Versión de PHP no compatible (PrestaShop 1.7 requiere PHP 7.1 o superior, y PrestaShop 8 requiere PHP 7.3 o superior).

¿Cómo lo soluciono?

Paso 1: Activar la visualización de errores

Para ver el error real, necesitas activar el modo debug de PrestaShop. Edita el archivo config/defines.inc.php (dentro de la carpeta de tu instalación) y cambia esta línea:

define('_PS_MODE_DEV_', false);

Por:

define('_PS_MODE_DEV_', true);

Guarda el archivo y recarga la página. Ahora verás un mensaje de error más descriptivo (por ejemplo, "Fatal error: Allowed memory size exhausted").

Paso 2: Aumentar el límite de memoria PHP

Si ves un error de memoria, debes aumentar el límite. Puedes hacerlo de dos formas:

Desde el panel de control (Syspanel): Accede a tu panel de hosting (Syspanel) en el puerto 2106. Busca la sección de "PHP Settings" o "Configuración de PHP" y aumenta el valor de memory_limit a 256M o 512M.
Editando el archivo .htaccess: Añade esta línea al final de tu archivo .htaccess (en la raíz de tu PrestaShop):

php_value memory_limit 256M

Paso 3: Desactivar módulos problemáticos

Si el error aparece justo después de instalar un módulo, renombra la carpeta modules (por ejemplo a modules_old) para que PrestaShop no los cargue. Luego ve a tu panel de administración y desactívalos uno a uno.

[TIP] Si no puedes acceder al panel, renombra la carpeta modules desde tu cliente FTP o desde el administrador de archivos de Syspanel. Luego, vuelve a crear una carpeta modules vacía para que la tienda funcione.

2. Error de conexión a la base de datos

Este error suele aparecer al principio de la instalación o al intentar acceder a la tienda. El mensaje típico es: "No se puede conectar a la base de datos".

¿Por qué ocurre?

Datos de la base de datos incorrectos (nombre, usuario, contraseña o servidor).
La base de datos no existe o no se ha creado.
El usuario no tiene permisos sobre la base de datos.
El servidor de base de datos está caído (poco común en hosting compartido).

¿Cómo lo soluciono?

Paso 1: Verifica los datos de conexión

Durante la instalación de PrestaShop, en el paso de configuración de la base de datos, asegúrate de que:

Servidor de base de datos: Normalmente es localhost o 127.0.0.1. En algunos hosting puede ser un servidor remoto (p.ej. mysql.tudominio.com). Pregunta a tu soporte si no estás seguro.
Nombre de la base de datos: Debe coincidir exactamente con el que creaste en tu panel de hosting.
Usuario: El usuario que creaste para esa base.
Contraseña: La que pusiste al crear el usuario.

Paso 2: Crea la base de datos desde Syspanel

Si no la has creado aún, accede a Syspanel (puerto 2106), ve a "Base de Datos" y crea una nueva base de datos y un usuario con todos los permisos. Anota los datos.

Paso 3: Edita el archivo de configuración

Si ya instalaste PrestaShop pero luego cambiaste los datos, puedes editar el archivo app/config/parameters.php (en PrestaShop 1.7 y 8) y corregir las líneas:

'database_host' => 'localhost',
'database_name' => 'nombre_de_tu_base',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Guarda y recarga.

[WARNING] Nunca uses el usuario root de la base de datos. Crea siempre un usuario específico para PrestaShop.

3. Errores de permisos de archivos y carpetas

PrestaShop necesita permisos específicos para escribir en ciertas carpetas (como cache, log, upload, img, etc.). Si ves errores como "No se puede escribir en el directorio" o "Permiso denegado", es por esto.

¿Cómo lo soluciono?

Paso 1: Establece los permisos correctos

Desde tu cliente FTP o desde el administrador de archivos de Syspanel, navega a la carpeta raíz de PrestaShop y establece estos permisos:

Carpetas (directorios): 755 (rwxr-xr-x)
Archivos (no ejecutables): 644 (rw-r--r--)

Paso 2: Dale permisos de escritura a carpetas específicas

Las siguientes carpetas deben tener permisos 755 (o 777 si el hosting es muy restrictivo):

cache/
log/
img/
mails/
modules/
themes/ (y sus subcarpetas)
translations/
upload/
download/

[INFO] En Syspanel, puedes seleccionar varias carpetas a la vez y cambiar permisos de forma masiva. Es más rápido que hacerlo archivo por archivo.

Paso 3: Verifica el propietario de los archivos

A veces el problema es que los archivos pertenecen a otro usuario (por ejemplo, si subiste archivos con un usuario FTP diferente al del servidor web). En Syspanel, puedes usar la opción "Cambiar propietario" o pedir a soporte que lo haga.

4. Problemas con la versión de PHP

PrestaShop es exigente con la versión de PHP. Si tu hosting usa una versión antigua, la instalación fallará o dará errores extraños.

¿Qué versión necesito?

PrestaShop 1.6: PHP 5.6 (ya no recomendado, mejor actualizar).
PrestaShop 1.7: PHP 7.1 a 7.4 (PHP 7.3 es la más estable).
PrestaShop 8: PHP 7.3 a 8.1 (PHP 8.0 es la recomendada).

¿Cómo lo cambio?

Desde Syspanel: Accede al panel (puerto 2106), busca "PHP Settings" o "Selector de PHP" y elige la versión que necesites. Luego guarda los cambios.

Desde .htaccess: Si tu hosting lo permite, añade esta línea al archivo .htaccess:

AddHandler application/x-httpd-php73 .php

(Cambia 73 por la versión que necesites, por ejemplo 80 para PHP 8.0).

[TIP] Si tienes dudas, contacta con soporte y pregunta cuál es la versión de PHP recomendada para tu PrestaShop.

5. Error de límite de memoria PHP excedido

Este error suele aparecer durante la instalación de módulos grandes o al subir imágenes. El mensaje típico es "Fatal error: Allowed memory size of X bytes exhausted".

¿Cómo lo soluciono?

Además de lo que vimos antes (aumentar memory_limit), puedes:

Aumentar el límite de ejecución: Añade al .htaccess:

php_value max_execution_time 300
php_value max_input_time 300

Desactivar módulos pesados: Temporalmente, desactiva módulos que consuman mucha memoria (como los de importación masiva).
Usar un PHP más moderno: Las versiones recientes de PHP gestionan mejor la memoria.

6. Errores con la tienda en modo mantenimiento

A veces, después de instalar, la tienda se queda en modo mantenimiento y no puedes acceder al front-end. Esto es normal durante la instalación, pero si no se quita, hay que forzarlo.

¿Cómo lo soluciono?

Paso 1: Accede a tu panel de administración (por ejemplo, tudominio.com/admin).

Paso 2: Ve a "Parámetros de la tienda" > "Mantenimiento" y desactiva la opción "Activar modo mantenimiento".

Paso 3: Si no puedes acceder al panel, edita la base de datos desde phpMyAdmin (en Syspanel). Busca la tabla ps_configuration y cambia el valor de PS_SHOP_ENABLE a 1.

Preguntas frecuentes (FAQ)

¿Por qué veo una página en blanco después de instalar un módulo?

Es muy probable que el módulo no sea compatible con tu versión de PrestaShop o de PHP. Prueba a desactivarlo renombrando la carpeta del módulo en /modules.

¿Cómo sé qué versión de PHP tengo?

Puedes crear un archivo llamado info.php en la raíz de tu hosting con el contenido <?php phpinfo(); ?>. Luego accede a tudominio.com/info.php y busca la línea "PHP Version". Borra este archivo después por seguridad.

¿Puedo instalar PrestaShop en un subdominio?

Sí, perfectamente. Solo asegúrate de que la base de datos y los permisos estén bien configurados para esa carpeta.

¿Qué hago si el error persiste después de todo?

Contacta con el soporte técnico de tu hosting. Ellos pueden revisar los logs del servidor y ayudarte a identificar el problema. Recuerda tener a mano los pasos que ya intentaste.

Resumen rápido de pasos para solucionar errores comunes

Pantalla blanca: Activa modo debug, aumenta memoria PHP, desactiva módulos.
Error de base de datos: Verifica datos, crea base desde Syspanel, edita parameters.php.
Permisos: Pon 755 a carpetas, 644 a archivos, verifica propietario.
Versión PHP: Cambia a la recomendada desde Syspanel.
Límite de memoria: Aumenta vía .htaccess o panel de hosting.
Modo mantenimiento: Desactívalo desde el panel admin o base de datos.

[INFO] Si tu hosting usa Syspanel, recuerda que el acceso es por el puerto 2106. Ahí puedes gestionar bases de datos, PHP, archivos y permisos de forma sencilla.

Espero que esta guía te haya ayudado a resolver esos molestos errores de instalación de PrestaShop. Recuerda que la paciencia es clave, y si algo no funciona, siempre puedes pedir ayuda a tu equipo de soporte. ¡Ánimo con tu tienda online!