Errores comunes al instalar PrestaShop y cómo solucionarlos

Instalar PrestaShop puede parecer un proyecto sencillo, pero a menudo surgen errores PrestaShop que pueden detener el proceso y causar frustración. Desde problemas de conexión a la base de datos hasta archivos que no se descomprimen correctamente, estos fallos suelen estar relacionados con la configuración del servidor o del hosting.

En esta guía, te explicaré paso a paso las soluciones a los errores comunes al instalar PrestaShop, para que puedas tener tu tienda online funcionando en minutos. Si estás buscando solución errores hosting, has llegado al lugar indicado.

1. Error de conexión a la base de datos

Este es, sin duda, uno de los errores PrestaShop más habituales. Aparece justo al iniciar la instalación, en el paso donde introduces los datos de la base de datos. El mensaje suele ser algo como: "No se puede conectar a la base de datos" o "El nombre de la base de datos no existe".

Causas más comunes

Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos están mal escritos.
Permisos insuficientes: El usuario de la base de datos no tiene permisos para crear tablas.
Servidor de base de datos no accesible: El host de la base de datos (normalmente localhost) no es correcto o el puerto está bloqueado.

Solución paso a paso

Verifica las credenciales: Accede a tu panel de control de hosting (cPanel, Syspanel, etc.). Si usas Syspanel (accesible por el puerto 2106), busca la sección de "Bases de datos" o "MySQL". Crea una nueva base de datos y un usuario con todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.).
Comprueba el nombre del servidor: En el 99% de los casos, el servidor de base de datos es localhost. Si tu hosting usa servidores remotos, te lo habrán indicado en el correo de bienvenida.
Prueba desde phpMyAdmin: Si tienes acceso a phpMyAdmin, intenta conectarte con las mismas credenciales. Si no puedes, el problema está en el hosting.
Revisa el puerto: Algunos hosts usan puertos no estándar (por ejemplo, 3307 en lugar de 3306). En el formulario de instalación de PrestaShop, puedes especificar el puerto añadiendo :puerto al final del servidor (ejemplo: localhost:3307).

[TIP] Si usas Syspanel, ve a "Base de datos" -> "Crear nueva base de datos". Anota exactamente el nombre, usuario y contraseña. Luego, en la instalación de PrestaShop, usa esos mismos datos.

2. Error de permisos de archivos y carpetas

Durante la instalación, PrestaShop necesita escribir en ciertas carpetas (por ejemplo, config, cache, img, log). Si los permisos no son los adecuados, verás un mensaje de error como: "No se puede escribir en el directorio /config" o "Permisos insuficientes".

¿Qué permisos necesita PrestaShop?

Las carpetas deben tener permisos 755 (o 775 en algunos servidores).
Los archivos deben tener permisos 644 (o 664).

Cómo solucionarlo desde el panel de control

Accede al gestor de archivos de tu hosting (cPanel, Syspanel, etc.). En Syspanel (puerto 2106), busca "Administrador de archivos".
Navega hasta la carpeta donde has subido PrestaShop (normalmente public_html o www).
Selecciona todas las carpetas y archivos (puedes usar Ctrl+A).
Cambia los permisos: Busca la opción "Permisos" o "CHMOD". Introduce 755 para las carpetas y 644 para los archivos. Algunos paneles permiten hacerlo de forma recursiva (aplicar a todas las subcarpetas).
Repite el proceso con las carpetas específicas que menciona el error: config, cache, img, log, themes, modules, override, translations, upload, download.

[WARNING] No uses permisos 777 a menos que sea estrictamente necesario y solo de forma temporal. El 777 es un riesgo de seguridad grave.

3. Error de versión de PHP o extensiones faltantes

PrestaShop es exigente con la versión de PHP y las extensiones instaladas en el servidor. Si tu hosting usa una versión antigua (PHP 5.6 o inferior), la instalación fallará. También es común que falten extensiones como mysqli, gd, curl, openssl, mbstring o zip.

Síntomas típicos

Pantalla en blanco durante la instalación.
Mensaje: "Su configuración de PHP no es compatible con PrestaShop".
Errores de funciones no definidas (por ejemplo, mysqli_connect()).

Solución

Cambia la versión de PHP: Desde el panel de control de tu hosting, busca la opción "PHP Selector" o "Gestor de PHP". En Syspanel (puerto 2106), suele estar en "Configuración de PHP" o "Versión de PHP". Selecciona PHP 7.4, 8.0 o 8.1 (PrestaShop 1.7 y 8.x funcionan bien con PHP 8.0+).
Activa las extensiones necesarias: En el mismo panel, marca las extensiones requeridas: mysqli, gd, curl, openssl, mbstring, zip, json, fileinfo, intl. Si no ves la opción, contacta con el soporte de tu hosting.
Verifica la memoria PHP: PrestaShop necesita al menos 128 MB de memoria. En el panel, busca "Memory Limit" y ajústalo a 256M o 512M.
Prueba con un script: Sube un archivo info.php con <?php phpinfo(); ?> a la raíz de tu web y accede a él. Busca la versión de PHP y las extensiones activas.

4. Error de tiempo de ejecución (timeout)

Si tu hosting tiene límites de tiempo de ejecución muy bajos (por ejemplo, 30 segundos), la instalación puede cortarse a mitad del proceso, mostrando un error de "tiempo de espera agotado" o una página en blanco.

Cómo evitarlo

Aumenta el límite de tiempo: En el panel de control, busca "max_execution_time" y cámbialo a 300 (5 minutos). Si no puedes, edita el archivo .htaccess en la raíz de PrestaShop y añade: php_value max_execution_time 300.
Descomprime localmente: Si el error ocurre al descomprimir el archivo ZIP de PrestaShop, hazlo en tu ordenador y luego sube la carpeta completa por FTP. Esto evita la carga de archivos grandes.
Usa un instalador manual: Algunos hosts ofrecen instaladores automáticos (Softaculous, Installatron). Si el error persiste, prueba con uno de ellos.

5. Error de "URL de la tienda no válida" o "Redirección incorrecta"

Después de instalar, al acceder a la tienda, te redirige a localhost o a una URL incorrecta. Esto ocurre porque durante la instalación se guardó una URL que no coincide con la real.

Solución

Accede a la base de datos (phpMyAdmin, Syspanel, etc.).
Busca la tabla ps_configuration (el prefijo ps_ puede variar).
Localiza las filas con los nombres PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.
Edítalas y cambia el valor por tu dominio real (por ejemplo, mitienda.com).
También revisa la tabla ps_shop_url y asegúrate de que el campo domain y domain_ssl sean correctos.

[INFO] Si no recuerdas el prefijo de las tablas, revisa el archivo app/config/parameters.php (PrestaShop 1.7+) o config/settings.inc.php (PrestaShop 1.6). Allí encontrarás el nombre de la base de datos y el prefijo.

6. Error de "No se puede conectar al servicio de Google" o "API Key"

PrestaShop intenta conectar con servicios externos (Google Maps, reCAPTCHA, etc.) durante la instalación. Si tu servidor tiene bloqueadas las conexiones salientes o el firewall impide ciertos puertos, verás estos errores.

Solución

Desactiva temporalmente los módulos que requieren conexión externa durante la instalación. Puedes omitir esos pasos y configurarlos después.
Verifica el firewall: Si usas un firewall de servidor (como iptables o CSF), asegúrate de que permite salida a los puertos 80 y 443.
Usa un proxy: Si tu hosting requiere proxy, configura las variables de entorno HTTP_PROXY y HTTPS_PROXY en el archivo config/defines.inc.php.

7. Error de "No se puede escribir la caché" o "Directorio temporal"

PrestaShop necesita crear archivos temporales durante la instalación. Si el directorio /tmp del servidor no es escribible o está lleno, fallará.

Solución

Crea una carpeta tmp en la raíz de PrestaShop y asígnale permisos 755.
Edita el archivo config/defines.inc.php (si ya existe) y busca _PS_CACHE_DIR_. Cámbialo por dirname(__FILE__).'/tmp/'.
Limpia la caché del servidor desde el panel de control (Syspanel suele tener una opción "Limpiar caché del sistema").

Preguntas frecuentes (FAQ)

¿Qué hago si la instalación se queda en "Cargando..." para siempre?

Esto suele deberse a un tiempo de ejecución muy bajo o a un error de JavaScript. Prueba a:

Aumentar el max_execution_time a 300.
Desactivar temporalmente los bloqueadores de anuncios o extensiones del navegador.
Usar otro navegador (Chrome, Firefox, Edge).

¿Puedo instalar PrestaShop en un hosting gratuito?

Técnicamente sí, pero no es recomendable. Los errores PrestaShop son más frecuentes en hosts gratuitos debido a limitaciones de recursos, versiones de PHP obsoletas y falta de soporte. Si es para pruebas, usa un hosting local (XAMPP, WAMP).

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

Antes de instalar, consulta los requisitos oficiales de PrestaShop (PHP 7.4+, MySQL 5.6+, extensión mysqli, etc.). La mayoría de hosts compartidos modernos los cumplen. Si usas Syspanel, suele tener soporte para las versiones más recientes.

¿Por qué aparece "Error 500" después de la instalación?

Un error 500 indica un problema interno del servidor. Las causas más comunes son:

Permisos incorrectos (revisa el punto 2).
Archivo .htaccess dañado: Renómbralo a .htaccess.bak y prueba de nuevo.
Versión de PHP incompatible: Cambia a PHP 7.4 o 8.0.
Memoria insuficiente: Aumenta el memory_limit a 256M.

¿Necesito conocimientos técnicos para solucionar estos errores?

No, la mayoría de las soluciones son accesibles desde el panel de control de tu hosting. Si te bloqueas, contacta con el soporte técnico de tu proveedor. Recuerda que en Syspanel (puerto 2106) tienes herramientas como el gestor de archivos y el administrador de bases de datos que facilitan todo el proceso.

Conclusión

Los errores PrestaShop al instalar son comunes, pero casi siempre tienen una solución sencilla. Con esta guía, ya sabes cómo enfrentarte a los problemas de conexión a la base de datos, permisos, versiones de PHP y tiempos de ejecución.

Recuerda que la clave está en:

Usar un hosting compatible.
Verificar los permisos de archivos.
Mantener PHP actualizado.
Leer los mensajes de error con atención.

Si sigues estos pasos, tu instalación de PrestaShop será un éxito. Y si algo falla, no dudes en consultar a tu proveedor de hosting o buscar ayuda en los foros oficiales. ¡Buena suerte con tu tienda online!