Errores comunes PrestaShop en cPanel y soluciones

Antes de empezar: ¿Por qué falla PrestaShop en cPanel?

Instalar PrestaShop en cPanel es una tarea muy común, pero también puede convertirse en una fuente de frustración si aparecen errores inesperados. La mayoría de los problemas no son culpa tuya ni del software, sino de pequeños detalles de configuración del servidor que no coinciden con lo que PrestaShop espera encontrar.

En esta guía vamos a desglosar los errores PrestaShop cPanel más habituales, explicarte por qué ocurren y, lo más importante, darte la solución paso a paso. No necesitas ser un experto en desarrollo web; con seguir las instrucciones al pie de la letra, podrás solucionar errores PrestaShop incluso si es tu primera vez.

[INFO] Esta guía está pensada para entornos cPanel, que es el panel de control más usado en hosting compartido. Si tu hosting usa Syspanel (antes HestiaCP), los pasos son similares, pero recuerda que el acceso a Syspanel se realiza a través del puerto 2106.

Error 1: Pantalla blanca o error 500 al instalar

Este es, sin duda, el error más temido y el más común. De repente, ves una página en blanco o un mensaje de "Error 500 Internal Server Error" y no sabes qué ha pasado. La causa suele ser un problema con los permisos de archivos o con el archivo .htaccess.

Solución paso a paso

Accede a tu cPanel y busca la herramienta "Administrador de archivos" (File Manager).
Entra en la carpeta public_html (o la carpeta donde hayas subido PrestaShop).
Selecciona todos los archivos y carpetas de la instalación.
Haz clic en "Permisos" en la barra superior.
Asegúrate de que los permisos estén configurados de la siguiente manera:
- Carpetas: 755
- Archivos: 644
Aplica los cambios y vuelve a intentar cargar tu tienda.

Si el problema persiste, el culpable suele ser el archivo .htaccess.

En el mismo Administrador de archivos, activa la opción "Mostrar archivos ocultos" (suele estar en la esquina superior derecha).
Localiza el archivo .htaccess en la raíz de tu instalación.
Haz clic derecho sobre él y elige "Renombrar".
Cámbiale el nombre a .htaccess.bak (esto lo desactiva temporalmente).
Recarga tu tienda. Si ahora funciona, el .htaccess tenía una configuración incorrecta.
Ve a la tienda: Parámetros avanzados > Rendimiento y haz clic en "Regenerar archivo .htaccess".

[WARNING] No dejes el .htaccess renombrado para siempre. Es necesario para el SEO y el funcionamiento de las URLs amigables. Regenerarlo desde el panel de administración es la solución definitiva.

Error 2: "La memoria máxima permitida está agotada" (Allowed memory size exhausted)

Este mensaje es muy claro: tu instalación de PrestaShop necesita más memoria PHP de la que el servidor le permite usar por defecto. Es un problema muy típico al instalar temas o módulos pesados, pero también puede aparecer durante la instalación inicial.

Cómo solucionarlo

La solución es aumentar el límite de memoria PHP. Puedes hacerlo de dos maneras:

Opción A: Desde cPanel

Busca la sección "Software" y haz clic en "Select PHP Version" o "Selector de versión de PHP".
En la nueva ventana, haz clic en la pestaña "Options" o "Opciones".
Busca la línea memory_limit.
Cambia el valor a 256M o incluso 512M. Te recomiendo empezar con 256M.
Haz clic en "Save" o "Guardar".

Opción B: Editando el archivo php.ini

Ve al "Administrador de archivos".
Busca el archivo php.ini en la raíz de tu cuenta. Si no existe, créalo.
Añade o modifica la siguiente línea:

memory_limit = 256M

Guarda el archivo y comprueba si el error ha desaparecido.

[TIP] Si no encuentras el archivo php.ini, busca en la carpeta public_html o en la raíz de tu cuenta. En algunos hostings, la ruta es public_html/php.ini.

Error 3: "El archivo de configuración no existe" o "No se puede conectar a la base de datos"

Este error es clásico en los problemas de instalación PrestaShop. O bien no has creado la base de datos correctamente, o los datos que has introducido en el asistente de instalación no son correctos.

Solución detallada

Primero, vamos a verificar que la base de datos existe.

Entra en cPanel y busca la sección "Bases de datos MySQL".
Comprueba que tienes una base de datos creada. Si no, créala con un nombre descriptivo (ej. presta_db).
IMPORTANTE: No basta con crear la base de datos. Debes crear un usuario y asignarlo a esa base de datos con TODOS LOS PRIVILEGIOS.
Anota estos tres datos: Nombre de la base de datos, nombre de usuario y contraseña.

Ahora, vuelve al asistente de instalación de PrestaShop.

En el paso de "Base de datos", introduce los datos que acabas de verificar.
Atención al prefijo: El campo "Prefijo de tablas" suele venir como ps_. Si tu base de datos ya tenía tablas de una instalación anterior, puede dar conflicto. Cámbialo a algo como shop_ para evitar errores.
Asegúrate de que el "Servidor de base de datos" es localhost. En el 99% de los casos en cPanel es así.

[WARNING] Nunca utilices el usuario root de MySQL para tu tienda. Siempre crea un usuario específico para PrestaShop. Es una medida de seguridad básica.

Error 4: Problemas con la carpeta `var/cache` y la escritura de archivos

PrestaShop necesita escribir archivos temporales en la carpeta var/cache (en versiones 1.7 y superiores) o cache (en versiones antiguas). Si el servidor no tiene permisos para escribir, verás errores extraños o la tienda no cargará correctamente.

La solución definitiva

Ve al "Administrador de archivos" y localiza la carpeta var en la raíz de tu instalación.
Entra en la carpeta var y busca la subcarpeta cache.
Haz clic derecho sobre la carpeta cache y selecciona "Permisos".
Introduce el valor 755 y marca la casilla "Recursivo" (para que aplique a todas las subcarpetas y archivos).
Haz lo mismo con la carpeta log que está dentro de var.
También es recomendable hacerlo con la carpeta img y upload si tienes problemas al subir imágenes.

Si después de esto sigues teniendo problemas, borra el contenido de la carpeta var/cache (pero no la carpeta en sí). Puedes hacerlo seleccionando todo el contenido y pulsando "Eliminar".

[INFO] En versiones antiguas de PrestaShop (1.6 o anteriores), la carpeta se llama cache y está directamente en la raíz. El procedimiento es el mismo.

Error 5: "La URL no es válida" o problemas con las URLs amigables

Este error suele aparecer al intentar activar las URLs amigables o al cambiar la URL de la tienda. Es un problema de configuración, no de código.

Cómo arreglarlo

Accede a tu panel de administración de PrestaShop.
Ve a Parámetros avanzados > SEO y URLs.
Marca la opción "Activar URLs amigables".
Haz clic en "Guardar".

Si te da un error, es porque el archivo .htaccess no se ha actualizado correctamente. Sigue estos pasos:

Ve al "Administrador de archivos" de cPanel.
Asegúrate de tener visible el archivo .htaccess.
Bórralo o renómbralo (.htaccess.bak).
Vuelve a PrestaShop y a la página de "SEO y URLs".
Haz clic en "Guardar" de nuevo. PrestaShop debería regenerar el .htaccess correctamente.

Error 6: El instalador se queda atascado en "Configuración del sistema"

A veces, durante la instalación, la barra de progreso se queda congelada en el paso 3 o 4. Esto suele deberse a que el servidor está tardando demasiado en responder o hay un problema con las funciones de PHP.

Solución práctica

Sube el límite de ejecución de PHP. En cPanel, busca "Select PHP Version" > "Options" y cambia max_execution_time a 300 o 600.
Desactiva las funciones deshabilitadas. En la misma pantalla, busca "disable_functions". Si ves exec, shell_exec o proc_open en la lista, elimínalas. PrestaShop necesita algunas de ellas para completar la instalación.
Limpia la caché del navegador y vuelve a intentar la instalación desde cero.

[TIP] A veces es más fácil borrar los archivos del instalador y volver a subirlos. Asegúrate de que la descarga del archivo ZIP de PrestaShop no esté corrupta. Vuelve a descargarlo desde la página oficial.

Preguntas frecuentes (FAQ) para solucionar errores PrestaShop

¿Por qué veo "Error 403 Forbidden" al acceder a mi tienda?

Este error indica un problema de permisos. Revisa que los permisos de las carpetas sean 755 y los de los archivos 644. También puede deberse a una regla de bloqueo en el .htaccess.

¿Cómo sé qué versión de PHP necesito?

PrestaShop 1.7 y 8.x requieren PHP 7.1 o superior. Te recomiendo usar PHP 7.4 u 8.0 para un rendimiento óptimo. Puedes cambiarlo desde "Select PHP Version" en cPanel.

¿Qué hago si no puedo acceder al panel de administración?

Si la tienda funciona pero el panel de administración da error, borra la carpeta var/cache como se explicó en el Error 4. Es la solución más común para este problema.

¿Es normal que el instalador tarde tanto?

No, no es normal. Si tarda más de 5 minutos, hay un problema de configuración del servidor. Revisa el max_execution_time en la configuración de PHP.

Resumen y consejos finales

Los errores PrestaShop cPanel son más fáciles de resolver de lo que parecen. La clave está en revisar siempre tres cosas: permisos de archivos, configuración de PHP y datos de la base de datos. Estos tres puntos son la causa del 90% de los problemas de instalación PrestaShop.

Te dejo con un checklist rápido para que no se te olvide nada:

Los permisos de carpetas son 755 y archivos 644.
El límite de memoria PHP es de al menos 256M.
La base de datos MySQL existe y el usuario tiene todos los privilegios.
El archivo .htaccess está bien generado (o regenerado).
La carpeta var/cache está vacía o con permisos correctos.

[INFO] Si tu hosting no usa cPanel sino Syspanel (antes HestiaCP), recuerda que la forma de acceder es a través del puerto 2106. Los pasos para solucionar los errores son prácticamente los mismos, pero la interfaz de gestión de archivos y bases de datos será diferente.

Con estas soluciones, podrás solucionar errores PrestaShop con confianza y poner tu tienda online en marcha. No te frustres, todos hemos pasado por esto. ¡Ánimo y a vender!