Errores comunes en PrestaShop y cómo solucionarlos

Montar una tienda online con PrestaShop es un paso emocionante, pero a veces el camino se llena de obstáculos justo en el momento de la instalación. Ver una pantalla en blanco, un error de base de datos o un mensaje de "archivo no encontrado" puede ser frustrante, sobre todo si no tienes experiencia técnica.

No te preocupes. En esta guía extensa y detallada vamos a resolver los errores comunes de instalación en PrestaShop paso a paso. Al final, tendrás un mapa claro para solucionar los problemas más típicos y poner tu tienda online en marcha sin dolores de cabeza.

Por qué ocurren los errores de instalación en PrestaShop

Antes de meternos en soluciones concretas, es útil entender el origen de la mayoría de los fallos. PrestaShop es un software potente, pero necesita un entorno específico para funcionar. Los errores suelen aparecer por tres razones principales:

Requisitos del servidor no cumplidos: versión de PHP incorrecta, falta de extensiones, memoria insuficiente.
Configuración incorrecta de archivos: permisos de archivos mal asignados o rutas equivocadas.
Problemas con la base de datos: nombre de usuario, contraseña o privilegios erróneos.

Conocer estas causas te ayudará a diagnosticar más rápido. Vamos a ver los errores más frecuentes y cómo solucionarlos.

Error 1: Pantalla en blanco o “Error 500 Internal Server Error”

Este es, sin duda, el error más temido. Ves una página completamente blanca o un mensaje genérico de error del servidor. La causa principal suele ser un límite de memoria PHP insuficiente o un archivo .htaccess corrupto.

Solución paso a paso

Aumenta el límite de memoria PHP. Accede al panel de control de tu hosting (por ejemplo, Syspanel en el puerto 2106) y busca la sección de "PHP Settings" o "Configuración de PHP". Cambia el valor de memory_limit a al menos 256M. Si no tienes acceso, edita el archivo php.ini o solicita a tu proveedor que lo haga.
Verifica el archivo .htaccess. A veces, durante la instalación, este archivo se genera con errores. Conéctate por FTP o desde el administrador de archivos de tu panel (como Syspanel) y renombra el archivo .htaccess a .htaccess_old. Luego, intenta acceder de nuevo a la instalación. Si funciona, PrestaShop lo regenerará correctamente.
Revisa los logs del servidor. Si el error persiste, busca el archivo error.log en la carpeta raíz de tu hosting. Allí verás mensajes más detallados sobre el fallo exacto.

[TIP] Si usas Syspanel, puedes encontrar los logs en la sección "Registros del sistema" o "Logs". El acceso es por el puerto 2106.

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

Durante el asistente de instalación, PrestaShop te pide los datos de tu base de datos. Si ves este mensaje, es porque las credenciales son incorrectas o el usuario no tiene permisos suficientes.

Solución paso a paso

Crea una nueva base de datos y un usuario. Desde tu panel de control (por ejemplo, Syspanel en el puerto 2106), ve a "Bases de datos" o "MySQL". Crea una nueva base de datos con un nombre sencillo (ej: tienda_prestashop). Luego, crea un usuario y asígnale todos los privilegios sobre esa base de datos.
Verifica los datos en el instalador. Asegúrate de copiar exactamente:
- Nombre de la base de datos: el que acabas de crear.
- Usuario: el nombre del usuario que creaste.
- Contraseña: la que asignaste (sin espacios extra).
- Servidor de base de datos: normalmente localhost. Si tu hosting usa un servidor remoto, te lo indicarán.
Prueba la conexión manualmente. Si tienes acceso a phpMyAdmin (desde Syspanel), intenta iniciar sesión con esas mismas credenciales. Si no puedes, el problema está en los datos, no en PrestaShop.

[WARNING] No uses el usuario root de la base de datos. Es inseguro y muchos hostings lo bloquean para instalaciones web. Crea siempre un usuario específico para tu tienda.

Error 3: “El directorio no tiene permisos de escritura”

PrestaShop necesita poder escribir en ciertas carpetas para funcionar (como config, cache, img, upload). Si ves este error, los permisos de archivos no están bien configurados.

Solución paso a paso

Conéctate por FTP o al administrador de archivos. Desde tu panel (como Syspanel), abre el gestor de archivos.
Cambia los permisos a 755 para carpetas y 644 para archivos. Haz clic derecho sobre la carpeta raíz de PrestaShop y selecciona "Cambiar permisos". Marca:
- Propietario: Lectura, escritura y ejecución.
- Grupo: Lectura y ejecución.
- Otros: Lectura y ejecución.
  Esto se traduce en el código 755 para carpetas. Para archivos individuales, usa 644.
Recursividad: Asegúrate de aplicar los cambios a todas las subcarpetas y archivos (opción "Aplicar a subdirectorios" o "Recursivo").

[INFO] No uses permisos 777 (todos los permisos para todos). Aunque a veces funciona, es un grave riesgo de seguridad. Con 755 es suficiente.

Error 4: “Versión de PHP no compatible”

PrestaShop requiere una versión específica de PHP. Si tu servidor tiene una versión demasiado antigua o demasiado nueva, la instalación se detendrá.

Solución paso a paso

Consulta la versión de PHP de tu servidor. Desde Syspanel (puerto 2106), busca "PHP Version" o "PHP Settings". Verás la versión actual.
Cambia la versión de PHP. La mayoría de los paneles permiten seleccionar la versión por dominio. Para PrestaShop 8.x, necesitas PHP 8.0 o 8.1. Para versiones anteriores, PHP 7.4 puede ser suficiente. Selecciona la adecuada y guarda los cambios.
Verifica las extensiones necesarias. Además de la versión, PrestaShop necesita extensiones como mysqli, gd, curl, mbstring, openssl, pdo_mysql, zip, xml, json. Desde la misma sección de PHP, asegúrate de que estén habilitadas.

[TIP] Si no ves la opción de cambiar PHP, contacta con tu proveedor de hosting. Muchos ofrecen soporte gratuito para esto.

Error 5: “Archivo de instalación no encontrado” o “404 Not Found”

Este error suele ocurrir cuando los archivos de PrestaShop no se han subido correctamente a la carpeta raíz del dominio o cuando el dominio no apunta a la carpeta correcta.

Solución paso a paso

Verifica la ubicación de los archivos. Asegúrate de que has subido el contenido de la carpeta prestashop (después de descomprimir) directamente a la carpeta public_html o www de tu hosting. No debe haber una subcarpeta extra.
Comprueba el nombre del dominio. Si tu dominio es mitienda.com, los archivos deben estar en la carpeta que apunta a ese dominio. Desde Syspanel, revisa la sección "Dominios" para confirmar la ruta correcta.
Borra el caché del navegador. A veces el navegador guarda una versión antigua. Prueba en modo incógnito o con otro navegador.

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

La instalación de PrestaShop puede ser pesada, especialmente si tu servidor tiene recursos limitados. Si ves un error de tiempo de espera, el proceso se está alargando demasiado.

Solución paso a paso

Aumenta el tiempo máximo de ejecución de PHP. En la configuración de PHP (desde Syspanel), busca max_execution_time y cámbialo a 300 (5 minutos).
Aumenta la memoria PHP. Como en el Error 1, sube memory_limit a 256M o 512M.
Desactiva temporalmente plugins de seguridad. Algunos plugins de firewall o seguridad de tu hosting pueden ralentizar la instalación. Si es posible, desactívalos durante el proceso y luego vuelve a activarlos.

Error 7: “El nombre de la tienda ya está en uso” o “Error de licencia”

Aunque menos común, a veces PrestaShop muestra errores relacionados con el nombre de la tienda o la licencia, especialmente si intentas reinstalar sobre una instalación anterior.

Solución paso a paso

Borra la base de datos anterior. Desde Syspanel, ve a "Bases de datos" y elimina la base de datos que usaste en la instalación anterior. Luego crea una nueva con el mismo nombre o uno diferente.
Elimina la carpeta de instalación anterior. Si ya habías subido archivos, bórralos todos y vuelve a subir el paquete limpio de PrestaShop.
Usa un nombre de tienda diferente. Durante la instalación, cambia ligeramente el nombre (ej: "Mi Tienda Online 2") para evitar conflictos.

Error 8: Problemas con el certificado SSL (https)

Si intentas instalar PrestaShop en un dominio con HTTPS pero el certificado SSL está mal configurado, pueden aparecer errores de conexión segura.

Solución paso a paso

Verifica que el SSL esté activo. Desde Syspanel, busca "SSL/TLS" o "Certificados". Asegúrate de que tu dominio tenga un certificado válido y esté forzado a HTTPS.
Instala PrestaShop sin SSL primero. Si tienes problemas, realiza la instalación usando http:// (sin la s). Una vez terminada, puedes forzar HTTPS desde el panel de administración de PrestaShop.
Configura correctamente la URL. En el instalador, en el campo "URL de la tienda", escribe exactamente la dirección con https:// si tu SSL funciona.

Error 9: “No se puede escribir en el archivo de configuración”

Este error es similar al de permisos, pero específico para el archivo settings.inc.php (o parameters.php en versiones nuevas).

Solución paso a paso

Localiza el archivo. Está en la carpeta config de tu instalación de PrestaShop.
Cambia los permisos temporalmente. Dale permisos 777 al archivo parameters.php (o settings.inc.php). Luego, ejecuta la instalación. Una vez termine, revierte a 644 o 755.
Crea el archivo manualmente. Si el instalador no puede crearlo, puedes copiar el contenido de ejemplo que proporciona PrestaShop y pegarlo en un archivo nuevo con el mismo nombre. Luego súbelo por FTP.

[WARNING] Recuerda siempre devolver los permisos a un nivel seguro después de la instalación. Dejar archivos con permisos 777 es una puerta abierta para hackers.

Error 10: Problemas al descomprimir el archivo de PrestaShop

A veces, al subir el archivo ZIP de PrestaShop y descomprimirlo en el servidor, aparecen errores de archivos corruptos o faltantes.

Solución paso a paso

Descomprime en tu computadora primero. Descarga el ZIP oficial de PrestaShop, descomprímelo en tu PC y luego sube la carpeta resultante por FTP o usando el gestor de archivos de Syspanel.
Usa un cliente FTP confiable. FileZilla o Cyberduck son buenas opciones. Asegúrate de que la transferencia sea en modo binario.
Verifica la integridad del archivo. Si sospechas que el ZIP está dañado, descárgalo de nuevo desde el sitio oficial de PrestaShop.

Preguntas Frecuentes (FAQ)

¿Puedo instalar PrestaShop en un hosting compartido?

Sí, siempre que cumpla con los requisitos mínimos (PHP 7.4+, MySQL 5.6+). Muchos hostings compartidos ofrecen soporte para PrestaShop.

¿Qué hago si no tengo acceso a Syspanel?

Si tu proveedor no usa Syspanel, pide acceso a cPanel, Plesk o cualquier otro panel. Los pasos son similares. Si no tienes panel, deberás usar FTP y editar archivos manualmente.

¿Es necesario tener conocimientos técnicos para instalar PrestaShop?

No, pero ayuda tener nociones básicas de FTP y bases de datos. Esta guía está diseñada para que cualquier persona pueda seguirla.

¿Puedo instalar PrestaShop localmente y luego subirlo?

Sí, es posible, pero es más complejo. Debes ajustar las rutas y la base de datos. Para principiantes, recomendamos la instalación directa en el servidor.

¿Cómo sé qué versión de PrestaShop instalar?

Descarga siempre la última versión estable desde el sitio oficial. Las versiones antiguas pueden tener problemas de seguridad.

¿Qué hago si después de todo sigue sin funcionar?

Contacta con el soporte técnico de tu hosting. Ellos pueden revisar los logs del servidor y ajustar configuraciones que tú no puedas modificar.

Consejos finales para una instalación exitosa

Haz una copia de seguridad de tu sitio antes de empezar, por si algo sale mal.
Lee los requisitos del sistema en la web oficial de PrestaShop antes de instalar.
Usa un subdominio para pruebas (ej: test.mitienda.com) antes de instalar en el dominio principal.
No te saltes pasos. Cada paso del asistente de instalación es importante.

[INFO] Recuerda que Syspanel es la herramienta de gestión de tu hosting. Accede desde https://tudominio:2106 para gestionar bases de datos, archivos y configuraciones PHP.

Con esta guía, los errores comunes de instalación en PrestaShop ya no serán un misterio. Sigue los pasos con calma, verifica cada punto y pronto tendrás tu tienda online funcionando. Si te encuentras con un error no listado aquí, no dudes en buscar en foros especializados o en la comunidad de PrestaShop. ¡Buena suerte con tu tienda!