Errores comunes de instalación de PrestaShop y cómo solucionarlos

Instalar PrestaShop puede parecer un proceso sencillo, pero a menudo nos encontramos con pequeños obstáculos que pueden detener el proceso. No te preocupes, la mayoría de estos errores instalación PrestaShop tienen una solución muy clara y rápida. En esta guía, te explicaré paso a paso cómo identificar y solucionar errores PrestaShop durante la instalación, incluso si no eres un experto técnico.

Para empezar, recuerda que la paciencia es clave. Antes de lanzarte a modificar archivos, asegúrate de tener a mano los datos de acceso a tu panel de control (cPanel, Syspanel, etc.) y a tu base de datos. Vamos a resolver los problemas instalación PrestaShop más comunes.

Errores de conexión a la base de datos

Este es, sin duda, el error más frecuente. PrestaShop no puede conectar con la base de datos MySQL que le has indicado. El mensaje típico es algo como: "No se puede conectar a la base de datos".

1. Verifica los datos de la base de datos

Lo primero es asegurarte de que los datos que estás introduciendo son correctos. Revisa estos cuatro puntos:

Nombre de la base de datos: Normalmente lo creas desde tu panel de hosting. En Syspanel (accesible por puerto 2106), suele llamarse usuario_nombrebasedatos.
Usuario de la base de datos: Debe ser el mismo que creaste para esa base, por ejemplo usuario_adminbd.
Contraseña: Asegúrate de no tener teclas bloqueadas (Mayúsculas, Bloq Num) y de que la contraseña no tenga espacios.
Servidor de la base de datos: Casi siempre es localhost. Solo si tu hosting te indica otra dirección (como sql.tudominio.com) debes cambiarlo.

[TIP] Si usas Syspanel, ve a la sección "Base de datos" y comprueba que el nombre y el usuario están enlazados (asignados) a la base de datos. A veces se crean pero no se vinculan.

2. Permisos del usuario de la base de datos

Aunque los datos sean correctos, el usuario puede no tener permisos para leer o escribir en la base de datos.

Accede a tu panel de hosting o a phpMyAdmin.
Busca la opción de "Privilegios" o "Permisos" del usuario.
Marca la opción "Todos los privilegios" (o "ALL PRIVILEGES") y guarda los cambios.

[WARNING] No uses el usuario "root" de MySQL para la instalación de PrestaShop. Es un riesgo de seguridad. Crea siempre un usuario específico para la tienda.

Errores de permisos de archivos y carpetas

PrestaShop necesita poder escribir en ciertas carpetas para crear archivos de configuración, imágenes, caché, etc. Si los permisos no son los adecuados, verás errores como "No se puede escribir en la carpeta /config" o "Error al crear el archivo settings.inc.php".

1. Permisos 755 y 644

La mayoría de los archivos y carpetas deben tener estos permisos:

Carpetas: Permiso 755 (rwxr-xr-x). El dueño puede leer, escribir y ejecutar; el grupo y otros solo leer y ejecutar.
Archivos (como .php, .tpl): Permiso 644 (rw-r--r--). El dueño puede leer y escribir; el grupo y otros solo leer.

Puedes cambiarlos desde el administrador de archivos de tu hosting o mediante FTP (FileZilla, por ejemplo). Selecciona la carpeta raíz de PrestaShop, haz clic derecho y elige "Permisos de archivo".

2. El dueño (owner) correcto

A veces el problema no es el número de permiso, sino quién es el dueño de los archivos. En la mayoría de servidores compartidos, el dueño debe ser tu usuario de hosting (por ejemplo, usuario123). Si los archivos pertenecen a nobody o www-data, puede dar error.

Si usas Syspanel, ve a "Archivos" -> "Administrador de archivos", selecciona la carpeta de PrestaShop y busca la opción "Cambiar propietario". Establece tu usuario de FTP.

[INFO] Si no puedes cambiar el propietario, contacta con el soporte de tu hosting. Es un cambio sencillo para ellos.

Errores de versión de PHP o extensiones faltantes

PrestaShop es exigente con la versión de PHP y las extensiones (módulos) que debe tener activadas. Un error común es: "La extensión MySQLi no está habilitada" o "Tu versión de PHP no es compatible".

1. Versión de PHP recomendada

PrestaShop 8.x (la versión más reciente hasta la fecha de esta guía) funciona mejor con PHP 8.0 o 8.1. No uses PHP 7.4 o inferior, ni versiones experimentales como PHP 8.3 sin probar antes.

En cPanel: busca "Seleccionar versión de PHP" y elige la recomendada.
En Syspanel: ve a "Web" -> "PHP Settings" y selecciona la versión desde el desplegable. Recuerda que Syspanel se accede por el puerto 2106.

2. Extensiones PHP obligatorias

PrestaShop necesita al menos estas extensiones activadas. Si alguna falta, la instalación se detendrá:

mysqli (o pdo_mysql)
gd (para imágenes)
curl
xml
zip
mbstring
openssl
json

Puedes activarlas desde el mismo panel donde cambiaste la versión de PHP. Busca la sección "Extensiones" o "Módulos" y marca las que falten.

[WARNING] Si no ves la opción de activar extensiones, pide a tu hosting que lo haga. En servidores compartidos a veces está limitado.

Errores de memoria PHP (memory limit)

Si durante la instalación ves un error blanco o un mensaje como "Fatal error: Allowed memory size of X bytes exhausted", es porque el límite de memoria para PHP es demasiado bajo.

1. Aumentar el límite desde el panel

En Syspanel: ve a "PHP Settings" y busca la opción "memory_limit". Cambia el valor a 256M o 512M. Guarda los cambios.
En cPanel: suele estar en "Select PHP Version" -> "Switch to PHP Options" -> "memory_limit".

2. Crear un archivo php.ini

Si no puedes cambiarlo desde el panel, puedes crear un archivo llamado php.ini en la raíz de tu PrestaShop (junto a la carpeta admin) con este contenido:

memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300

Luego guarda y vuelve a intentar la instalación.

[TIP] Si tu hosting usa Syspanel, el archivo php.ini personalizado puede sobrescribir la configuración global. Asegúrate de que el archivo tenga permisos 644.

Errores de tiempo de ejecución (max_execution_time)

La instalación de PrestaShop puede tardar más de lo normal si el servidor es lento o si hay muchos módulos. Si ves un error de "tiempo de ejecución excedido", necesitas aumentar el límite.

Solución rápida desde el panel

En Syspanel: "PHP Settings" -> "max_execution_time" -> pon 300 (segundos).
También puedes añadir la línea max_execution_time = 300 al archivo php.ini que creaste antes.

Errores de URL o redirección

A veces, después de la instalación, intentas acceder a tu tienda y te redirige a localhost o a una URL incorrecta. Esto pasa porque durante la instalación se guardó una URL que ya no es válida.

1. Revisar el archivo settings.inc.php

Este archivo está en la carpeta app/config/ (en PrestaShop 8.x) o config/ (en versiones anteriores). Ábrelo con un editor de texto y busca las líneas:

define('_PS_BASE_URL_', 'http://tudominio.com');
define('_PS_BASE_URL_SSL_', 'https://tudominio.com');

Asegúrate de que la URL sea la correcta, sin barras al final. Si pusiste localhost durante la instalación, cámbiala por tu dominio real.

2. Limpiar la caché

Después de modificar el archivo, borra la carpeta var/cache/ (o cache/ en versiones antiguas) para que PrestaShop cargue los nuevos valores.

[WARNING] No uses un editor que añada caracteres extraños (como WordPad). Usa Notepad++ o el editor de texto del panel de hosting.

Error de "No se puede crear la tabla" o base de datos corrupta

Si el instalador se queda atascado en la creación de tablas, es probable que la base de datos esté dañada o que haya restos de una instalación anterior.

1. Crear una base de datos nueva

En tu panel (Syspanel, cPanel, etc.), elimina la base de datos que estabas usando.
Crea una nueva con un nombre diferente (por ejemplo, tienda_prestashop_v2).
Crea un nuevo usuario y asígnale todos los privilegios.
Vuelve a ejecutar el instalador con estos datos nuevos.

2. Usar phpMyAdmin para limpiar

Si no quieres borrar la base, entra a phpMyAdmin, selecciona la base de datos y haz clic en "Vaciar" (truncar) todas las tablas. Luego intenta la instalación de nuevo.

Error de "La carpeta /img no tiene permisos de escritura"

Este error es muy concreto y suele aparecer al final de la instalación, cuando PrestaShop intenta crear las carpetas de imágenes.

Solución paso a paso

Conéctate por FTP o al administrador de archivos de tu hosting.
Ve a la carpeta raíz de PrestaShop.
Busca la carpeta img y haz clic derecho -> "Permisos".
Pon 755 (o 777 si el 755 no funciona, aunque es menos seguro).
Aplica también a todas las subcarpetas (opción "Recursivo" o "Aplicar a subdirectorios").

[INFO] Si después de esto sigue fallando, comprueba que el dueño de la carpeta img sea el mismo que el del resto de archivos de PrestaShop (tu usuario de hosting).

Preguntas frecuentes (FAQ) sobre errores de instalación

¿Por qué me sale un error 500 después de instalar?

El error 500 suele ser por un archivo .htaccess mal configurado o por un problema de permisos. Renombra temporalmente el archivo .htaccess a .htaccess.bak y vuelve a cargar la tienda. Si funciona, regenera el .htaccess desde el back office de PrestaShop (una vez que puedas acceder).

¿Puedo instalar PrestaShop en un subdirectorio (ej: mipagina.com/tienda)?

Sí, es perfectamente válido. Solo asegúrate de que la carpeta donde lo instales tenga los mismos permisos que la raíz. Durante la instalación, cuando te pida la URL, pon la completa: https://mipagina.com/tienda.

¿Necesito SSL para instalar?

No es obligatorio para la instalación, pero PrestaShop te recomienda tenerlo. Si no tienes SSL, durante la instalación puedes marcar la opción "No usar SSL". Luego puedes añadirlo más tarde.

¿Qué hago si el instalador se queda en "Cargando..."?

Esto suele ser por un límite de memoria o tiempo de ejecución muy bajo. Aumenta memory_limit y max_execution_time como explicamos antes. También prueba a cerrar otras pestañas del navegador para liberar recursos.

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

La mayoría de hostings compartidos modernos lo son. Los requisitos mínimos son: PHP 7.4+ (mejor 8.0+), MySQL 5.6+ y al menos 256 MB de memoria PHP. Si tu hosting usa Syspanel, puedes verificar estos valores en la sección "PHP Settings" (puerto 2106).

Conclusión

Como has visto, la mayoría de errores instalación PrestaShop tienen soluciones muy concretas y no requieren ser un experto en programación. Recuerda siempre:

Verificar los datos de la base de datos.
Ajustar los permisos de archivos y carpetas.
Usar la versión de PHP correcta con las extensiones necesarias.
Aumentar los límites de memoria y tiempo de ejecución si es necesario.

Si después de seguir todos estos pasos sigues teniendo problemas instalación PrestaShop, no dudes en contactar con el soporte de tu hosting. Ellos pueden revisar la configuración del servidor por ti. ¡Buena suerte con tu tienda online!