Errores comunes en PrestaShop y cómo solucionarlos | Guía de hosting

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, seguramente te has encontrado con algún problema al instalar PrestaShop. No te preocupes, es más común de lo que crees. En esta guía extensa y detallada, vamos a desglosar los errores de instalación más frecuentes, paso a paso, para que puedas tener tu tienda online funcionando en un santiamén. Vamos a ello.

Antes de empezar: ¿Qué necesitas para instalar PrestaShop correctamente?

Antes de sumergirnos en los errores, es clave entender los requisitos básicos. La mayoría de los problemas vienen de aquí.

[INFO] PrestaShop es un software potente, pero necesita un entorno específico para funcionar. Si tu hosting no cumple con estos requisitos, la instalación fallará.

Requisitos técnicos esenciales

PHP: Versión 7.4, 8.0 o 8.1 (recomendada). PrestaShop 8.x ya no soporta versiones anteriores.
Base de datos: MySQL 5.7+ o MariaDB 10.2+.
Servidor web: Apache 2.4+ o Nginx.
Memoria PHP: Al menos 256 MB (512 MB o más es ideal).
Extensiones PHP obligatorias: curl, gd, json, mbstring, openssl, pdo_mysql, zip, xml, fileinfo, intl.

Si tu hosting no tiene esto, te dará error. Si usas un panel como Syspanel (recuerda, acceso por puerto 2106), puedes verificar estos valores en la sección de PHP o contactar con soporte.

Error 1: Pantalla en blanco o error 500 al acceder a la instalación

Este es uno de los errores de instalación más frustrantes. Llegas a tu dominio y solo ves una pantalla blanca o un feo error 500.

Causas comunes y soluciones

1. Permisos de archivos incorrectos

PrestaShop necesita permisos específicos para escribir en ciertas carpetas.

Solución:
1. Conéctate a tu hosting vía FTP o al administrador de archivos de Syspanel (puerto 2106).
2. Ve a la carpeta raíz donde subiste PrestaShop (normalmente public_html o www).
3. Las carpetas config, cache, log, img, mails, modules, themes, translations, upload, download deben tener permisos 755.
4. Los archivos dentro de esas carpetas, permisos 644.
5. Si no sabes cómo hacerlo, muchos paneles tienen un botón "Restablecer permisos" o "Fix permissions". En Syspanel, busca en "Herramientas" -> "Permisos de archivos".

2. Límite de memoria PHP insuficiente

Si tu PHP tiene poca memoria, el instalador se cuelga.

Solución:
1. Crea o edita un archivo llamado php.ini en la raíz de tu instalación.
2. Añade esta línea: memory_limit = 256M
3. Si no funciona, contacta a tu proveedor de hosting para que lo aumente desde el servidor. En Syspanel, puedes ir a "Configuración PHP" y ajustar el valor.

3. Error en el archivo .htaccess

Un .htaccess corrupto puede bloquear todo.

Solución:
1. Conéctate por FTP.
2. Renombra el archivo .htaccess a .htaccess_old.
3. Intenta acceder de nuevo a la instalación. Si funciona, el problema era ese. Después de instalar, PrestaShop generará uno nuevo.

Error 2: "El directorio no tiene permisos de escritura" o "No se puede crear el archivo settings.inc.php"

Este es otro clásico. El instalador te dice que no puede escribir los archivos de configuración.

Causas comunes y soluciones

1. Permisos de la carpeta raíz

A veces la carpeta raíz (public_html) tiene permisos demasiado restrictivos.

Solución:
1. En tu FTP o panel de archivos, cambia los permisos de la carpeta raíz a 755.
2. Asegúrate de que el usuario del servidor web (www-data, nobody, etc.) sea el propietario. Si usas Syspanel, esto suele gestionarse automáticamente, pero si no, contacta a soporte.

2. SELinux activado (en servidores Linux)

SELinux es un sistema de seguridad que puede bloquear la escritura.

Solución:
1. Esto es más técnico. Si tienes acceso SSH, puedes ejecutar: sudo setenforce 0 para desactivarlo temporalmente.
2. O mejor, cambia el contexto de seguridad de la carpeta: sudo chcon -R -t httpd_sys_rw_content_t /ruta/a/tu/prestashop
3. Si no tienes acceso, pide a tu hosting que lo revise.

[WARNING] No desactives SELinux permanentemente en un servidor de producción. Es mejor configurarlo correctamente.

Error 3: Error de conexión a la base de datos

El instalador no puede conectar con tu base de datos MySQL o MariaDB.

Causas comunes y soluciones

1. Datos de conexión incorrectos

Es el error más tonto y común. Revisa bien:

Nombre de la base de datos: Asegúrate de que existe y está creada. En Syspanel, ve a "Base de datos" -> "Crear base de datos".
Usuario de la base de datos: Debe tener todos los privilegios sobre esa base de datos.
Contraseña: Escríbela sin espacios al inicio o final.
Servidor de base de datos: Normalmente es "localhost", pero algunos hostings usan "127.0.0.1" o un nombre específico como "mysql.tudominio.com". Pregunta a tu proveedor.

2. Puerto incorrecto

Por defecto, MySQL usa el puerto 3306. Si tu hosting usa otro, debes especificarlo.

Solución: En el campo "Servidor de base de datos", escribe localhost:3307 (o el puerto que te hayan dado).

3. El usuario no tiene permisos desde 'localhost'

A veces el usuario solo puede conectarse desde un host específico.

Solución: Al crear el usuario en Syspanel (o phpMyAdmin), asegúrate de que el host sea % (cualquier host) o localhost si instalas desde el mismo servidor.

Error 4: "El servidor no tiene la extensión PHP necesaria" o "Falta la extensión XXX"

El instalador te muestra una lista de extensiones PHP que faltan.

Causas comunes y soluciones

1. PHP mal configurado

Tu hosting tiene PHP pero no tiene activadas todas las extensiones que PrestaShop necesita.

Solución:
1. Si usas Syspanel, ve a "Configuración PHP" o "Seleccionar versión PHP". Allí suele haber una lista de extensiones que puedes activar/desactivar. Marca todas las que te pide el instalador (curl, gd, json, mbstring, openssl, pdo_mysql, zip, xml, fileinfo, intl).
2. Si no encuentras la opción, contacta a tu hosting y diles exactamente qué extensiones necesitas. Es una petición muy común.

2. Versión de PHP incorrecta

Tener PHP 5.6 o 7.0 es una causa segura de error.

Solución: Cambia la versión de PHP a 7.4, 8.0 u 8.1 en el panel de tu hosting. En Syspanel, esto suele estar en "Ajustes del sitio" o "PHP Selector".

Error 5: Instalación se queda colgada en el paso 3 o 4

La barra de progreso avanza hasta cierto punto y se detiene.

Causas comunes y soluciones

1. Tiempo de ejecución de PHP muy bajo

El instalador necesita tiempo para crear las tablas de la base de datos. Si el límite es muy bajo, se corta.

Solución:
1. Añade en tu php.ini: max_execution_time = 300
2. También en .htaccess: php_value max_execution_time 300
3. Si no funciona, pide a tu hosting que lo aumente temporalmente.

2. Base de datos corrupta o con prefijo conflictivo

Si ya has intentado instalar antes, puede que queden tablas viejas.

Solución:
1. Crea una base de datos nueva y un usuario nuevo.
2. O usa un prefijo de tabla diferente en la instalación, por ejemplo, ps2_ en lugar de ps_.

Error 6: Error "No se puede escribir en la carpeta /cache" o "No se puede escribir en /log"

Causas comunes y soluciones

1. Permisos de carpetas específicas

Ya lo mencionamos, pero es tan común que merece su propio punto.

Solución:
1. Asegúrate de que las carpetas cache, log, themes, modules y tools tengan permisos 777 (solo durante la instalación, después cámbialos a 755 por seguridad).
2. En Syspanel, puedes hacer clic derecho sobre la carpeta -> "Cambiar permisos" y marcar todos los checkboxes.

[WARNING] Los permisos 777 son inseguros. Después de instalar, cámbialos a 755 para las carpetas y 644 para los archivos.

Preguntas Frecuentes (FAQ)

P: ¿Puedo instalar PrestaShop en un hosting compartido barato?
R: Sí, pero asegúrate de que cumpla con los requisitos de PHP y base de datos. Los hostings muy básicos suelen tener PHP antiguo o limitado, lo que causa errores de instalación.

P: Mi instalación se queda en "Creando tablas" y no avanza. ¿Qué hago?
R: Aumenta el max_execution_time a 300 en tu php.ini o .htaccess. Si sigue, contacta a tu hosting para que lo hagan desde el servidor.

P: ¿Qué hago si veo un error 500 después de subir los archivos?
R: Revisa los permisos de la carpeta raíz (755) y los archivos (644). También renombra el .htaccess temporalmente. Si usas Syspanel, puedes ver los logs de error en "Registros del servidor" para más detalles.

P: ¿Necesito ser un experto en servidores para instalar PrestaShop?
R: No, pero ayuda tener nociones básicas. Si te sientes perdido, muchos hostings ofrecen instalación automática (Softaculous, etc.) o soporte técnico que puede ayudarte. Esta guía está diseñada para que puedas resolver los problemas más comunes por ti mismo.

P: Después de instalar, ¿debo borrar la carpeta "install"?
R: ¡Sí! Por seguridad, elimina la carpeta install del servidor. Si no lo haces, cualquiera podría reinstalar tu tienda y borrar todo. En Syspanel, puedes borrarla desde el administrador de archivos.

Conclusión

Instalar PrestaShop puede parecer un reto, especialmente cuando aparecen esos molestos errores de instalación. Pero con un poco de paciencia y siguiendo esta guía, podrás resolver la mayoría de ellos. Recuerda siempre verificar los requisitos de tu hosting, los permisos de archivos y la configuración de PHP. Si todo falla, no dudes en contactar al soporte de tu proveedor, diles exactamente el error que ves y los pasos que has seguido. ¡Estoy seguro de que lo solucionarán rápido!

[TIP] Antes de instalar, crea una base de datos y un usuario en tu panel de control (como Syspanel, puerto 2106). Anota los datos en un bloc de notas. Así evitarás errores de tipeo durante la instalación.

¡Mucha suerte con tu nueva tienda online! Si te surge otra duda, aquí estoy para ayudarte.