🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Errores comunes de PrestaShop al instalar y cómo solucionarlos

Actualizado el 23 de marzo de 2026

¡Bienvenido al fascinante (y a veces frustrante) mundo de PrestaShop!

Si estás leyendo esto, seguramente estás en pleno proceso de instalación de tu tienda online y te has topado con algún que otro obstáculo. No te preocupes, es más común de lo que crees. Instalar PrestaShop puede parecer sencillo, pero a menudo surgen errores prestashop que desaniman hasta al más valiente.

En esta guía extensa y práctica, vamos a desglosar los errores de instalación de PrestaShop más frecuentes, explicando por qué ocurren y, lo más importante, cómo solucionar PrestaShop paso a paso. Olvídate del pánico, coge aire y vamos a ello. Al final, tendrás tu tienda funcionando.

1. El temido "Error 500" o "Error interno del servidor"

Este es, sin duda, el prestashop 500 error más buscado en Google. Aparece de repente, sin un mensaje claro, y puede ocurrir tanto durante la instalación como al intentar acceder al panel de administración. Es la pesadilla de cualquier usuario.

¿Qué significa exactamente?

El error 500 es un error genérico del servidor. Es la forma que tiene el servidor de decir: "Algo ha ido muy mal, pero no te voy a dar detalles". Las causas más comunes son:

  • Permisos de archivos incorrectos: PrestaShop necesita escribir en ciertos archivos y carpetas. Si no tiene permiso, falla.
  • Archivos corruptos o incompletos: Una subida de archivos por FTP que se interrumpió puede dejar archivos a medias.
  • Problemas con el archivo .htaccess: Este archivo de configuración es vital. Si está mal configurado, todo se rompe.
  • Límite de memoria PHP agotado: La instalación requiere un mínimo de memoria. Si tu servidor tiene un límite muy bajo, el proceso muere.

Solución paso a paso para el error 500

  1. Activa el modo de depuración (Debug Mode): Es la única forma de ver el error real. Accede al archivo config/defines.inc.php de tu instalación de PrestaShop. Busca la línea:
    define('_PS_MODE_DEV_', false);
    Cámbiala a:
    define('_PS_MODE_DEV_', true);
    Guarda el archivo y recarga la página. Ahora verás un mensaje de error específico (por ejemplo, "Fatal error: Allowed memory size...").

  2. Revisa los permisos de archivos (CHMOD): Usa tu gestor de archivos de cPanel o un cliente FTP (como FileZilla). Los archivos deben tener permiso 644 y las carpetas 755. Una forma rápida es seleccionar todas las carpetas y archivos y asignar estos valores. Si usas Syspanel (paneles como HestiaCP, cuyo acceso es por el puerto 2106), busca la opción "Permisos de archivos" dentro del gestor de archivos.

  3. Regenera el archivo .htaccess: Si el error persiste y puedes acceder al panel de administración, ve a Parámetros Avanzados > Rendimiento y pulsa el botón "Regenerar" junto al archivo .htaccess. Si no puedes acceder, tendrás que borrar el archivo .htaccess del directorio raíz de tu instalación (haz una copia de seguridad antes) y volver a intentarlo. PrestaShop lo regenerará automáticamente.

  4. Aumenta el límite de memoria PHP: Este es un clásico. Debes editar el archivo php.ini de tu servidor. Si no sabes dónde está, en cPanel o Syspanel suele haber una opción llamada "Select PHP Version" o "Configuración de PHP". Busca la línea memory_limit y cámbiala a memory_limit = 512M. También puedes crear un archivo llamado php.ini en la raíz de tu PrestaShop con ese contenido.

[TIP] Antes de nada, verifica que tu hosting cumple con los requisitos mínimos de PrestaShop: PHP 7.4 o superior, MySQL 5.6 o superior y al menos 256MB de memoria.

2. Errores de conexión con la base de datos

Durante el asistente de instalación, uno de los pasos más críticos es la configuración de la base de datos. Aquí es donde muchos usuarios tropiezan.

El error "No se puede conectar a la base de datos"

Este mensaje es muy claro, pero el origen puede variar. Normalmente se debe a datos incorrectos en el formulario.

Cómo solucionarlo

  1. Verifica el nombre del servidor de la base de datos: Normalmente es localhost, pero en muchos hostings gestionados (como los que usan Syspanel), el servidor de base de datos tiene un nombre diferente, como localhost o algo similar a mysql.tudominio.com. Revisa el correo de bienvenida de tu hosting o el panel de control de la base de datos.

  2. Comprueba el usuario y la contraseña: Asegúrate de que estás usando el usuario correcto y que la contraseña no tiene espacios. Es muy fácil copiar un espacio sin querer.

  3. Prefijo de tablas: Si ya has intentado instalar antes, es posible que las tablas existan. Cambia el prefijo en el campo "Prefijo de tablas" (por ejemplo, de ps_ a shop_) para evitar conflictos.

  4. Permisos del usuario de la base de datos: El usuario de la base de datos debe tener todos los privilegios sobre la base de datos que has creado. En phpMyAdmin, puedes editar el usuario y marcar la casilla "Marcar todos" para darle todos los permisos.

[WARNING] Si usas Syspanel (puerto 2106), asegúrate de haber creado la base de datos y el usuario desde el panel antes de iniciar la instalación de PrestaShop. No se crean automáticamente.

3. Problemas con la subida de archivos: "La carpeta no es escribible" o "No se puede crear el archivo"

Este error es muy común en instalaciones manuales. PrestaShop necesita crear archivos de caché, registros y archivos de configuración. Si las carpetas no tienen los permisos adecuados, el proceso se detiene.

¿Por qué ocurre?

Los servidores Linux son estrictos con los permisos. Si has subido los archivos con un usuario de FTP distinto al usuario del servidor web (normalmente www-data o nobody), el servidor web no podrá escribir en esas carpetas.

Solución definitiva

  1. Conecta por FTP con tu cliente favorito.
  2. Selecciona todas las carpetas en el directorio raíz de PrestaShop (donde subiste los archivos).
  3. Haz clic derecho y selecciona "Atributos del archivo" o "Permisos".
  4. Introduce el valor 755 para las carpetas y 644 para los archivos.
  5. Asegúrate de marcar la casilla "Recursivo" o "Aplicar a todos los archivos y subcarpetas".

![Icono de advertencia] Si el error persiste, es posible que tu hosting tenga activado PHP-FPM con un usuario específico. En ese caso, lo más sencillo es contactar con el soporte de tu hosting y pedirles que asignen el propietario correcto a los archivos (por ejemplo, chown -R www-data:www-data /ruta/a/prestashop). Si usas Syspanel, esta opción suele estar en la sección de "Archivos" o "Administrador de archivos" del plan.

4. El error de "La tienda está en modo de mantenimiento" o "No se puede cargar la página de inicio"

Después de una instalación supuestamente exitosa, a veces la tienda muestra una página en blanco o un mensaje de mantenimiento, pero el panel de administración funciona bien.

La causa raíz

Esto suele deberse a un problema con las URLs amigables o con la configuración de la tienda en la base de datos. La tienda intenta redirigir a una URL que no existe o que está mal configurada.

Pasos para arreglarlo

  1. Accede al panel de administración (tu-dominio.com/adminXXXX).
  2. Ve a Parámetros Avanzados > Rendimiento.
  3. En la sección "URL amigable", asegúrate de que está desactivada temporalmente. Guarda los cambios.
  4. Ahora intenta acceder a la tienda. Si funciona, el problema era la URL amigable.
  5. Vuelve a activarla y ve a Parámetros Avanzados > Parámetros Generales.
  6. Comprueba que la "URL de la tienda" es correcta (debe ser http://tudominio.com o https://tudominio.com, sin barras al final).
  7. Guarda los cambios. PrestaShop debería regenerar el .htaccess automáticamente.

[TIP] Si no puedes acceder al panel, prueba a entrar directamente a /adminXXXX/index.php. A veces la redirección falla, pero el archivo index.php funciona.

5. El error "La instalación no puede continuar: la extensión PHP ... no está cargada"

PrestaShop es exigente con las extensiones de PHP. Si una extensión necesaria no está instalada o activada en tu servidor, la instalación se detendrá en los primeros pasos.

¿Qué extensiones necesito?

Las más comunes que suelen faltar son:

  • curl (para conexiones externas, pagos, etc.)
  • gd (para procesar imágenes)
  • mbstring (para soporte de caracteres y acentos)
  • openssl (para seguridad y SSL)
  • fileinfo (para subir archivos)
  • zip (para importar/exportar temas y módulos)

Cómo solucionarlo

La solución depende de tu hosting:

  1. Si usas cPanel o Syspanel (puerto 2106): Busca la sección "Select PHP Version" o "Administrador de PHP". Verás una lista de extensiones con casillas de verificación. Marca todas las que necesitas y guarda los cambios.

  2. Si tienes un VPS o hosting dedicado: Tendrás que instalar las extensiones manualmente. Por ejemplo, en un sistema basado en Ubuntu/Debian, usarías comandos como:
    sudo apt-get install php-curl php-gd php-mbstring php-zip
    Y luego reiniciarías el servidor web con sudo service apache2 restart o sudo systemctl restart nginx.

  3. Si estás en un hosting compartido y no ves la opción: Contacta con el soporte técnico. Ellos podrán activar las extensiones por ti.

6. Problemas con la versión de PHP: "Tu versión de PHP es demasiado antigua"

PrestaShop 8 y versiones superiores requieren PHP 7.4 o superior (idealmente PHP 8.0+). Si tu servidor tiene una versión anterior, la instalación se negará a continuar.

La solución es simple: actualizar PHP

  1. Accede al panel de control de tu hosting (cPanel, Syspanel, Plesk, etc.).
  2. Busca la herramienta de "Select PHP Version" o similar.
  3. Elige la versión más reciente y estable de PHP (por ejemplo, 8.1 o 8.2).
  4. Guarda los cambios.

[WARNING] Antes de cambiar la versión de PHP de un sitio existente, asegúrate de que tus módulos y temas son compatibles. En un sitio nuevo, es totalmente seguro usar la última versión estable.

7. Preguntas Frecuentes (FAQ) sobre errores de PrestaShop

Para finalizar, aquí tienes una recopilación de dudas rápidas que suelen tener los usuarios.

¿Por qué me sale "Error de conexión: no se pudo conectar a la base de datos" si mis datos son correctos?

Esto puede deberse a que el servidor de la base de datos no es localhost. Si usas Syspanel, el nombre del servidor suele ser localhost pero con un puerto específico, o una dirección como 127.0.0.1. Revisa la documentación de tu hosting. A veces el problema es que el usuario de la base de datos solo tiene permisos para conectarse desde localhost y no desde la IP de tu servidor web.

¿Cómo puedo ver el error exacto en lugar de un error 500?

Como mencionamos antes, activa el modo de depuración en config/defines.inc.php. Cambia _PS_MODE_DEV_ a true. Esto mostrará los errores PHP en pantalla, lo que te dará una pista precisa.

¿Qué hago si he borrado el archivo .htaccess y ahora no tengo acceso a nada?

No pasa nada. PrestaShop puede regenerarlo. Simplemente intenta acceder a tu panel de administración (/adminXXXX). Si funciona, ve a Parámetros Avanzados > Rendimiento y pulsa el botón para regenerar el .htaccess. Si no funciona, contacta con tu hosting para restaurar una copia de seguridad o crea un archivo .htaccess en blanco con permisos 644 en la raíz. Eso debería permitir que PrestaShop lo reescriba.

Después de mover mi tienda a otro servidor, solo veo una página en blanco. ¿Qué hago?

Este es un error común. Primero, activa el modo de depuración (como en el punto 1). Si el error es de conexión a la base de datos, edita el archivo app/config/parameters.php y verifica que los datos de conexión (host, usuario, contraseña, nombre de BD) son correctos para el nuevo servidor.

¿Es normal que la instalación tarde tanto?

Sí, puede tardar varios minutos, especialmente si tu servidor es lento o tienes una conexión a internet limitada. No cierres la pestaña del navegador ni interrumpas el proceso. Si ves que se queda congelado más de 10 minutos, es probable que haya un error de memoria o de permisos.

Conclusión

Enfrentarse a errores prestashop durante la instalación es un rito de iniciación para muchos emprendedores digitales. La clave está en la paciencia y en saber interpretar los mensajes (o activar el modo de depuración para verlos). Hemos cubierto los fallos más comunes, desde el famoso prestashop 500 error hasta los problemas de conexión con la base de datos y los permisos de archivos.

Recuerda que la mayoría de estos errores no son fatales y tienen una solución clara. Si después de seguir estos pasos sigues atascado, te recomiendo contactar con el soporte técnico de tu proveedor de hosting. Ellos conocen su infraestructura y pueden ayudarte a solucionar PrestaShop de forma más directa, especialmente si usas paneles como Syspanel (recuerda, el acceso es por el puerto 2106 y su soporte suele ser muy eficiente).

Espero que esta guía te haya sido de gran ayuda. Con un poco de perseverancia, tu tienda online estará operativa y lista para vender. ¡Mucha suerte con tu proyecto!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel