Errores comunes PrestaShop en cPanel | Solución definitiva

¿Tu tienda PrestaShop se ha caído y solo ves una pantalla en blanco o un mensaje de error? No te preocupes, has llegado al lugar correcto.

Los errores 500, 503 y los problemas de permisos son, probablemente, los dolores de cabeza más comunes para cualquier persona que gestione una tienda online con PrestaShop en un hosting compartido con cPanel.

Pero aquí viene la buena noticia: el 90% de estos errores tienen una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

En esta guía extensa y práctica, vamos a desglosar, paso a paso, cómo solucionar el error 500 prestashop cpanel, el temido error 503 prestashop y cómo arreglar los permisos archivos prestashop de forma segura.

Coge aire, prepara una taza de café y vamos a ello. Al final de este artículo, tendrás un plan de acción claro para solucionar errores prestashop y volver a vender.

¿Por qué ocurren estos errores en PrestaShop?

Antes de lanzarnos a la solución, es crucial entender qué significa cada error. Piensa en tu servidor como un restaurante.

Error 500 (Internal Server Error): Es como si el cocinero (el servidor) recibiera una orden que no puede procesar. No es que el restaurante esté cerrado, sino que algo falló en la preparación del plato. Suele deberse a un archivo corrupto, un módulo incompatible o un problema de configuración del servidor.
Error 503 (Service Unavailable): Es como si el restaurante estuviera lleno o en obras. El servidor está activo, pero no puede atender tu petición en este momento. A menudo está relacionado con un mantenimiento activado por error, un plugin de caché o un fallo en la base de datos.
Problemas de Permisos: Imagina que los archivos de la receta tienen un candado. Si el servidor no tiene la llave (permisos incorrectos), no puede leer ni escribir los archivos, lo que provoca errores 500 o pantallas en blanco.

Solución al Error 500 en PrestaShop desde cPanel

El error 500 prestashop cpanel es el más frustrante porque a menudo no da pistas visuales. Pero no te preocupes, vamos a diagnosticarlo y solucionarlo paso a paso.

1. Activa el Modo Depuración (Debug Mode) para ver el error real

Lo primero que necesitas es que PrestaShop te diga qué está fallando. Por defecto, oculta los detalles por seguridad.

Método 1: Desde el BackOffice (si puedes acceder)

Ve a Parámetros Avanzados > Rendimiento.
Localiza la opción Modo de depuración.
Selecciona Sí en el desplegable.
Guarda los cambios.

Esto mostrará el error específico en la pantalla. Cuando lo anotes, vuelve a ponerlo en No.

Método 2: Editando el archivo config/defines.inc.php (Si no puedes acceder al panel)

Este es el método más común cuando tienes una pantalla en blanco.

Entra a tu panel de cPanel y abre el Administrador de Archivos.
Navega a la carpeta raíz de tu tienda (normalmente public_html).
Entra en la carpeta config.
Busca el archivo defines.inc.php y haz clic derecho > Editar.
Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cámbiala por define('_PS_MODE_DEV_', true);.
Guarda el archivo y recarga tu tienda. Verás el error específico en lugar de la página en blanco.

[WARNING]

IMPORTANTE: Después de ver el error, revierte el cambio poniendo false de nuevo. Dejar el modo debug activo en una tienda en producción es un grave riesgo de seguridad, ya que expone rutas y datos sensibles.

2. Soluciones específicas según el error mostrado

Una vez activado el modo debug, verás un mensaje. Las causas más comunes y sus soluciones son:

Error de memoria (Allowed memory size exhausted): Esto significa que tu tienda necesita más memoria PHP.
- Solución: Aumenta el límite de memoria en el archivo php.ini o en el .htaccess. Añade esta línea al .htaccess:
```
php_value memory_limit 512M
```
Error de un módulo específico: El mensaje mencionará la ruta de un módulo concreto.
- Solución: Ve a la carpeta modules en el Administrador de Archivos de cPanel. Busca la carpeta del módulo problemático y renómbrala añadiendo un sufijo, por ejemplo, micodigo-bak. Esto lo desactiva temporalmente y permitirá que la tienda cargue. Luego, desde el BackOffice, podrás desinstalarlo o actualizarlo.
Error de una plantilla (tema): Si el error menciona una ruta en themes/.
- Solución: Temporalmente, cambia al tema por defecto de PrestaShop. Puedes hacerlo desde la base de datos o renombrando la carpeta del tema en themes.
Error de sobrescritura (Override): Si el problema está en override/.
- Solución: Renombra la carpeta override a override_bak para desactivar todas las sobrescrituras. Si la tienda funciona, sabrás que el problema es uno de esos archivos.

3. Comprueba la versión de PHP

Una de las causas más frecuentes del error 500 es que tu versión de PHP es demasiado antigua o demasiado nueva para tu versión de PrestaShop.

En cPanel, busca la sección Software y haz clic en Seleccionar versión de PHP.
Prueba a cambiar a una versión anterior o posterior. Por ejemplo, si estás en PHP 8.0 y tu PrestaShop es de 2016, prueba con PHP 7.4. Si estás en PHP 7.4, prueba con 7.3 o 8.0.

A veces, simplemente cambiar la versión de PHP y guardar los cambios (aunque sea la misma) recompila la caché y soluciona el problema.

Solución al Error 503 en PrestaShop desde cPanel

El error 503 prestashop es un poco más específico. Significa que el servidor está en mantenimiento o sobrecargado. Aquí tienes las soluciones más efectivas.

1. Desactiva el Modo Mantenimiento forzosamente

A veces, un archivo de mantenimiento se queda "colgado" y no se elimina correctamente.

Ve a cPanel > Administrador de Archivos.
Busca en la raíz de tu tienda un archivo llamado maintenance.flag (a veces puede ser .maintenance.flag).
Si lo encuentras, bórralo. Este archivo es el que le dice a PrestaShop que active el modo mantenimiento.
Recarga tu tienda.

2. Limpia la caché de PrestaShop y de tu navegador

Una caché corrupta puede provocar un 503.

Desde el BackOffice: Ve a Parámetros Avanzados > Rendimiento y haz clic en Vaciar la caché (el botón morado que dice "Vaciar la caché").
Desde cPanel: Si no puedes acceder al BackOffice, borra manualmente el contenido de las carpetas var/cache/dev y var/cache/prod. Dentro de estas carpetas, hay archivos y subcarpetas. Selecciona todo y bórralo. No borres las carpetas dev y prod en sí, solo su contenido.

[INFO]

En versiones antiguas de PrestaShop (1.6 o anteriores), la caché se encuentra en las carpetas cache/smarty/compile y cache/smarty/cache. Borra el contenido de ambas.

3. Revisa los límites del servidor (CPU y Memoria)

Un error 503 puede deberse a que tu cuenta de hosting ha superado el límite de recursos.

En cPanel, busca la sección Métricas o Estadísticas.
Revisa el uso de CPU y uso de memoria.
Si ves que has superado los límites, puede que tu plan sea insuficiente. Mejorar el plan o contactar con tu proveedor de hosting es la solución definitiva.

4. Desactiva plugins de caché externa

Si usas un módulo de caché como Prestashop Cache o Memcached y no lo has configurado bien, puede generar un 503.

Accede a tu BackOffice.
Ve a Parámetros Avanzados > Rendimiento.
En la sección Almacenamiento en caché, selecciona No.

Si no puedes acceder, edita el archivo config/settings.inc.php (versiones antiguas) o app/config/parameters.php (versiones nuevas) y busca la configuración de la caché para desactivarla manualmente.

Cómo arreglar los Permisos de Archivos en PrestaShop

Los permisos archivos prestashop son fundamentales. Los permisos incorrectos son la causa número uno de errores 500 y de que no puedas subir imágenes o instalar módulos.

La regla de oro de los permisos

Carpetas (Directorios): Deben tener permisos 755.
Archivos: Deben tener permisos 644.

Existe una excepción: el archivo config/settings.inc.php (en versiones 1.6) o app/config/parameters.php (en versiones 1.7 y 8.x) a veces necesita permisos 444 (solo lectura) después de la instalación por seguridad.

Cómo cambiar los permisos desde cPanel

Entra en el Administrador de Archivos de cPanel.
Ve a la raíz de tu instalación de PrestaShop (normalmente public_html).
Haz clic en Seleccionar todo en la barra superior.
Haz clic en Permisos (en el menú superior).
Verás una ventana emergente. Introduce el valor 755 en el campo de permisos numéricos.
Marca la casilla Cambiar los archivos y carpetas dentro de este directorio de forma recursiva.
Haz clic en Cambiar permisos.

Esto cambiará todas las carpetas a 755 y todos los archivos a 644 automáticamente.

[WARNING]

PRECAUCIÓN: No ejecutes este cambio recursivo en todo public_html si tienes otras aplicaciones o archivos con permisos especiales (como backups cifrados o scripts de terceros). Es más seguro hacerlo solo dentro de la carpeta raíz de PrestaShop.

Permisos específicos para la carpeta de archivos

A veces, necesitas permisos más flexibles para que PrestaShop pueda subir imágenes o generar archivos de caché.

Busca la carpeta img y la carpeta var (o cache en versiones antiguas).
Haz clic derecho sobre la carpeta y selecciona Permisos.
Cambia los permisos de estas carpetas a 755 o incluso 775 si el propietario del servidor es diferente al tuyo.

Si después de esto sigues teniendo problemas para subir archivos, contacta con tu proveedor de hosting, ya que puede ser un problema de propiedad (ownership) del archivo.

Preguntas Frecuentes (FAQ) sobre errores de PrestaShop

¿Puedo solucionar el error 500 sin acceso al BackOffice de PrestaShop?

Sí, absolutamente. La mayoría de las soluciones que hemos visto se realizan desde cPanel, editando archivos o usando el Administrador de Archivos. El BackOffice es útil, pero no indispensable.

¿Qué hago si después de seguir todos los pasos el error 500 persiste?

Si has probado todo (modo debug, permisos, versión de PHP, desactivar módulos) y el error persiste, es muy probable que el problema sea un archivo corrupto de la instalación.

La solución definitiva: Descarga una copia limpia de la misma versión de PrestaShop que usas, descomprímela en tu ordenador y sube solo los archivos de la carpeta admin, config y src (o las carpetas que falten) mediante FTP o el Administrador de Archivos, sobrescribiendo los existentes. Esto repara los archivos dañados sin tocar tu base de datos ni tus productos.

¿Es seguro cambiar los permisos a 777?

Nunca uses permisos 777. Son un riesgo de seguridad enorme, ya que permiten que cualquiera en el servidor modifique tus archivos. Siempre usa 755 para carpetas y 644 para archivos. Si necesitas más flexibilidad, usa 775.

¿Cómo sé si mi versión de PrestaShop es compatible con mi versión de PHP?

Puedes verificar la compatibilidad en la documentación oficial de PrestaShop. Una regla general es:

PrestaShop 1.6 necesita PHP 5.6 o 7.0.
PrestaShop 1.7.6 y superiores necesitan PHP 7.1 o superior.
PrestaShop 8.x necesita PHP 7.3 o superior (idealmente 8.1).

Usar una versión de PHP demasiado nueva con una tienda vieja es una receta para el error 500.

¿Puede un plugin de caché causar el error 503?

Sí, es muy común. Un módulo de caché mal configurado (como Memcached o APC) puede hacer que tu tienda devuelva un 503. Desactivarlo desde el BackOffice o renombrando su carpeta en modules es la solución.

Consejos finales para mantener tu PrestaShop sano

Solucionar estos errores es el primer paso. Para evitar que vuelvan a ocurrir, te recomiendo seguir estos hábitos:

Mantén todo actualizado: PrestaShop, los módulos y los temas. Las actualizaciones corrigen errores y vulnerabilidades de seguridad.
Haz copias de seguridad frecuentes: Antes de tocar cualquier archivo, configura una copia de seguridad completa (archivos y base de datos) desde cPanel.
Desactiva los módulos que no uses: Cada módulo es una carga para el servidor y un posible conflicto.
Elige un buen hosting: Un hosting de calidad con soporte para PrestaShop te ahorrará muchos quebraderos de cabeza.

Esperamos que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave. Ve paso a paso, sin prisas, y con estas instrucciones podrás solucionar errores prestashop y volver a centrarte en lo que importa: vender tus productos.

Si tienes alguna otra duda, no dudes en consultar nuestra base de conocimientos o contactar con nuestro equipo de soporte. ¡Estamos aquí para ayudarte!