Cómo solucionar errores 500 en PrestaShop desde cPanel

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, seguramente te has topado con la temida pantalla blanca o el mensaje "Error 500 Internal Server Error" en tu tienda PrestaShop. No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución.

En esta guía completa, vamos a desglosar paso a paso cómo solucionar error 500 PrestaShop usando cPanel. Te explicaré qué significa este error, por qué ocurre y, lo más importante, cómo identificarlo y arreglarlo tú mismo, incluso si no eres un experto en programación. Vamos a ello.

¿Qué es un Error 500 en PrestaShop?

Un error 500, también conocido como "Internal Server Error", es la forma que tiene tu servidor de decir: "Algo salió mal, pero no sé exactamente qué". Es un error genérico del lado del servidor. En el contexto de PrestaShop, puede aparecer como una pantalla en blanco, un mensaje de error genérico, o incluso un mensaje más detallado si tienes el modo debug activado.

Las causas más frecuentes son:

Problemas de permisos de archivos o carpetas: PrestaShop necesita permisos específicos para leer y escribir archivos.
Archivo .htaccess corrupto o incorrecto: Este archivo es crucial para las reglas de URL amigables y la seguridad.
Módulo o tema defectuoso: Una mala instalación o una incompatibilidad de un módulo puede romper todo el sitio.
Límite de memoria PHP excedido (memory_limit): Si tu tienda crece, puede necesitar más memoria de la que tiene asignada por defecto.
Versión de PHP incorrecta: PrestaShop requiere una versión específica de PHP para funcionar.
Archivos del núcleo de PrestaShop corruptos: Una actualización fallida puede dejar archivos dañados.

Primeros Pasos: Acceder a cPanel y Preparar el Entorno

Antes de empezar a hacer cambios, necesitas acceder a tu panel de control. Como usamos cPanel, el proceso es sencillo.

Accede a tu cPanel: Normalmente es tudominio.com/cpanel o tudominio.com:2083. Usa tus credenciales de hosting.
Localiza el administrador de archivos: Busca el icono de "Administrador de Archivos" (File Manager). Generalmente está en la sección "Archivos".
Navega a la raíz de tu tienda: Dentro del administrador de archivos, busca la carpeta donde está instalado PrestaShop. Normalmente es public_html o una subcarpeta como public_html/tienda.

[WARNING]: Antes de modificar cualquier archivo, siempre haz una copia de seguridad. Puedes descargar una copia del archivo que vas a editar o, mejor aún, hacer un backup completo de tu sitio desde cPanel (sección "Backup").

Paso 1: Activar el Modo Debug de PrestaShop (La Clave para Ver el Error Real)

El error 500 es genérico. Para solucionar error 500 PrestaShop, necesitamos que PrestaShop nos dé más detalles. Esto se hace activando el modo debug.

En el Administrador de Archivos de cPanel, busca el archivo config/defines.inc.php.
Haz clic derecho sobre él y selecciona "Editar" o "Code Editor". Se abrirá un editor de texto.
Busca la línea que dice:
define('_PS_MODE_DEV_', false);
Cámbiala por:
define('_PS_MODE_DEV_', true);
Si ya existe, asegúrate de que sea true.
Guarda los cambios (botón "Save Changes").
Ahora, recarga tu tienda. En lugar de la pantalla blanca, verás un mensaje de error mucho más descriptivo, como:
- "Fatal error: Allowed memory size of X bytes exhausted..." (Problema de memoria)
- "Fatal error: Uncaught Error: Class 'X' not found..." (Módulo o archivo faltante)
- "Parse error: syntax error, unexpected..." (Error de sintaxis en algún archivo)

[INFO]: Una vez que hayas solucionado el error, no olvides volver a poner _PS_MODE_DEV_ en false. Dejarlo activo en producción puede mostrar información sensible a los visitantes.

Paso 2: Revisar los Logs de Errores de PHP (cPanel)

Si el modo debug no te da suficiente información, o si prefieres un enfoque más técnico, puedes revisar los logs de errores PrestaShop directamente desde cPanel.

En cPanel, busca la sección "Métricas" o "Registros".
Haz clic en "Errores" o "Registro de errores" (a veces se llama "Error Log" o "Apache Error Log").
Verás una lista de los errores más recientes. Busca líneas que contengan la fecha y hora en que empezó el problema. Normalmente verás algo como:
[Wed Oct 25 10:00:00.123456 2023] [php:error] [pid 12345] [client IP] PHP Fatal error: ...
El mensaje después de "PHP Fatal error" te dirá exactamente qué archivo y línea están causando el problema.

[TIP]: Si el log es muy grande, puedes filtrar por "prestashop" o "500" para encontrar más rápido lo que buscas.

Paso 3: Soluciones Comunes Según el Error Detectado

Ahora que tienes más información, vamos a las soluciones más habituales.

### 3.1. Problema de Límite de Memoria PHP (memory_limit)

Síntoma en debug: Fatal error: Allowed memory size of 134217728 bytes exhausted...
Solución: Aumentar el límite de memoria.

En cPanel, busca la sección "Software" y haz clic en "Seleccionar versión de PHP" (o "MultiPHP Manager").
Verás una lista de opciones. Busca "memory_limit".
Auméntalo a un valor mayor, por ejemplo, de 128M a 256M o incluso 512M si tu hosting lo permite.
Haz clic en "Apply" o "Guardar".
Si no puedes cambiarlo desde ahí, puedes crear un archivo php.ini en la raíz de tu tienda con el siguiente contenido:
memory_limit = 256M
(A veces también funciona modificando el archivo .htaccess).

### 3.2. Problema con el archivo .htaccess

Síntoma: El error aparece al activar o desactivar URL amigables, o al instalar un módulo de SEO.
Solución: Regenerar el archivo .htaccess desde el back office de PrestaShop.

Accede a tu back office de PrestaShop (si puedes, aunque a veces el error 500 lo impide). Si no puedes, tendrás que hacerlo manualmente.
Ve a "Configuración de la tienda" > "Tráfico y SEO" > "URLs amigables".
Sin cambiar nada, haz clic en "Guardar". Esto regenera el archivo .htaccess automáticamente.
Si no puedes acceder al back office, desde cPanel:
- En el Administrador de Archivos, busca el archivo .htaccess en la raíz de tu tienda.
- Renómbralo a htaccess_old (esto lo desactiva temporalmente).
- Recarga tu tienda. Si el error 500 desaparece, el problema era el .htaccess.
- Para regenerarlo, puedes crear un nuevo archivo .htaccess con el contenido básico que proporciona PrestaShop (puedes encontrarlo en la documentación oficial) o, mejor, intenta acceder al back office y guardar la configuración de URLs.

### 3.3. Módulo o Tema Defectuoso

Síntoma: El error comenzó justo después de instalar/actualizar un módulo o tema.
Solución: Deshabilitar o eliminar el módulo/tema problemático.

Desde el back office (si puedes acceder):
- Ve a "Módulos" > "Gestor de módulos".
- Busca el módulo sospechoso y haz clic en "Desinstalar" o "Desactivar".
Si no puedes acceder al back office, tendrás que hacerlo desde cPanel:
- En el Administrador de Archivos, navega a modules/.
- Busca la carpeta del módulo problemático (por ejemplo, modules/nombredelmodulo).
- Renómbrala a nombredelmodulo_desactivado. Esto hará que PrestaShop no lo cargue.
- Si el error era del tema, renombra la carpeta del tema en themes/ a tema_desactivado. PrestaShop usará el tema por defecto (si existe).

### 3.4. Permisos de Archivos Incorrectos

Síntoma: Errores de escritura o lectura, o el error 500 aparece al subir productos o imágenes.
Solución: Restablecer los permisos correctos.

En el Administrador de Archivos de cPanel, selecciona todos los archivos y carpetas de tu tienda.
Haz clic en "Permisos" (o "Change Permissions").
Aplica los siguientes permisos estándar de PrestaShop:
- Carpetas (directorios): 755 (rwx r-x r-x)
- Archivos: 644 (rw- r-- r--)
- Archivos especiales (como config/defines.inc.php y settings.inc.php): A veces necesitan 444 para evitar escritura no deseada.
- Carpetas cache/, log/, img/, upload/, download/, themes/: A veces necesitan 777 para que PrestaShop pueda escribir en ellas (por ejemplo, al generar miniaturas). OJO: 777 es un riesgo de seguridad, úsalo solo temporalmente.

[WARNING]: No pongas todos los archivos a 777. Es muy inseguro. Sigue la regla general: carpetas 755, archivos 644.

Paso 4: Soluciones Avanzadas (Si lo Anterior No Funciona)

Si después de todo lo anterior el error persiste, prueba estas opciones.

### 4.1. Forzar una Versión de PHP Compatible

PrestaShop 1.6 funciona mejor con PHP 5.6 o 7.0. PrestaShop 1.7 y 8.x necesitan PHP 7.1 o superior (idealmente 7.4 u 8.0, según la versión).

En cPanel, ve a "Seleccionar versión de PHP".
Elige una versión recomendada para tu PrestaShop (por ejemplo, 7.4 para PS 1.7).
Aplica los cambios.

### 4.2. Restaurar Archivos del Núcleo (Core)

Si sospechas que un archivo del núcleo está corrupto, puedes sobrescribirlo con una copia limpia de la misma versión de PrestaShop.

Descarga la misma versión de PrestaShop desde el sitio oficial.
Descomprime el archivo en tu ordenador.
Sube solo las carpetas admin/, classes/, controllers/, core/, tools/ (o las que creas necesarias) a tu servidor, sobrescribiendo las existentes. No subas la carpeta themes/ ni modules/ para no perder personalizaciones.

[TIP]: Si no estás seguro de qué archivos subir, es mejor contactar con el soporte de tu hosting o con un desarrollador.

Preguntas Frecuentes (FAQ)

P: ¿Puedo solucionar el error 500 sin entrar al back office?
R: Sí, la mayoría de las soluciones se pueden hacer desde cPanel (Administrador de Archivos, logs de errores, etc.).

P: ¿El error 500 puede deberse a mi hosting?
R: Sí, a veces el servidor está sobrecargado o tiene una configuración incorrecta. Si has probado todo, contacta a tu proveedor de hosting.

P: ¿Qué hago si no veo ningún error en los logs?
R: Asegúrate de que el modo debug esté activado. A veces los logs de errores de PHP están desactivados en el servidor. Pide a tu hosting que los active.

P: ¿Usas Syspanel? (Mencionado por regla)
R: Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es similar, pero accederás a través del puerto 2106 (ejemplo: tudominio.com:2106). Dentro, busca "Administrador de Archivos" y "Logs de Errores". Las soluciones son las mismas.

Resumen Final y Consejos

Solucionar error 500 PrestaShop puede parecer complicado, pero siguiendo esta guía paso a paso, podrás resolverlo en la mayoría de los casos. Recuerda:

Activa el modo debug para ver el error real.
Revisa los logs de errores de cPanel.
Prueba las soluciones una por una (memoria, .htaccess, módulos, permisos).
Siempre haz copias de seguridad antes de modificar archivos.

Si después de todo el error sigue apareciendo, no dudes en contactar al soporte técnico de tu hosting. Ellos tienen acceso a herramientas más profundas del servidor.

Espero que esta guía te haya sido de gran ayuda. ¡Tu tienda volverá a funcionar en poco tiempo!