Solucionar error 500 en PrestaShop: Guía desde cPanel

¿Te ha aparecido de repente una pantalla en blanco o un mensaje de error 500 en tu tienda PrestaShop? No te preocupes, es uno de los problemas más comunes en el mundo del hosting y, afortunadamente, tiene solución. Este error suele ser una señal de que algo anda mal en la configuración del servidor o en algún archivo de tu tienda, pero con las herramientas que te ofrece cPanel, podrás diagnosticarlo y arreglarlo paso a paso.

En este artículo, te guiaré de forma sencilla y práctica para solucionar el error 500 en PrestaShop desde cPanel. Vamos a cubrir desde las causas más simples hasta las técnicas un poco más avanzadas, todo explicado como si estuviera a tu lado. Al final, tendrás tu tienda funcionando de nuevo y sabrás cómo evitar que esto vuelva a ocurrir.

¿Qué es exactamente el error 500 en PrestaShop?

El error 500, también conocido como "Internal Server Error", es un mensaje genérico que indica que el servidor web encontró un problema inesperado y no pudo procesar tu solicitud. En PrestaShop, esto puede deberse a múltiples factores: un plugin (módulo) conflictivo, un archivo .htaccess dañado, límites de memoria excedidos, permisos de archivos incorrectos o incluso un error en la versión de PHP.

Lo bueno es que, al trabajar desde cPanel, tienes acceso directo a los archivos del servidor y a herramientas como el visor de errores o el administrador de archivos, que te permitirán identificar la causa raíz.

Paso 1: Activar el modo debug de PrestaShop (la mejor pista)

Antes de tocar nada, lo más inteligente es obligar a PrestaShop a que te muestre el error específico. Por defecto, el error 500 es genérico, pero puedes hacer que tu tienda te dé más detalles.

¿Cómo activar el modo debug desde cPanel?

Accede a cPanel: Ingresa con tus credenciales (normalmente las que te dio tu proveedor de hosting).
Abre el Administrador de Archivos: Busca el icono "Administrador de archivos" o "File Manager". Te llevará a la raíz de tu cuenta.
Navega a la carpeta raíz de PrestaShop: Normalmente es public_html o una subcarpeta como tienda o shop. Busca el archivo llamado config/defines.inc.php.
Edita el archivo: Haz clic derecho sobre defines.inc.php y selecciona "Editar" o "Code Editor". Se abrirá un editor de texto.
Busca esta línea: Localiza define('_PS_MODE_DEV_', false);.
Cámbiala a true: Sustituye false por true. Debería quedar así: define('_PS_MODE_DEV_', true);.
Guarda los cambios: Haz clic en "Guardar cambios" o el botón correspondiente.

[INFO] Una vez activado el modo debug, al recargar tu tienda, en lugar de la pantalla en blanco, verás un mensaje de error detallado con el nombre del archivo problemático y la línea exacta. Anota ese mensaje, te será de gran ayuda.

Si después de esto no ves el error detallado, es posible que el problema esté en un nivel más profundo del servidor. Pero no te preocupes, los siguientes pasos te cubren.

Paso 2: Comprobar y reparar el archivo .htaccess

El archivo .htaccess es un archivo de configuración que controla el comportamiento del servidor web (Apache). Un error en este archivo es una de las causas más frecuentes del error 500 PrestaShop.

¿Cómo repararlo desde cPanel?

Ve al Administrador de Archivos nuevamente.
Localiza el archivo .htaccess: Está en la raíz de tu instalación de PrestaShop (junto a la carpeta config). Puede que esté oculto. Si no lo ves, en la parte superior derecha del Administrador de Archivos, marca la opción "Mostrar archivos ocultos" (Show Hidden Files).
Descárgalo como respaldo: Haz clic derecho sobre .htaccess y selecciona "Descargar". Guarda una copia en tu computadora por si acaso.
Elimínalo: Una vez descargado, selecciona el archivo y haz clic en "Eliminar" (Delete).
Regenera el .htaccess desde PrestaShop: Ahora, accede a tu panel de administración de PrestaShop (si es que puedes, aunque tengas el error, a veces el back-office funciona). Ve a Configuración avanzada > Rendimiento y haz clic en el botón "Guardar" (sin cambiar nada). Esto forzará a PrestaShop a crear un nuevo .htaccess limpio.
Prueba tu tienda: Si no puedes acceder al back-office, no te preocupes. Puedes forzar la regeneración manualmente. A veces, simplemente con eliminar el archivo y recargar la tienda, el servidor lo recrea automáticamente (aunque con configuraciones básicas).

[WARNING] Si tu tienda usa redirecciones personalizadas o reglas de SEO avanzadas, perderás esas configuraciones al eliminar el .htaccess. Por eso es importante descargar el original primero, para poder restaurarlo si es necesario.

Paso 3: Aumentar el límite de memoria PHP (memory_limit)

Otro culpable clásico del error 500 es que PrestaShop se queda sin memoria. Esto sucede especialmente si tienes muchos módulos activos o catálogos grandes.

¿Cómo aumentarlo desde cPanel?

Ve a la sección "Software" de cPanel. Busca "Seleccionar versión de PHP" o "MultiPHP Manager" (depende del hosting).
Selecciona tu dominio: Asegúrate de que estás configurando la versión de PHP para el dominio donde está instalado PrestaShop.
Busca la opción "memory_limit": Normalmente está en una lista desplegable o en un campo de texto.
Auméntalo: Cambia el valor de 128M o 256M a 512M o incluso 1024M (1 GB). No te preocupes, esto no afectará negativamente a tu servidor a menos que tengas recursos muy limitados.
Guarda los cambios: Haz clic en "Aplicar" o "Guardar".

[TIP] Si no encuentras la opción memory_limit, puedes crearla manualmente desde el Administrador de Archivos. Crea un archivo llamado php.ini en la raíz de tu PrestaShop y añade la línea: memory_limit = 512M. Luego, guarda el archivo.

Paso 4: Verificar los permisos de archivos y carpetas

Los permisos incorrectos pueden impedir que PrestaShop lea o escriba archivos, generando un error 500. Los permisos estándar para PrestaShop son:

Carpetas (directorios): 755 (lectura, escritura y ejecución para el usuario; lectura y ejecución para el resto).
Archivos: 644 (lectura y escritura para el usuario; solo lectura para el resto).
Carpetas especiales (como cache, img, themes, modules, override): 755 o 777 temporalmente para solucionar problemas de escritura.

¿Cómo corregirlos desde cPanel?

Selecciona toda la carpeta de tu tienda: En el Administrador de Archivos, marca la casilla junto a la carpeta raíz (ej. public_html).
Haz clic en "Permisos": En la barra de herramientas superior, verás un botón que dice "Permisos" o un icono de candado.
Configura los permisos: Una forma segura y rápida es cambiar todo a 755 (para directorios) y 644 (para archivos). Sin embargo, PrestaShop necesita que ciertas carpetas tengan permisos de escritura (777) para funcionar correctamente, especialmente cache, themes, modules y override.
Aplica los cambios: Marca la opción "Recursivo" para que se aplique a todas las subcarpetas y archivos.

[WARNING] No dejes las carpetas con permisos 777 de forma permanente, ya que es un riesgo de seguridad. Una vez que hayas solucionado el error, vuelve a cambiarlas a 755.

Paso 5: Desactivar módulos conflictivos (sin acceso al back-office)

Si el error apareció justo después de instalar un nuevo módulo, es muy probable que sea el culpable. Si no puedes acceder al back-office, puedes desactivar módulos manualmente desde cPanel.

¿Cómo desactivar módulos desde la base de datos?

Accede a phpMyAdmin: En cPanel, busca el icono de "phpMyAdmin" (dentro de la sección "Bases de datos").
Selecciona la base de datos de tu tienda: Normalmente tiene un nombre similar a tuusuario_prestashop.
Busca la tabla ps_modules: El prefijo ps_ puede variar si lo cambiaste durante la instalación. La tabla se llama [prefijo]_modules.
Ejecuta una consulta SQL: Haz clic en la pestaña "SQL" en la parte superior. Escribe la siguiente consulta para desactivar todos los módulos (esto es un poco drástico pero seguro):
```
UPDATE `ps_modules` SET `active` = 0 WHERE 1;
```
Reemplaza ps_ por tu prefijo real si es diferente.
Ejecuta la consulta: Haz clic en "Continuar". Esto desactivará todos los módulos.
Prueba tu tienda: Si el error desaparece, sabrás que uno de los módulos era el problema. Luego, desde el back-office, puedes ir activándolos uno por uno hasta encontrar el conflictivo.

Paso 6: Verificar la versión de PHP

PrestaShop es exigente con la versión de PHP. Usar una versión muy antigua o muy nueva puede causar errores 500. Las versiones recomendadas son:

PrestaShop 1.6: PHP 5.6 o 7.0 (aunque 7.1 puede funcionar, pero no es oficial).
PrestaShop 1.7: PHP 7.1, 7.2, 7.3 o 7.4. Evita PHP 8.x a menos que estés en la versión 8.1+ y con módulos actualizados.
PrestaShop 8.x: Soporta PHP 7.4, 8.0 y 8.1.

¿Cómo cambiar la versión de PHP desde cPanel?

Ve a "Seleccionar versión de PHP" (o "MultiPHP Manager").
Selecciona tu dominio.
Elige la versión adecuada según tu PrestaShop.
Guarda los cambios.

[INFO] Si tu hosting usa Syspanel (anteriormente HestiaCP), recuerda que el acceso es por el puerto 2106 (ejemplo: tudominio.com:2106). Una vez dentro, busca la sección "PHP" o "Configuración de PHP" para cambiar la versión.

Paso 7: Revisar el log de errores del servidor

Si todos los pasos anteriores fallan, el log de errores de Apache o de PHP te dará la respuesta definitiva.

¿Cómo acceder a los logs desde cPanel?

Busca la sección "Métricas" en cPanel. Haz clic en "Errores" o "Error Log".
Filtra por dominio: Selecciona tu dominio.
Busca la palabra "PHP Fatal error": Ahí verás el error exacto, por ejemplo: PHP Fatal error: Uncaught Error: Call to undefined function....
Interpreta el mensaje: Te dirá el archivo y la línea donde ocurre el error. Por ejemplo, si menciona un módulo específico, sabrás que debes desactivarlo o actualizarlo.

Preguntas Frecuentes (FAQ)

¿Por qué me aparece el error 500 después de una actualización de PrestaShop?

Es muy común. Las actualizaciones pueden dejar archivos obsoletos o cambiar la estructura de la base de datos. Te recomiendo seguir los pasos 1 (modo debug) y 5 (desactivar módulos). Además, verifica que todos los módulos y el tema sean compatibles con la nueva versión.

¿El error 500 puede deberse a un problema de hosting?

Sí, absolutamente. Un servidor sobrecargado, límites de recursos muy bajos o una mala configuración del servidor web pueden causarlo. Si después de todos los pasos el error persiste, contacta a tu proveedor de hosting y muéstrales los logs de errores.

¿Qué hago si no puedo acceder ni al back-office de PrestaShop?

No te preocupes, es normal. Puedes seguir todos los pasos desde cPanel (Administrador de Archivos, phpMyAdmin, etc.). El paso 5 (desactivar módulos desde la base de datos) es tu mejor aliado en este caso.

¿Es seguro activar el modo debug en una tienda en producción?

No, no lo es. El modo debug muestra información sensible del servidor a cualquier visitante. Actívalo solo para diagnosticar el error y, una vez resuelto, vuelve a cambiarlo a false en el archivo config/defines.inc.php.

Conclusión: Tu tienda PrestaShop volverá a la vida

El error 500 en PrestaShop puede ser frustrante, pero con las herramientas de cPanel y esta guía, tienes todas las herramientas para solucionarlo. Recuerda siempre empezar por lo más sencillo (modo debug, .htaccess) y luego ir a lo más técnico (módulos, PHP, logs).

Si has seguido todos los pasos y el error persiste, no dudes en contactar al soporte técnico de tu hosting. A veces, el problema está en un nivel del servidor al que no tienes acceso desde cPanel. Pero, en la mayoría de los casos, con un poco de paciencia y siguiendo estos pasos, tu tienda estará funcionando en minutos.

¡No te rindas! El mundo del hosting y el SEO tiene estos pequeños obstáculos, pero cada error que resuelves te hace más experto. Ahora, ve y arregla ese error 500.