Errores comunes de PrestaShop en cPanel y cómo solucionarlos

¿Por qué aparecen errores en PrestaShop al usar cPanel?

Si tienes una tienda online con PrestaShop, es muy probable que en algún momento te encuentres con pantallas en blanco, mensajes de error o incluso la imposibilidad de acceder a tu panel de administración. No te preocupes, es mucho más común de lo que parece y, en la gran mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto.

En esta guía completa, vamos a desglosar los errores PrestaShop cPanel más habituales, centrándonos en el temido error 500 PrestaShop, los errores 503 y los fallos durante la instalación. Aprenderás a diagnosticar cada problema paso a paso y a aplicar las soluciones de forma segura, siempre desde tu panel de control de cPanel.

Vamos a ello. Respira hondo, porque al final de este artículo serás capaz de resolver la mayoría de estos contratiempos por ti mismo.

Entendiendo los errores: 500 vs 503

Antes de lanzarnos a solucionar, es crucial entender qué significa cada error. Aunque ambos son "errores de servidor", tienen orígenes y soluciones muy diferentes.

Error 500 (Internal Server Error)

El error 500 PrestaShop es, probablemente, el más frustrante. Indica que algo ha salido mal en el servidor, pero no te dice exactamente qué. Es un error genérico que puede deberse a:

Permisos de archivos incorrectos: Es la causa más común. Si los archivos de tu tienda tienen permisos demasiado restrictivos o demasiado permisivos, el servidor no puede leerlos o ejecutarlos correctamente.
Archivo .htaccess corrupto: PrestaShop utiliza este archivo para configurar reglas de reescritura de URL y redirecciones. Si está dañado o tiene reglas incompatibles, provocará un error 500.
Problemas de memoria PHP: Si tu tienda necesita más memoria de la que el servidor le permite usar, se detendrá y mostrará este error.
Errores en los módulos o temas: Un módulo o tema mal codificado o con conflictos puede romper toda la tienda.
Versiones incompatibles de PHP: PrestaShop necesita una versión específica de PHP. Si tu servidor usa una versión demasiado nueva o demasiado antigua, fallará.

Error 503 (Service Unavailable)

El error 503 significa que el servidor está disponible, pero no puede atender tu solicitud en ese momento. En el contexto de PrestaShop, suele deberse a:

Modo mantenimiento: Si alguien (o tú mismo) activó el modo mantenimiento, el servidor devolverá un 503 a los visitantes.
Sobrecarga del servidor: Si tu sitio recibe demasiado tráfico o un script está consumiendo muchos recursos, el servidor puede rechazar temporalmente las conexiones.
Problemas con el firewall o mod_security: A veces, el firewall del servidor bloquea ciertas peticiones, mostrando un 503.

Solucionar el Error 500 en PrestaShop desde cPanel

Vamos a la acción. Sigue estos pasos en orden, ya que van de lo más simple a lo más complejo.

Paso 1: Activar el modo de depuración (Debug Mode)

PrestaShop tiene un modo de depuración que muestra el error real en lugar de la pantalla genérica de "500". Esto te dará pistas inmediatas sobre el problema.

Para activarlo, necesitas acceder al archivo de configuración principal. Puedes hacerlo desde el Administrador de archivos de cPanel.

Entra en tu cPanel y busca la sección Archivos.
Haz clic en Administrador de archivos y navega hasta la carpeta raíz de tu instalación de PrestaShop (normalmente public_html).
Busca el archivo llamado config/defines.inc.php.
Haz clic derecho sobre él y selecciona Editar. Si el sistema te pide confirmación, acéptala.
Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cambia false por true. Debe quedar así: define('_PS_MODE_DEV_', true);.
Guarda los cambios y cierra el editor.

Ahora recarga tu tienda. En lugar del error 500, verás un mensaje de error detallado en pantalla. Anota ese mensaje, te será muy útil para los siguientes pasos. Cuando termines de diagnosticar, recuerda volver a poner false para no mostrar información sensible a los visitantes.

[WARNING] No dejes el modo depuración activado en una tienda en producción. Expone rutas de archivos y consultas SQL que un atacante podría aprovechar.

Paso 2: Corregir los permisos de archivos y carpetas

Los permisos incorrectos son la causa número uno del error 500. En cPanel, los permisos estándar para PrestaShop deben ser:

Archivos: 644
Carpetas: 755

Para corregirlos de forma masiva:

Ve al Administrador de archivos y navega a la raíz de tu PrestaShop.
Selecciona todos los archivos y carpetas (puedes usar Ctrl + A o el botón de seleccionar todo).
Haz clic en Permisos en la barra superior.
Introduce 644 en el campo de permisos para archivos y 755 para carpetas.
Marca la casilla Cambiar de forma recursiva (o similar) para que se aplique a todos los subdirectorios y archivos.
Haz clic en Cambiar permisos.

[TIP] Si los permisos ya eran correctos, también puedes intentar cambiar la propiedad (owner) de los archivos a tu usuario de cPanel. Esto se puede hacer con el comando chown en la terminal, pero si no te sientes cómodo, contacta con tu proveedor de hosting.

Paso 3: Regenerar el archivo .htaccess

Un archivo .htaccess dañado es otro culpable frecuente. La forma más segura de solucionarlo es regenerarlo desde el panel de administración.

Antes de nada, haz una copia de seguridad del archivo .htaccess actual. En el Administrador de archivos, haz clic derecho sobre él y selecciona Copiar o Descargar.
Ahora, borra el archivo .htaccess de la carpeta raíz. No te preocupes, PrestaShop lo creará de nuevo.
Intenta acceder a tu tienda y a tu panel de administración (/admin). Si puedes acceder al panel, ve a Parámetros Avanzados > Rendimiento y haz clic en el botón Guardar (o "Actualizar"). Esto forzará la regeneración del archivo .htaccess.
Si no puedes acceder al panel, contacta con tu soporte de hosting, ya que puede que necesites regenerar el archivo manualmente con un código básico.

Paso 4: Aumentar el límite de memoria PHP

Si el error persiste, puede que tu tienda necesite más memoria.

En cPanel, busca la sección Software y haz clic en Seleccionar versión de PHP (o "MultiPHP Manager").
Ajusta la versión de PHP a una recomendada por PrestaShop (normalmente 7.4, 8.0 o 8.1, dependiendo de la versión de tu tienda).
A continuación, busca la opción Configuración de PHP o Opciones de PHP (a veces es un icono con una rueda dentada junto a la versión de PHP).
Busca la directiva memory_limit y cámbiala a un valor más alto, por ejemplo 256M o incluso 512M.
Guarda los cambios y comprueba si el error se ha solucionado.

Resolviendo el Error 503 en PrestaShop

El error 503 es menos intimidante. Generalmente, la solución es más directa.

Solución 1: Desactivar el modo mantenimiento

Si tu tienda está en modo mantenimiento, los visitantes verán un 503. Para desactivarlo:

Accede a tu panel de administración de PrestaShop.
Ve a Parámetros Avanzados > Mantenimiento.
En "Activar el modo mantenimiento", selecciona No.
Guarda los cambios.

Si no puedes acceder al panel, puedes desactivarlo desde la base de datos. En cPanel, abre phpMyAdmin, selecciona la base de datos de tu tienda y busca la tabla ps_shop_url o ps_configuration. Busca la configuración llamada PS_SHOP_ENABLE y cámbiala a 1.

[INFO] Si usas un panel alternativo como Syspanel, el proceso es el mismo. Recuerda que para acceder a Syspanel, debes usar el puerto 2106 (por ejemplo, http://tu-dominio.com:2106).

Solución 2: Desactivar módulos conflictivos

A veces, un módulo específico causa un bucle o consume demasiados recursos, provocando el 503.

Desde el panel de administración, ve a Módulos > Gestor de Módulos.
Desactiva los módulos uno por uno (especialmente los que hayas instalado recientemente) y comprueba si la tienda vuelve a funcionar.

Si no tienes acceso al panel, tendrás que hacerlo desde la base de datos. En phpMyAdmin, busca la tabla ps_module. Puedes cambiar el estado de los módulos a 0 (desactivado) en la tabla ps_module_shop.

Fallos comunes en la instalación de PrestaShop en cPanel

Instalar PrestaShop en cPanel suele ser sencillo con el instalador automático de Softaculous. Sin embargo, a veces falla.

Problema: El instalador se queda atascado en "Configurando..."

Esto suele deberse a que la carpeta config no tiene permisos de escritura.

Ve al Administrador de archivos y localiza la carpeta config en tu instalación de PrestaShop.
Haz clic derecho y selecciona Permisos.
Cambia los permisos a 755 o incluso 777 temporalmente durante la instalación.
Una vez terminada la instalación, vuelve a cambiarlos a 755.

[WARNING] Nunca dejes los permisos en 777 de forma permanente. Es un riesgo de seguridad grave.

Problema: "El archivo de configuración no es escribible"

Este error indica que PrestaShop no puede escribir el archivo settings.inc.php.

Ve a la carpeta config en el Administrador de archivos.
Busca el archivo settings.inc.php.
Cambia sus permisos a 644 (o 666 durante la instalación).
Después de la instalación, puedes dejarlo en 444 (solo lectura) para mayor seguridad.

Problema: Base de datos no creada

Asegúrate de haber creado una base de datos MySQL y un usuario con todos los privilegios en cPanel antes de iniciar la instalación. En la sección Bases de datos MySQL, crea la base de datos, el usuario y asigna el usuario a la base de datos con TODOS LOS PRIVILEGIOS.

Preguntas Frecuentes (FAQ)

¿Por qué veo un error 500 después de cambiar la versión de PHP?

Es muy común. Al cambiar la versión de PHP, algunos módulos o temas pueden ser incompatibles. Vuelve a la versión anterior o actualiza tus módulos y temas a versiones compatibles con la nueva versión de PHP.

¿Cómo puedo saber la versión de PHP que usa mi PrestaShop?

Puedes verlo en Parámetros Avanzados > Información en tu panel de administración. También puedes crear un archivo info.php con el contenido <?php phpinfo(); ?> en la raíz de tu tienda y abrirlo en el navegador. Recuerda borrarlo después.

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

Si no puedes acceder al panel, tendrás que trabajar directamente con los archivos y la base de datos desde cPanel. Sigue los pasos de la sección del error 500, especialmente el de activar el modo depuración, para obtener más información sobre el error.

¿Debo usar Softaculous para instalar PrestaShop?

Sí, es la opción más recomendable para principiantes. Es rápido, automático y configura la mayoría de los parámetros por ti. Si prefieres una instalación manual, asegúrate de seguir la guía oficial de PrestaShop.

¿Qué es mod_security y cómo puede causar errores?

mod_security es un módulo de seguridad del servidor que analiza las peticiones HTTP en busca de ataques. A veces, puede dar falsos positivos y bloquear acciones legítimas, como guardar un producto o configurar un módulo. Puedes intentar desactivarlo temporalmente desde cPanel (si tu proveedor lo permite) o contactar con tu soporte para añadir una excepción.

Con esta guía, ya tienes las herramientas para enfrentarte a los errores PrestaShop cPanel más comunes. Recuerda siempre hacer una copia de seguridad de tu tienda antes de realizar cambios importantes, y si te sientes abrumado, no dudes en contactar con el soporte de tu hosting. Son expertos en solución problemas PrestaShop y podrán ayudarte de forma remota.