Error 500 en PrestaShop: Solución en Plesk y DirectAdmin

¿Qué es el error 500 en PrestaShop y por qué aparece?

El error 500, también conocido como PrestaShop Internal Server Error, es uno de los problemas más temidos por cualquier dueño de tienda online. Aparece de repente, muestra una pantalla en blanco o un mensaje genérico como "500 Internal Server Error" y detiene por completo el funcionamiento de tu tienda.

La buena noticia es que, en la mayoría de los casos, este error no significa que hayas perdido tus datos ni tu tienda. Simplemente indica que el servidor encontró un problema interno al intentar procesar la solicitud. Puede ser algo tan sencillo como un archivo con permisos incorrectos o tan complejo como un módulo que genera un conflicto.

Para que lo entiendas fácilmente: imagina que tu tienda es un restaurante. El error 500 es como si la cocina recibiera una orden, pero al intentar prepararla, se encuentra con que falta un ingrediente, hay un fogón apagado o el chef tiene un día malo. El restaurante no cierra para siempre, solo necesita que alguien revise qué falla en la cocina.

En este artículo, te guiaré paso a paso para que puedas solucionar el error 500 en PrestaShop, tanto si tu hosting usa Plesk como si usa DirectAdmin. No necesitas ser un experto técnico; solo sigue las instrucciones con calma y en orden.

Primeros pasos: antes de tocar nada, haz una copia de seguridad

[WARNING]: Antes de realizar cualquier cambio en tu tienda, es obligatorio hacer una copia de seguridad completa de tu sitio web (archivos y base de datos). Si algo sale mal durante el proceso, podrás restaurar todo sin perder ventas ni información de clientes.

Si tu hosting tiene Plesk o DirectAdmin, ambos paneles incluyen herramientas de backup. En Plesk, busca la sección "Administrador de copias de seguridad". En DirectAdmin, ve a "Copia de seguridad" o "Backup". Si no sabes cómo hacerlo, contacta con tu proveedor de hosting; ellos pueden ayudarte a generar una copia en minutos.

Una vez que tengas tu respaldo seguro, podemos comenzar a diagnosticar.

Paso 1: Activa el modo de depuración para ver el error real

El error 500 es muy poco descriptivo. Para ver qué está fallando realmente, necesitas activar el modo de depuración (debug mode) de PrestaShop. Esto te mostrará un mensaje de error específico, como "Archivo no encontrado" o "Error de sintaxis en la línea X".

### Cómo activar el modo debug en PrestaShop

Accede a tu hosting a través de FTP o el administrador de archivos de tu panel (Plesk o DirectAdmin).
Busca el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop.
Descarga una copia de este archivo a tu ordenador por seguridad.
Abre el archivo con un editor de texto como Notepad++ o Sublime Text.
Busca la línea que dice: define('_PS_MODE_DEV_', false);
Cambia false por true. Debe quedar así: define('_PS_MODE_DEV_', true);
Guarda el archivo y súbelo de nuevo al servidor, reemplazando el original.

Ahora recarga tu tienda. Verás un mensaje de error detallado con la causa raíz del problema. Anota ese mensaje, porque te ayudará a identificar la solución exacta.

[TIP]: Después de arreglar el error, recuerda volver a poner false en esa línea para que los clientes no vean información técnica sensible.

Paso 2: Permisos de archivos y carpetas incorrectos

Una de las causas más comunes del error 500 en PrestaShop son los permisos de archivos incorrectos. Si los permisos son demasiado restrictivos, el servidor no puede leer o escribir los archivos necesarios. Si son demasiado abiertos, puede haber problemas de seguridad.

### Cómo corregir los permisos en Plesk

Entra a Plesk y ve a "Administrador de archivos".
Navega hasta la carpeta raíz de tu tienda PrestaShop.
Selecciona todos los archivos y carpetas (Ctrl+A).
Haz clic en "Permisos" o "Cambiar permisos".
Establece los siguientes valores:
- Carpetas (directorios): 755
- Archivos: 644
Aplica los cambios.

### Cómo corregir los permisos en DirectAdmin

Accede a DirectAdmin y abre el "Administrador de archivos".
Ve a la carpeta pública_html (o la carpeta donde esté tu tienda).
Selecciona todo y haz clic en "Cambiar permisos".
Introduce el valor 755 para directorios y 644 para archivos.
Marca la opción "Aplicar a todos los archivos y subdirectorios" si está disponible.

[INFO]: Si tu tienda usa un sistema de caché, también puedes intentar borrar la carpeta var/cache (o cache en versiones antiguas). Elimina su contenido, pero no la carpeta en sí. Esto suele resolver problemas de caché corrupta que provocan el error 500.

Paso 3: Soluciona el error 500 en PrestaShop con Plesk: revisa el archivo .htaccess

El archivo .htaccess es un archivo de configuración que controla el comportamiento del servidor Apache. Si está dañado o tiene reglas incompatibles, puede generar un PrestaShop Internal Server Error.

### Cómo regenerar el .htaccess en PrestaShop

Entra a tu administrador de archivos en Plesk.
Busca el archivo .htaccess en la raíz de tu tienda.
Descarga una copia como respaldo.
Elimina el archivo .htaccess del servidor.
Ve a tu panel de administración de PrestaShop (Back Office). Si no puedes acceder, prueba directamente a recargar la tienda.
PrestaShop regenerará automáticamente un nuevo .htaccess al cargar cualquier página.

Si tu tienda sigue mostrando el error, es posible que el problema sea una directiva incompatible. En ese caso, puedes crear un .htaccess mínimo temporal con solo estas líneas:

<IfModule mod_rewrite.c>
RewriteEngine On
</IfModule>

Esto desactivará las reglas personalizadas y permitirá que la tienda cargue. Luego, desde el Back Office, ve a "Parámetros avanzados" > "SEO y URLs" y haz clic en "Guardar" para regenerar las reglas correctamente.

Paso 4: DirectAdmin y el error 500: revisa el límite de memoria PHP

Otra causa frecuente es que el límite de memoria de PHP sea demasiado bajo para que PrestaShop funcione. Esto suele pasar cuando instalas muchos módulos o tienes una tienda con muchos productos.

### Cómo aumentar el límite de memoria en DirectAdmin

Accede a DirectAdmin y busca la sección "Administrador de PHP" o "Configuración PHP".
Busca la opción memory_limit.
Cambia el valor a 256M o 512M.
Guarda los cambios y reinicia PHP si es necesario.

### Cómo aumentar el límite de memoria en Plesk

Ve a Plesk y busca "Configuración de PHP" dentro de tu dominio.
Encuentra memory_limit y cámbialo a 256M.
Aplica los cambios.

[TIP]: Si no encuentras estas opciones, puedes crear un archivo llamado php.ini en la raíz de tu tienda con el siguiente contenido:

memory_limit = 256M
max_execution_time = 300
upload_max_filesize = 64M

Esto suele funcionar en la mayoría de los servidores compartidos.

Paso 5: Módulos o temas incompatibles que causan el error 500

Los módulos y temas de terceros son la pesadilla de cualquier tienda PrestaShop. Un módulo mal codificado o un tema desactualizado pueden provocar el error 500.

### Cómo identificar el módulo problemático

Si puedes acceder al Back Office, ve a "Módulos" > "Administrador de módulos".
Desactiva todos los módulos que no sean de PrestaShop (los de terceros).
Prueba tu tienda. Si el error desaparece, ve activando módulos uno a uno hasta encontrar el culpable.

### Si no puedes acceder al Back Office

Usa FTP o el administrador de archivos.
Renombra la carpeta modules a modules_backup.
Crea una nueva carpeta vacía llamada modules.
Prueba tu tienda. Si carga, el problema es un módulo.
Para recuperar tus módulos, mueve los archivos de modules_backup a modules en grupos de 10, probando cada vez.

[WARNING]: No elimines la carpeta modules_backup hasta que estés seguro de que todo funciona perfectamente.

Paso 6: Problemas con la versión de PHP

PrestaShop es muy sensible a la versión de PHP. Si tu hosting actualizó la versión de PHP y tu tienda no es compatible, verás el error 500.

### Cómo cambiar la versión de PHP en Plesk

Ve a Plesk y selecciona tu dominio.
Busca "Configuración de PHP" o "Versión de PHP".
Prueba con versiones como 7.4, 8.0 o 8.1. La recomendada para PrestaShop 1.7 es PHP 7.4 o superior.
Guarda y prueba tu tienda.

### Cómo cambiar la versión de PHP en DirectAdmin

Accede a DirectAdmin y busca "Administrador de PHP" o "Configuración de PHP".
Selecciona la versión que quieras probar.
Aplica los cambios.

[INFO]: Si tu tienda es antigua (PrestaShop 1.6), PHP 5.6 o 7.0 son más seguros. Las versiones más nuevas pueden causar incompatibilidades.

Paso 7: Revisa los registros de error del servidor

Si después de todos estos pasos sigues sin encontrar la solución, los registros de error del servidor te darán pistas valiosas.

### Dónde encontrar los logs en Plesk

Ve a "Sitios web y dominios".
Busca la sección "Registros" o "Logs".
Revisa el archivo error_log o error.log de tu dominio.

### Dónde encontrar los logs en DirectAdmin

Ve a "Administrador de archivos".
Navega a la carpeta logs o busca el archivo error_log en la raíz.
Descarga y revisa las últimas líneas.

Busca mensajes como "PHP Fatal error" o "Allowed memory size exhausted". Esos mensajes te indicarán exactamente qué está fallando.

Paso 8: Contacta con tu proveedor de hosting

Si has probado todo y el error 500 en PrestaShop persiste, puede ser un problema del servidor que está fuera de tu control. Contacta con tu proveedor de hosting y dales la siguiente información:

El mensaje de error exacto que ves (con el modo debug activado).
Los pasos que ya has intentado.
La versión de PrestaShop y PHP que usas.

Ellos podrán revisar la configuración del servidor, los logs a nivel de sistema y solucionar problemas como límites de recursos o configuraciones de Apache/Nginx.

Preguntas frecuentes (FAQ)

### ¿Por qué aparece el error 500 solo en algunas páginas de mi tienda?

Esto suele indicar que el problema está relacionado con un módulo o una funcionalidad específica. Por ejemplo, si el error aparece solo en el carrito, puede ser un módulo de pago. Revisa los logs y desactiva módulos para aislar el problema.

### ¿Puedo solucionar el error 500 sin acceso al Back Office?

Sí. Usa FTP o el administrador de archivos de tu panel para hacer cambios directamente en los archivos. Los pasos que te he mostrado (permisos, .htaccess, renombrar módulos) funcionan sin necesidad de acceder al Back Office.

### ¿El error 500 afecta a mi posicionamiento SEO?

Sí, temporalmente. Si el error dura mucho tiempo, Google puede penalizar tu tienda. Por eso es importante solucionarlo lo antes posible. Una vez que la tienda vuelve a funcionar, el SEO se recupera gradualmente.

### ¿Qué hago si mi tienda sigue mostrando el error 500 después de seguir todos los pasos?

En ese caso, te recomiendo restaurar la copia de seguridad que hiciste al principio y empezar de nuevo con más calma. También puedes contactar con un desarrollador especializado en PrestaShop para que revise el código.

Conclusión

El error 500 en PrestaShop es frustrante, pero casi siempre tiene solución. Siguiendo estos pasos en orden, podrás solucionar el error 500 en PrestaShop tanto en Plesk como en DirectAdmin. Recuerda:

Haz una copia de seguridad.
Activa el modo debug para ver el error real.
Corrige permisos de archivos.
Regenera el .htaccess.
Aumenta la memoria PHP.
Desactiva módulos sospechosos.
Verifica la versión de PHP.
Revisa los logs del servidor.

Con paciencia y método, tu tienda volverá a estar operativa. Y si en algún momento te sientes abrumado, no dudes en pedir ayuda a tu hosting o a un profesional. ¡Tu tienda merece volver a vender!