Solucionar error 500 en PrestaShop cPanel - Causas y soluciones

¡Hola! Soy el técnico de soporte de confianza. Si estás leyendo esto, es porque probablemente te has topado con el temido error 500 en PrestaShop. No te preocupes, es uno de los problemas más comunes y, con esta guía, lo solucionaremos paso a paso. Vamos a desglosar qué significa, por qué aparece y cómo arreglarlo desde tu panel de control cPanel.

Este artículo está diseñado para que, incluso si no eres un experto técnico, puedas seguir las instrucciones y dejar tu tienda funcionando de nuevo.

¿Qué es el error 500 en PrestaShop?

El error 500, también conocido como "Error interno del servidor", es la forma que tiene tu servidor web de decir: "Algo salió mal, pero no sé exactamente qué". Es un error genérico, lo que significa que la causa puede ser desde un simple archivo de configuración dañado hasta un problema de permisos o un módulo incompatible.

En el contexto de PrestaShop, este error suele aparecer cuando:

El archivo .htaccess está corrupto o mal configurado.
Un módulo o tema que instalaste recientemente está causando un conflicto.
Los permisos de archivos y carpetas no son los correctos.
Hay un problema con la memoria PHP (límite de memoria o tiempo de ejecución).
El archivo settings.inc.php o config/defines.inc.php tiene errores.

No entres en pánico. Vamos a atacar cada posible causa una por una. La clave está en solucionar error 500 de forma metódica.

Requisitos previos: Acceso a cPanel

Antes de empezar, asegúrate de tener acceso a tu panel de control cPanel. Necesitarás:

Tu nombre de usuario y contraseña de cPanel.
Acceso al Administrador de archivos (File Manager).
Acceso a PHP Selector o MultiPHP Manager (para ajustar la configuración de PHP).

Si en lugar de cPanel usas Syspanel (antes conocido como HestiaCP), el proceso es similar, pero accedes por el puerto 2106 (ejemplo: tudominio.com:2106). El resto de la guía es aplicable, solo cambia la ubicación de las herramientas.

Paso 1: Activar el modo debug de PrestaShop (La clave para saber qué ocurre)

El error 500 es mudo. Para que nos hable, necesitamos activar el modo debug de PrestaShop. Esto mostrará el error real en pantalla (como un error de PHP o de base de datos) en lugar de la página en blanco.

¿Cómo hacerlo?

Ingresa a tu cPanel y abre el Administrador de archivos.
Navega a la carpeta raíz de tu tienda PrestaShop (normalmente public_html o una subcarpeta).
Busca el archivo config/defines.inc.php.
Haz clic derecho sobre él y selecciona Editar (o "Edit").
Dentro del archivo, busca la línea que dice:
```
define('_PS_MODE_DEV_', false);
```
Cámbiala por:
```
define('_PS_MODE_DEV_', true);
```
(Si no existe, puedes añadirla al final del archivo, antes del ?> o al final del todo).
Guarda los cambios (Ctrl+S o botón Guardar).
Ahora, recarga tu tienda. En lugar del error 500, verás un mensaje de error más específico, como:
- Fatal error: Allowed memory size of X bytes exhausted (problema de memoria).
- Parse error: syntax error, unexpected... (error en un archivo PHP).
- Un error de SQL (base de datos).

Guarda ese mensaje, nos ayudará a identificar la causa.

[INFO] Si después de activar el modo debug tu tienda sigue mostrando el error 500 sin mensaje, es posible que el problema esté en el .htaccess o en los permisos. Continúa con el siguiente paso.

Paso 2: Regenerar el archivo .htaccess (Causa #1 de error 500)

El archivo .htaccess es el manual de instrucciones de tu servidor web. Si se daña, el servidor no sabe cómo manejar las peticiones y lanza el error 500.

Para regenerarlo:

En el Administrador de archivos de cPanel, ve a la carpeta raíz de tu tienda.
Busca el archivo .htaccess (puede estar oculto. Si no lo ves, en la esquina superior derecha del administrador de archivos, haz clic en Configuración y marca la opción "Mostrar archivos ocultos (dotfiles)").
Haz clic derecho sobre .htaccess y selecciona Renombrar.
Cambia el nombre a algo como .htaccess_old. Esto lo desactivará.
Ahora, ve a tu Panel de administración de PrestaShop (intenta acceder a tudominio.com/adminXXXXX). Si no puedes, usa el siguiente truco:
- Desde tu navegador, escribe la URL directa para regenerar el .htaccess:
  tudominio.com/index.php?controller=AdminHtaccess&token=TU_TOKEN
  (Para obtener tu token, revisa la URL de cualquier página de tu back office cuando estés logueado. Verás algo como &token=123456789).
- Si no tienes acceso al back office, deberás hacerlo manualmente. Crea un archivo llamado .htaccess (sin las comillas) y pega el siguiente contenido básico (es un ejemplo, ajústalo a tu versión de PrestaShop):
```
# START PRESTASHOP
<IfModule mod_rewrite.c>
    RewriteEngine on
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule . index.php [L]
</IfModule>
# END PRESTASHOP
```
  (Este código es para PrestaShop 1.7/8.x. Si usas una versión anterior, busca el contenido estándar en Google).
Guarda el nuevo .htaccess y prueba tu tienda.

[TIP] Si regenerar el .htaccess soluciona el error, el problema original era ese archivo. Recuerda eliminar el archivo .htaccess_old que renombraste.

Paso 3: Aumentar el límite de memoria PHP

Uno de los errores más frecuentes es que PrestaShop se quede sin memoria. El mensaje típico es: Fatal error: Allowed memory size of 134217728 bytes exhausted.

Para solucionarlo desde cPanel:

Busca la herramienta "Seleccionar versión de PHP" o "MultiPHP Manager" en cPanel.
Una vez dentro, busca la opción "Opciones de PHP" o "Switch to PHP Options".
Localiza la directiva memory_limit. El valor recomendado para PrestaShop es al menos 256M (256 megabytes) o incluso 512M si tienes muchos módulos.
También puedes ajustar max_execution_time a 120 (segundos) y upload_max_filesize a 64M.
Guarda los cambios y recarga tu tienda.

[WARNING] Si no puedes cambiar estos valores desde cPanel, deberás hacerlo manualmente. Crea un archivo llamado php.ini en la raíz de tu tienda y pega:
memory_limit = 256M
max_execution_time = 120
upload_max_filesize = 64M
O, si tienes acceso a tu archivo .htaccess, añade esta línea:
php_value memory_limit 256M

Paso 4: Verificar permisos de archivos y carpetas

Los permisos incorrectos son otra causa común del cPanel error PrestaShop. Los archivos deben tener permisos 644 y las carpetas 755.

Cómo corregirlos:

En el Administrador de archivos de cPanel, selecciona TODA la carpeta de tu tienda (haz clic en la casilla de verificación de la carpeta raíz).
En la barra de herramientas superior, haz clic en Permisos.
Aparecerá una ventana. Para los directorios (carpetas), marca los permisos como 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para grupo y público).
Para los archivos, deberías hacerlo por separado. Una forma rápida es seleccionar todos los archivos (Ctrl+A) y aplicar permisos 644.
Haz clic en Cambiar permisos.
Importante: La carpeta config y el archivo settings.inc.php (en la carpeta config) deben tener permisos especiales. Asegúrate de que config/settings.inc.php tenga permisos 644 (o 444 si tu servidor es muy restrictivo). La carpeta config debe ser 755.

[INFO] Si después de cambiar permisos el error persiste, revisa los permisos de la carpeta cache, log y upload. A veces necesitan permisos 777 temporalmente para que PrestaShop pueda escribir en ellos, pero es una mala práctica dejarlos así. Después de solucionar el error, vuelve a ponerlos en 755.

Paso 5: Deshabilitar módulos y temas (si el error apareció tras una actualización)

Si el error 500 apareció justo después de instalar un módulo o cambiar de tema, ese es el culpable.

Cómo deshabilitar módulos sin acceso al back office:

Ve al Administrador de archivos.
Navega a la carpeta modules.
Busca la carpeta del módulo que instalaste recientemente (por ejemplo, moduloproblema).
Renombra la carpeta añadiendo un guión bajo al final, por ejemplo: moduloproblema_old. Esto desactiva el módulo.
Si el error era por el módulo, tu tienda volverá a funcionar.
Si no sabes qué módulo es, renombra la carpeta del tema que estás usando (en la carpeta themes). El tema por defecto suele llamarse classic. Si renombras el tema activo, PrestaShop usará el tema por defecto.

Paso 6: Revisar la base de datos (último recurso)

Si nada de lo anterior funciona, el problema podría estar en la base de datos. Un error típico es una tabla corrupta.

Cómo repararla desde cPanel:

Busca la herramienta phpMyAdmin en cPanel.
Selecciona la base de datos de tu tienda.
En la parte inferior, verás un enlace que dice "Marcar todas". Selecciona todas las tablas.
En el menú desplegable (Con seleccionados:), elige "Reparar tabla".
Esto intentará reparar cualquier tabla dañada.

[WARNING] Si no te sientes cómodo con phpMyAdmin, no toques nada más. Un error en la base de datos puede provocar la pérdida de datos. En este caso, contacta con tu soporte técnico.

FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop

P: ¿El error 500 borra mis datos?
R: No. El error 500 es solo una pantalla de error. Tus productos, clientes y pedidos siguen intactos en la base de datos.

P: ¿Puedo solucionar el error 500 desde el móvil?
R: Sí, si tienes acceso a cPanel desde tu navegador móvil. Sin embargo, es más fácil desde un ordenador.

P: ¿Cada cuánto debo regenerar el .htaccess?
R: Solo cuando tengas problemas o después de cambiar la URL de tu tienda, activar/desactivar SSL o cambiar la configuración de las URLs amigables.

P: ¿Qué hago si después de todo el error persiste?
R: Revisa los logs de error del servidor. En cPanel, busca la sección "Errores" o "Error Log" (a veces dentro de "Métricas"). Allí verás el error exacto. También puedes revisar el archivo var/logs/ de tu PrestaShop (si el modo debug está activo).

P: ¿El error 500 puede deberse a un ataque?
R: Sí, aunque es menos común. Un plugin malicioso o un intento de hacking puede corromper archivos. Si sospechas, cambia todas tus contraseñas y revisa los archivos recién modificados.

Conclusión

El error 500 PrestaShop puede ser frustrante, pero con esta guía paso a paso tienes todas las herramientas para solucionar error 500 desde tu cPanel. Recuerda siempre empezar por activar el modo debug, luego revisar el .htaccess, los permisos y la memoria PHP.

Si después de seguir todos los pasos el problema continúa, no dudes en contactar a tu proveedor de hosting. A veces el error está en el servidor (como un problema con PHP-FPM o con la configuración de Apache) y ellos pueden verlo desde su lado.

¡Espero que tu tienda vuelva a funcionar en un abrir y cerrar de ojos! Si tienes más dudas, déjalas en los comentarios y estaré encantado de ayudarte.