Problemas comunes al instalar PrestaShop: Soluciones rápidas

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí es porque has decidido dar el salto al mundo del ecommerce con PrestaShop, ¡y es una excelente elección! Pero a veces, en el camino de la instalación, pueden aparecer algunos "fantasmas" técnicos. No te preocupes, en esta guía extensa y súper detallada vamos a resolver juntos los problemas comunes al instalar PrestaShop. Vamos a desglosar cada error, darte la solución paso a paso y convertir ese momento de frustración en un "¡lo logré!".

Prepárate un café, ponte cómodo y empecemos con el troubleshooting PrestaShop más completo que necesitas.

Errores de Configuración del Servidor (Hosting)

Uno de los orígenes más frecuentes de los errores instalación PrestaShop no está en el código de la tienda, sino en el entorno donde la vas a alojar. El servidor (hosting) debe cumplir unos requisitos mínimos. Si no es así, te encontrarás con pantallas en blanco o mensajes de error crípticos.

Falta de Extensiones PHP (Requisitos Técnicos)

PrestaShop es exigente con las extensiones de PHP. Necesita que ciertos "módulos" del lenguaje estén activos en tu servidor. Si durante la instalación ves un mensaje que dice "Falta la extensión X" o simplemente la instalación se detiene, esto es lo que tienes que hacer.

¿Cómo solucionarlo?

Accede a tu panel de control de hosting. Normalmente es cPanel, Plesk o Syspanel (recuerda que este último se accede por el puerto 2106). Busca la sección de "Seleccionar versión de PHP" o "Administrador de PHP".
Selecciona la versión correcta. PrestaShop 8.x necesita PHP 8.1 o superior. Asegúrate de tenerla seleccionada.
Activa las extensiones necesarias. Busca una lista de casillas llamadas "Extensiones". Las imprescindibles son: curl, gd, intl, mbstring, openssl, pdo_mysql, zip, json, xml. Marca todas las que te falten.
Guarda los cambios. El servidor se reiniciará automáticamente.

[WARNING] Si usas Syspanel, ve a "Servidor Web" > "PHP" y desde ahí podrás gestionar las extensiones. No olvides que el puerto de acceso es el 2106.

Límite de Memoria PHP (Memory Limit) Insuficiente

Otro clásico. Durante la instalación o al subir temas/módulos, puede aparecer un error de "memoria agotada" o un simple pantallazo blanco. Esto ocurre porque el límite de memoria que PHP puede usar es muy bajo.

Solución paso a paso:

Localiza el archivo php.ini. Puedes crearlo en la raíz de tu tienda (la carpeta public_html o www). Si ya existe, edítalo.
Aumenta el límite. Busca la línea memory_limit y cámbiala. Si no existe, añádela. Un valor seguro es:
```
memory_limit = 256M
```

Aumenta también otros límites para evitar futuros problemas:

max_execution_time = 180
upload_max_filesize = 64M
post_max_size = 64M

Guarda el archivo y recarga la página. Si no tienes acceso al php.ini, contacta con tu soporte de hosting o usa un archivo .user.ini (si tu servidor lo permite).

Problemas con la Base de Datos

La base de datos es el cerebro de PrestaShop. Un error aquí puede parar todo el proceso.

Error "No se puede conectar a la base de datos"

Este es uno de los problemas PrestaShop más comunes. Aparece cuando los datos que introduces en el asistente de instalación no son correctos.

¿Qué revisar?

Nombre de la base de datos: Asegúrate de que el nombre sea exactamente el que te proporcionó tu hosting. A veces incluye un prefijo (ej: usuario_mitienda).
Usuario y contraseña: Verifica que el usuario tenga todos los privilegios sobre la base de datos. En cPanel o Syspanel (puerto 2106), puedes editar los privilegios del usuario de la BD.
Servidor de base de datos: Normalmente es localhost. Pero en algunos hostings gestionados (como los de pago), puede ser una IP o un nombre como mysql.tudominio.com. Este es el punto que más se confunde.

[TIP] Si después de verificar todo sigue sin funcionar, prueba a crear una nueva base de datos y un nuevo usuario desde cero. Muchas veces los permisos no se aplican correctamente y es más rápido empezar de nuevo.

Error de Prefijo de Tablas

A veces, si reinstalas PrestaShop o tienes otra instalación en la misma base de datos, el prefijo de las tablas (por defecto ps_) puede estar ocupado. El instalador te dará un error de que las tablas ya existen.

Solución: Simplemente cambia el prefijo en el paso de configuración de la base de datos. Por ejemplo, usa ps2_ o tienda_. Esto creará tablas nuevas sin conflictos.

Errores de Archivos y Permisos (El Clásico)

PrestaShop necesita escribir en ciertas carpetas para funcionar (para subir imágenes, generar cachés, instalar módulos...). Si los permisos no son los correctos, la instalación se quedará colgada o dará errores de "No se puede escribir en el archivo".

Permisos Incorrectos en Carpetas

El error típico es durante la instalación, cuando el asistente se queda en "Paso 3: Configuración del sistema" y marca en rojo "Los archivos y carpetas no son modificables".

Solución definitiva (desde FTP o panel de archivos):

Conéctate a tu servidor vía FTP (FileZilla, por ejemplo) o usa el administrador de archivos de tu hosting.
Navega a la carpeta donde instalaste PrestaShop (ej: public_html/mitienda).
Selecciona todas las carpetas y archivos. Las carpetas clave son: img/, cache/, log/, config/, themes/, modules/, override/, translations/, upload/ y download/.
Cambia los permisos a 755 para las carpetas y 644 para los archivos. En FileZilla, haz clic derecho > "Permisos de archivo" y marca las casillas correspondientes.
Para carpetas específicas que necesitan más permisos (como img/ y cache/), puedes usar 777 de forma temporal durante la instalación. Pero recuerda: después de instalar, cámbialos a 755 por seguridad.

[WARNING] Dejar carpetas con permisos 777 permanentemente es un grave riesgo de seguridad. Solo úsalo durante la instalación o para solucionar un error concreto, y luego revierte los cambios.

El Archivo settings.inc.php no se Crea

Este archivo es el que guarda la configuración de tu tienda (conexión a BD, URL, etc.). Si no se crea automáticamente, la instalación falla.

Solución manual: Durante la instalación, PrestaShop te mostrará el contenido de este archivo en la pantalla. Cópialo, crea un archivo llamado settings.inc.php dentro de la carpeta config/ de tu instalación, pégalo y guárdalo. Luego refresca la página.

Problemas de Redirección y URL (El Bucle Infinito)

A veces, después de la instalación, al entrar a tu tienda te encuentras con un bucle de redirecciones o te manda a localhost en lugar de a tu dominio.

PrestaShop se Redirige a localhost

Esto pasa porque durante la instalación, la URL base se configuró mal (quizás probaste en local y luego subiste los archivos).

¿Cómo arreglarlo?

Accede a tu base de datos (phpMyAdmin desde tu hosting o Syspanel en puerto 2106).
Busca la tabla ps_configuration (o el prefijo que hayas usado).
Localiza las filas con los nombres PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.
Edítalas y escribe tu dominio real, sin http:// ni www (ej: tutienda.com o www.tutienda.com).
También busca en la tabla ps_shop_url y asegúrate de que el campo domain y domain_ssl tengan tu dominio correcto.

[INFO] Si no encuentras las tablas, busca en ps_configuration los valores con name que contengan "domain". Es la forma más rápida.

Error 500 (Internal Server Error) Después de Instalar

Un error 500 es genérico, pero suele deberse a un archivo .htaccess corrupto o a un módulo incompatible.

Pasos para diagnosticar:

Renombra el archivo .htaccess en la raíz de tu tienda a .htaccess_old. Si el error desaparece, el problema está ahí.
Regenera el .htaccess: Ve al panel de administración de PrestaShop (si puedes acceder) a "Parámetros de la tienda" > "Tráfico y SEO" > "SEO y URLs" y haz clic en "Guardar" sin cambiar nada. Esto lo regenera.
Si no puedes acceder al panel, crea un archivo .htaccess nuevo con el contenido básico que PrestaShop genera. Puedes copiarlo de una instalación limpia o pedir a tu hosting que lo genere.
Aumenta el límite de memoria como vimos antes, ya que un error 500 también puede ser por falta de memoria.

Problemas con la Instalación de Módulos y Temas

Una vez instalada la tienda, pueden surgir problemas al añadir funcionalidades.

El Módulo no se Instala o da Error

Causas comunes y soluciones:

Versión incompatible: El módulo es para una versión de PrestaShop diferente a la tuya. Busca una versión actualizada.
Falta de permisos: La carpeta modules/ no tiene permisos de escritura. Dale permisos 755 (o 777 temporalmente) a la carpeta modules/ y a la carpeta del módulo específico.
Conflicto con otro módulo: Desactiva todos los módulos no esenciales e intenta instalar el nuevo. Si funciona, actívalos uno a uno para encontrar el conflicto.

El Tema no se Ve Correctamente

Has instalado un tema chulísimo, pero la tienda se ve rara, con los elementos descolocados.

Soluciones:

Limpia la caché de PrestaShop: Ve a "Parámetros avanzados" > "Rendimiento" y haz clic en "Limpiar caché" y "Regenerar archivos de hojas de estilo y JavaScript".
Limpia la caché de tu navegador o usa una ventana de incógnito.
Verifica que el tema sea responsive: Si se ve mal en móvil, el problema es del tema, no de tu instalación.
Comprueba la configuración de la URL de la tienda (el error de localhost que vimos antes) ya que los temas cargan recursos (CSS, JS) desde esa URL. Si está mal, todo se rompe.

Preguntas Frecuentes (FAQ) sobre Instalación de PrestaShop

Para terminar, aquí tienes las respuestas a las dudas más habituales que recibimos en soporte.

P: ¿Puedo instalar PrestaShop en un hosting compartido barato?
R: Sí, pero asegúrate de que cumpla con los requisitos de PHP 8.1 y extensiones. Los hostings muy básicos a veces tienen versiones antiguas de PHP. Un buen hosting PrestaShop debe ofrecer al menos 256MB de memoria PHP y base de datos MySQL.

P: La instalación se queda cargando en el paso 3 (Configuración del sistema). ¿Qué hago?
R: Esto casi siempre es por falta de permisos de escritura en las carpetas. Dale permisos 777 a las carpetas cache/, img/ y log/ durante la instalación y luego revierte a 755.

P: Después de instalar, no puedo acceder al panel de administración. Me sale página en blanco.
R: Activa la visualización de errores de PHP. Edita el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ de false a true. Te mostrará el error exacto (normalmente es falta de memoria o un módulo conflictivo).

P: He migrado mi tienda de un servidor a otro y ahora no funciona.
R: Este es un caso clásico. Revisa los pasos del error de redirección a localhost. Debes actualizar las rutas en la base de datos y regenerar el .htaccess. También asegúrate de que el nuevo servidor tenga las mismas extensiones PHP.

P: ¿Cómo puedo saber si mi servidor es compatible antes de instalar?
R: PrestaShop incluye un archivo llamado ps_check.php en su carpeta raíz. Súbelo a tu servidor y ejecútalo en el navegador (ej: tudominio.com/ps_check.php). Te dirá si todo está correcto.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia y seguir los pasos uno a uno son la clave. Si te encuentras con un error muy específico, no dudes en consultar los foros oficiales de PrestaShop o contactar con el soporte de tu hosting. ¡Tu tienda online te está esperando!