Errores comunes en PrestaShop por hosting: soluciones | FAQ

Si estás gestionando una tienda online con PrestaShop, es probable que en algún momento te hayas encontrado con algún error que te ha impedido trabajar con normalidad. Muchos de estos problemas no son culpa del software en sí, sino que están relacionados con la configuración de tu servidor o con los recursos que tu plan de hosting te ofrece. En esta guía extensa y fácil de seguir, vamos a desglosar los errores más habituales, sus causas y, lo más importante, cómo solucionarlos paso a paso. Al final, también encontrarás una sección de preguntas frecuentes (FAQ) que te ayudará a resolver dudas concretas.

¿Por qué ocurren errores en PrestaShop relacionados con el hosting?

PrestaShop es un CMS (sistema de gestión de contenidos) muy potente y completo, pero también es bastante exigente en cuanto a recursos del servidor. Un error en la configuración del hosting, una versión de PHP incorrecta, un límite de memoria demasiado bajo o un problema con los permisos de archivos pueden provocar desde una página en blanco hasta la imposibilidad de acceder al panel de administración.

[INFO] Antes de empezar con las soluciones, te recomendamos hacer una copia de seguridad completa de tu tienda (archivos y base de datos). Así, si algo sale mal, podrás restaurar todo rápidamente.

Error 500 – Internal Server Error (Error interno del servidor)

Este es, sin duda, uno de los errores más frustrantes porque no da ninguna pista visual sobre qué está fallando. Aparece una pantalla en blanco o un mensaje genérico.

Causas principales

Archivo .htaccess corrupto o mal configurado.
Módulo de PrestaShop incompatible o defectuoso.
Límite de memoria PHP (memory_limit) demasiado bajo.
Permisos de archivos o carpetas incorrectos.

Solución paso a paso

Desactiva el modo amigable de URLs (temporalmente). Accede a tu panel de control de hosting (por ejemplo, cPanel o Syspanel, este último accesible por el puerto 2106). Renombra el archivo .htaccess a .htaccess_old para desactivarlo. Si el error desaparece, el problema está en ese archivo. Puedes regenerarlo desde el back office de PrestaShop (Parámetros de la tienda > Tráfico y SEO > URLs amigables).
Aumenta el límite de memoria PHP. Desde el panel de control de tu hosting, busca la opción "Select PHP Version" o "Configuración de PHP". Allí podrás modificar el valor de memory_limit. Recomendamos un mínimo de 128M y, para tiendas con muchos módulos o catálogos grandes, 256M o 512M.
Desactiva módulos uno por uno. Si el error apareció después de instalar un módulo, conéctate por FTP a tu servidor y renombra la carpeta del módulo sospechoso (dentro de /modules/). Por ejemplo, cambia micromodulo a micromodulo_old. Si el error se soluciona, el módulo es el culpable.
Verifica los permisos de archivos. Los archivos deben tener permiso 644 y las carpetas 755. Puedes usar un cliente FTP como FileZilla para revisar y corregir estos valores de forma masiva.

Error de conexión a la base de datos

Este error impide que la tienda cargue, mostrando un mensaje como "Cannot connect to database" o "Error de conexión a la base de datos".

Causas principales

Credenciales de la base de datos incorrectas en el archivo app/config/parameters.php.
La base de datos ha superado el límite de tamaño permitido por el hosting.
El servidor de base de datos (MySQL/MariaDB) está caído o sobrecargado.

Solución paso a paso

Revisa el archivo de configuración. Conéctate por FTP y abre el archivo app/config/parameters.php. Busca las líneas database_host, database_name, database_user y database_password. Verifica que coincidan exactamente con los datos que te proporcionó tu proveedor de hosting.
Comprueba el tamaño de la base de datos. Accede a phpMyAdmin desde tu panel de control (Syspanel o cPanel). Selecciona tu base de datos y mira el tamaño en la parte inferior. Si está cerca del límite de tu plan, tendrás que optimizarla (borrando logs, carritos abandonados antiguos, etc.) o contratar más espacio.
Reinicia el servicio de MySQL. Si tienes acceso a la gestión del servidor (por ejemplo, en un VPS), puedes reiniciar el servicio desde la terminal con sudo systemctl restart mysql. En hosting compartido, contacta con el soporte técnico.

[WARNING] No modifiques el archivo parameters.php con un editor de texto básico como el Bloc de notas. Usa un editor con codificación UTF-8 sin BOM, como Notepad++ o VS Code, para evitar caracteres extraños.

Pantalla blanca de la muerte (White Screen of Death – WSOD)

La tienda carga, pero no se ve nada, solo un fondo blanco. No hay mensajes de error visibles.

Causas principales

Error de PHP silencioso (suelen ser errores de sintaxis o de memoria).
Tema o plantilla incompatible.
Módulo que genera un error fatal.

Solución paso a paso

Habilita la visualización de errores de PHP. Temporalmente, puedes forzar a PrestaShop a mostrar los errores. Edita el archivo config/defines.inc.php y cambia la línea define('_PS_MODE_DEV_', false); a define('_PS_MODE_DEV_', true);. Esto mostrará los errores en la pantalla, dándote una pista.
Aumenta la memoria PHP (como en el error 500). A veces, la pantalla blanca es simplemente falta de memoria.
Cambia temporalmente al tema por defecto. Por FTP, renombra la carpeta de tu tema activo (dentro de /themes/) a tema_old. PrestaShop usará entonces el tema predeterminado. Si la tienda vuelve a funcionar, el problema es de tu plantilla.

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

Este error es muy común y aparece cuando un script de PrestaShop (por ejemplo, al generar un PDF, importar productos o ejecutar un módulo) intenta usar más memoria de la que el servidor le permite.

Solución paso a paso

Aumenta el límite de memoria PHP. Como ya hemos mencionado, este es el primer paso. Ve a la configuración de PHP en tu panel de control y sube el valor de memory_limit a 256M o 512M.
Aumenta el límite de memoria solo para PrestaShop. Si no puedes modificar la configuración global de PHP, puedes crear un archivo php.ini en la raíz de tu tienda con el siguiente contenido:
```
memory_limit = 256M
max_execution_time = 120
```
Optimiza los procesos pesados. Si el error ocurre al importar un CSV muy grande, prueba a dividir el archivo en partes más pequeñas. Si es al generar facturas, reduce la cantidad de facturas que generas a la vez.

Errores al instalar o actualizar módulos

A veces, al instalar un módulo desde el back office, aparece un error de "No se puede escribir en el directorio" o "Fallo en la descarga".

Causas principales

Permisos de escritura incorrectos en la carpeta /modules/.
Falta de espacio en disco en el servidor.
La función allow_url_fopen está deshabilitada en el servidor.

Solución paso a paso

Corrige los permisos de la carpeta /modules/. Debe tener permiso 755. Si es necesario, dale también permiso de escritura al usuario del servidor web (777 de forma temporal, pero nunca lo dejes así por seguridad).
Verifica el espacio en disco. Desde tu panel de control, revisa el uso del disco. Si está al 100%, tendrás que liberar espacio (borrando backups antiguos, logs, etc.) o ampliar tu plan.
Habilita allow_url_fopen. Esta función permite a PHP descargar archivos desde URLs externas. En la configuración de PHP de tu hosting, busca esta opción y actívala. Si no aparece, contacta con el soporte.

Preguntas Frecuentes (FAQ)

Aquí tienes las respuestas a las dudas más comunes que recibimos en soporte técnico sobre PrestaShop y hosting.

¿Por qué mi tienda PrestaShop va muy lenta?

La lentitud puede deberse a varias razones: un hosting de baja calidad (compartido y saturado), módulos mal optimizados, imágenes sin comprimir, falta de uso de caché o una base de datos desordenada. Te recomendamos:

Activar la caché de PrestaShop (CCC para CSS, JavaScript y HTML).
Usar un CDN (Red de Entrega de Contenido).
Comprimir las imágenes antes de subirlas.
Revisar los módulos instalados y desactivar los que no uses.
Contratar un hosting específico para PrestaShop o un VPS.

¿Cómo sé si mi hosting es compatible con PrestaShop?

PrestaShop 8.x (la versión más reciente) requiere como mínimo:

PHP 8.1 o superior.
MySQL 5.7+ o MariaDB 10.2+.
Apache 2.4+ o Nginx.
256 MB de memoria PHP como mínimo.
Soporte para las extensiones de PHP: curl, gd, json, mbstring, openssl, pdo_mysql, zip, xml.

Puedes verificar estos requisitos desde el back office de tu tienda en "Parámetros de la tienda > Información".

¿Qué hago si no puedo acceder al back office de PrestaShop?

Si el error es de "redirección infinita" o "demasiadas redirecciones", suele ser un problema con las URLs amigables o con el archivo .htaccess. Renombra el .htaccess y vuelve a intentarlo. Si no puedes ni siquiera ver la pantalla de login, prueba a acceder directamente a tudominio.com/adminXXX/index.php (sustituye adminXXX por la carpeta real de tu administración). Si el problema persiste, revisa los logs de error del servidor.

¿Cómo accedo a Syspanel para gestionar mi hosting?

Syspanel es el panel de control que utilizamos para la gestión de servidores. Para acceder, abre tu navegador y escribe la dirección IP de tu servidor seguida de dos puntos y el puerto 2106. Por ejemplo: http://192.168.1.1:2106. Allí podrás gestionar tus bases de datos, dominios, archivos y configuraciones de PHP.

[TIP] Si no recuerdas la IP de tu servidor, puedes encontrarla en el correo de bienvenida que te enviamos al contratar el servicio o consultando con nuestro equipo de soporte.

¿Cómo hago una copia de seguridad de mi tienda PrestaShop?

Desde el panel de control de tu hosting (Syspanel o cPanel) puedes hacer una copia de seguridad completa de los archivos y la base de datos. También puedes hacerlo manualmente:

Archivos: Conéctate por FTP y descarga toda la carpeta de tu tienda.
Base de datos: Accede a phpMyAdmin, selecciona tu base de datos y haz clic en "Exportar". Elige el formato SQL y descarga el archivo.

¿Por qué al actualizar PrestaShop se me rompe la tienda?

Las actualizaciones mayores de PrestaShop (por ejemplo, de la 1.6 a la 1.7, o de la 1.7 a la 8.x) requieren una migración cuidadosa. Los temas y módulos antiguos suelen ser incompatibles. Siempre:

Haz una copia de seguridad completa antes de actualizar.
Prueba la actualización en un entorno de pruebas (subdominio o local) primero.
Actualiza todos los módulos y el tema a sus versiones más recientes antes de actualizar el núcleo de PrestaShop.

Esperamos que esta guía te haya sido de gran ayuda. Recuerda que la mayoría de los errores de PrestaShop tienen solución y, con un hosting adecuado y un mantenimiento básico, tu tienda funcionará de forma estable y rápida. Si después de seguir estos pasos el problema persiste, no dudes en contactar con nuestro equipo de soporte técnico; estaremos encantados de ayudarte a diagnosticar y resolver cualquier incidencia.