Solucionar error 500 en PrestaShop cPanel | Guía Rápida

¡Vaya! Te has encontrado con el temido error 500 en PrestaShop. Esa pantalla en blanco o ese mensaje genérico de "Error interno del servidor" puede ser frustrante, especialmente cuando tu tienda online está en pleno funcionamiento. Pero no te preocupes, como técnico de soporte amigable, estoy aquí para guiarte paso a paso.

Este error es un "comodín" del servidor, lo que significa que no te dice exactamente qué falla, pero sí te da pistas de dónde buscarlo. Generalmente, la causa está en un archivo de configuración corrupto, un módulo incompatible, un problema de permisos o un límite de memoria excedido. Vamos a desgranar las soluciones más efectivas para solucionar error 500 cPanel y que tu tienda vuelva a la vida.

Primero lo primero: Accede a tu cPanel

Para empezar a trabajar, necesitas entrar al panel de control de tu hosting. Si tu proveedor usa cPanel (el más común), la URL suele ser algo como tudominio.com/cpanel o te la proporcionaron en el email de bienvenida.

[INFO] Si tu hosting usa Syspanel (anteriormente conocido como HestiaCP), el acceso se realiza a través del puerto 2106. Por ejemplo: tudominio.com:2106. El proceso de solución es muy similar.

Una vez dentro, busca la sección de Archivos. Ahí es donde haremos la mayor parte de la magia.

Paso 1: Activa el modo debug de PrestaShop (La clave)

El error 500 es mudo. Para que hable, debemos hacer que PrestaShop nos muestre el error real. Esto se hace mediante el modo debug. Hay dos formas de hacerlo: a través del archivo de configuración (la más fiable) o desde el back office (si aún tienes acceso).

Método A: Editando el archivo defines.inc.php (Recomendado)

En tu cPanel, entra al Administrador de Archivos.
Navega hasta la carpeta donde está instalado PrestaShop (normalmente public_html o una subcarpeta como /tienda).
Busca la carpeta config y dentro de ella, el archivo defines.inc.php.
Haz clic derecho sobre el archivo y selecciona Editar (o "Edit").
Busca la línea que dice: define('_PS_MODE_DEV_', false);
Cámbiala por: define('_PS_MODE_DEV_', true);
Importante: Justo debajo de esa línea, añade esta otra para que los errores se muestren en pantalla:
define('_PS_MODE_DEV_', true);
ini_set('display_errors', 'on');
Guarda los cambios. Ahora, al recargar tu tienda, en lugar del error 500, verás un mensaje de error PHP descriptivo (por ejemplo, "Fatal error: Allowed memory size exhausted..." o "Parse error: syntax error..."). Anota ese mensaje, nos será muy útil.

[WARNING] No dejes el modo debug activado para siempre. Una vez solucionado el error, vuelve a poner define('_PS_MODE_DEV_', false);. Dejarlo activo en producción expone información sensible de tu servidor.

Método B: Desde el Back Office (Si tienes acceso)

Si milagrosamente aún puedes acceder al panel de administración de tu tienda (ej: tudominio.com/admin1234):

Ve a Parámetros Avanzados > Rendimiento.
En la sección Depuración, activa la opción "Depurar el modo no en producción".
Guarda. Esto también forzará la visualización de errores.

Paso 2: Soluciones rápidas para el error 500 en PrestaShop

Ya tienes el mensaje de error (o no, pero probaremos soluciones genéricas). Aquí tienes las causas más comunes y cómo arreglar error 500 PrestaShop:

1. Límite de memoria PHP excedido (El más común)

Si ves un error como "Allowed memory size of X bytes exhausted", tu tienda necesita más memoria para funcionar.

Cómo solucionarlo:

Desde cPanel: Busca la sección Software > Select PHP Version. Una vez dentro, haz clic en Switch to PHP Options.
Busca la opción memory_limit. Auméntala a 256M o incluso 512M.
Guarda los cambios.
Desde .htaccess (alternativa): Si no encuentras la opción en cPanel, puedes añadir esta línea al archivo .htaccess en la raíz de tu PrestaShop:
php_value memory_limit 256M

2. Archivos .htaccess corruptos o incorrectos

PrestaShop genera un archivo .htaccess automáticamente. A veces, al desactivar un módulo de SEO o hacer cambios manuales, este archivo se daña.

Cómo solucionarlo:

En el Administrador de Archivos de cPanel, ve a la carpeta raíz de tu tienda.
Busca el archivo .htaccess. Antes de tocarlo, descarga una copia de seguridad (haz clic derecho > "Download").
Ahora, elimina el archivo .htaccess original.
Ve al Back Office de PrestaShop (si puedes acceder) a Parámetros de la tienda > Tráfico y SEO > SEO & URLs.
Sin cambiar nada, haz clic en el botón Guardar. Esto regenerará el .htaccess de forma limpia.
Si no puedes acceder al back office, renombra el archivo a .htaccess_old y prueba a cargar la tienda. Si funciona, el problema era ese. Luego deberás regenerarlo manualmente o desde la base de datos.

3. Módulos o temas incompatibles

Un módulo recién instalado o actualizado puede estar causando un conflicto mortal.

Cómo solucionarlo:

La forma drástica: Renombra la carpeta modules a modules_old y la carpeta themes a themes_old. Crea una carpeta themes nueva y dentro mete el tema por defecto de PrestaShop (por ejemplo, "classic"). Si la tienda carga, el problema está en un módulo o tema. Luego, ve restaurando las carpetas originales de uno en uno para identificar al culpable.
La forma quirúrgica (si tienes acceso al back office): Ve a Módulos > Catálogo de módulos. Busca el módulo sospechoso y desactívalo. Si no sabes cuál es, desactívalos todos y actívalos de uno en uno.

4. Permisos de archivos y carpetas incorrectos

Los archivos de PrestaShop necesitan permisos específicos para que el servidor web los lea y escriba.

Cómo solucionarlo:

En el Administrador de Archivos, selecciona TODA la carpeta de tu tienda (ej: public_html).
Haz clic derecho y selecciona Cambiar permisos.
Marca las casillas para que quede así:
- Carpetas: 755 (rwx r-x r-x)
- Archivos: 644 (rw- r-- r--)
Aplica los cambios recursivamente (a todas las subcarpetas y archivos).

[TIP] Si no ves la opción de cambiar permisos, puede que tu hosting tenga restricciones. Contacta con tu proveedor de hosting para que lo hagan ellos.

Paso 3: Soluciones avanzadas (Cuando nada funciona)

Si después de todo lo anterior el error 500 PrestaShop persiste, toca ir un paso más allá.

1. Aumentar el límite de tiempo de ejecución (max_execution_time)

A veces, una tarea pesada (como una importación o una actualización) se ejecuta durante mucho tiempo y el servidor la corta.

En el Select PHP Version de cPanel, busca max_execution_time y cámbialo a 300 (5 minutos).

2. Revisar los logs del servidor (La fuente de la verdad)

Los logs de error del servidor son el diario de a bordo. Te dirán exactamente qué archivo y línea causan el error.

En cPanel, busca la sección Métricas > Errores o Logs > Error Log.
Busca las líneas más recientes que contengan "PHP Fatal error" o "PrestaShop". Anota la ruta del archivo y el número de línea. Esa es tu pista.

3. Desactivar todos los módulos por base de datos (Último recurso)

Si el error te impide incluso entrar al back office, puedes desactivar todos los módulos desde la base de datos.

En cPanel, busca Bases de datos > phpMyAdmin.
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_modules (el prefijo ps_ puede ser diferente).
Haz clic en SQL (o "Consultas").
Ejecuta esta consulta SQL:
UPDATE ps_modules SET active = 0 WHERE active = 1;
Esto desactivará todos los módulos. Luego, intenta acceder a tu tienda. Si funciona, el problema está en un módulo. Tendrás que reactivarlos uno por uno desde el back office.

FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop

P: ¿El error 500 puede deberse a mi proveedor de hosting?
R: Sí, absolutamente. A veces el servidor está sobrecargado, tiene una configuración incorrecta o está realizando mantenimiento. Si has probado todo, contacta a tu soporte de hosting y diles: "Tengo un error 500 en mi PrestaShop, ya revisé .htaccess, permisos y memoria, ¿pueden revisar los logs del servidor?".

P: ¿Pierdo mis datos si elimino el archivo .htaccess?
R: No. Lo único que puedes perder son reglas de redirección personalizadas (como las de SEO). Pero el archivo se regenera automáticamente al guardar la configuración de URLs en el back office. Siempre haz una copia de seguridad antes.

P: Mi tienda está en Syspanel (HestiaCP), ¿cómo accedo al Administrador de Archivos?
R: En Syspanel, el acceso es por puerto 2106. Una vez dentro, busca la sección de "Archivos" o "Administrador de archivos". El resto del proceso (editar defines.inc.php, cambiar permisos, etc.) es idéntico al de cPanel.

P: Después de arreglar el error, la tienda carga muy lenta. ¿Qué hago?
R: Activar el modo debug consume recursos. Asegúrate de haberlo desactivado (poner define('_PS_MODE_DEV_', false);). Además, limpia la caché de PrestaShop desde Parámetros Avanzados > Rendimiento > Forzar compilación y Limpiar caché.

Resumen final: Tu checklist para la calma

Para solucionar error 500 cPanel en PrestaShop, sigue este orden:

Activar modo debug (defines.inc.php) para ver el error real.
Aumentar memory_limit a 256M o 512M.
Eliminar y regenerar .htaccess.
Desactivar módulos (desde back office o por base de datos).
Revisar permisos de archivos y carpetas (755/644).
Consultar los logs de error del servidor.
Contactar a tu hosting si nada funciona.

No tengas miedo de meterte en el Administrador de Archivos de cPanel. Con una copia de seguridad de por medio (siempre es buena idea), puedes probar estas soluciones sin riesgo de perder tu tienda. ¡Ánimo, que ese error 500 no puede con tu negocio online!