Errores 500 en PrestaShop con Plesk: Causas y soluciones

¡Hola! Soy tu técnico de soporte amigable. Entiendo que ver un error 500 en PrestaShop con Plesk puede ser frustrante, especialmente cuando estás a punto de vender o gestionar tu tienda online.

No te preocupes. Este error, conocido como "Error interno del servidor", es muy común y, en la mayoría de los casos, tiene una solución sencilla. Voy a guiarte paso a paso para que puedas solucionar error 500 PrestaShop y tu tienda vuelva a funcionar sin problemas.

¿Qué significa el error 500 en PrestaShop?

El error 500 PrestaShop Plesk es un código de estado HTTP que indica que algo salió mal en el servidor, pero el servidor no puede dar más detalles. Piensa en él como una caja negra: sabemos que hay un problema interno, pero necesitamos investigar para encontrar la causa exacta.

Las causas más frecuentes en un entorno Plesk suelen ser:

Problemas de permisos de archivos o carpetas.
Errores en el archivo de configuración settings.inc.php.
Módulos o temas incompatibles o corruptos.
Límites de memoria PHP excedidos.
Errores en el archivo .htaccess.
Base de datos corrupta o con errores.

Paso 1: Activar el modo de depuración (Debug) de PrestaShop

El primer paso para solucionar error 500 PrestaShop es obtener más información. PrestaShop tiene un modo de depuración que muestra errores específicos en lugar de la pantalla blanca o el error 500 genérico.

¿Cómo activarlo?

Accede a tu panel de control Plesk.
Ve a Archivos > Administrador de archivos.
Navega hasta la carpeta raíz de tu tienda PrestaShop (normalmente httpdocs o public_html).
Busca el archivo config/defines.inc.php. Haz clic derecho y selecciona Editar.
Busca la línea que dice:
```
define('_PS_MODE_DEV_', false);
```
Cámbiala a:
```
define('_PS_MODE_DEV_', true);
```
Importante: Si no encuentras _PS_MODE_DEV_, puedes agregarla justo después de la línea define('_PS_MODE_DEV_', false); o al principio del archivo, antes de cualquier otra línea.
Guarda los cambios.

[INFO] Al activar el modo dev, verás errores PHP detallados en la pantalla. Anota el mensaje de error exacto, ya que te dará la pista principal. Una vez resuelto, vuelve a cambiar true a false.

¿Qué mensajes de error comunes puedes ver?

"Fatal error: Allowed memory size of X bytes exhausted" → Problema de memoria PHP.
"Fatal error: Uncaught Error: Class 'X' not found" → Módulo o tema corrupto.
"Parse error: syntax error, unexpected..." → Error en un archivo PHP (normalmente de un módulo).
"Warning: require(...): failed to open stream" → Archivo faltante o problema de permisos.

Paso 2: Solucionar problemas de permisos de archivos

Los permisos incorrectos son una causa muy común del error interno servidor PrestaShop. En Plesk, es fácil solucionarlo.

Solución automática desde Plesk

Ve a Sitios web y dominios > selecciona tu dominio.
Haz clic en Herramientas (o el icono de engranaje) y luego en Reparar permisos.
Plesk reparará automáticamente los permisos de todos los archivos y carpetas de tu sitio.

Solución manual (si la automática no funciona)

Si prefieres hacerlo manualmente o la reparación automática no resuelve el problema:

Conéctate a tu servidor por FTP o usa el Administrador de archivos de Plesk.
Ve a la raíz de tu tienda PrestaShop.
Asegúrate de que:
- Carpetas tengan permisos 755 (rwxr-xr-x).
- Archivos tengan permisos 644 (rw-r--r--).
- Carpetas especiales como config, cache, log, img, mails, modules, themes, translations, upload, download deben tener permisos 755.
- Archivos especiales como config/settings.inc.php deben tener permisos 644 o 640 (nunca 777).

[WARNING] Nunca pongas permisos 777 a archivos o carpetas. Es un riesgo de seguridad grave. Si un módulo te lo pide, busca una alternativa más segura.

Paso 3: Revisar el archivo `.htaccess`

El archivo .htaccess puede estar corrupto o tener reglas incorrectas que generen un error 500.

Solución temporal: Renombrar o eliminar el `.htaccess`

Desde el Administrador de archivos de Plesk, ve a la raíz de tu tienda.
Busca el archivo .htaccess. Si no lo ves, asegúrate de tener habilitada la opción "Mostrar archivos ocultos".
Renómbralo a algo como .htaccess_backup o simplemente elimínalo (pero primero haz una copia de seguridad).
Prueba tu tienda. Si el error desaparece, el problema estaba en el .htaccess.
Para regenerarlo: Ve al panel de administración de PrestaShop (si puedes acceder) a Configuración avanzada > Rendimiento y haz clic en Guardar (sin cambiar nada). Esto regenerará el .htaccess limpio.

[TIP] Si no puedes acceder al panel de administración, puedes crear un .htaccess básico manualmente. Copia este contenido en un nuevo archivo .htaccess:
# START DISABLE URL REWRITING
# Si no funciona, comenta esta línea
# END DISABLE URL REWRITING
Luego, desde el panel de administración, ve a Configuración avanzada > Rendimiento y haz clic en Guardar para que PrestaShop genere el suyo propio.

Paso 4: Aumentar la memoria PHP (memory_limit)

Si el error es por límite de memoria, debes aumentarlo.

Cómo hacerlo en Plesk

Ve a Sitios web y dominios > selecciona tu dominio.
Haz clic en PHP Settings (Configuración de PHP).
Busca la opción memory_limit.
Cámbiala a un valor más alto, por ejemplo, 256M o 512M.
Haz clic en Aceptar.

[INFO] Si no ves la opción memory_limit, es posible que tu plan de hosting no permita modificarlo. Contacta con tu proveedor de hosting para que lo aumenten.

Paso 5: Deshabilitar módulos y temas problemáticos

Un módulo o tema mal programado o desactualizado puede causar el error 500 PrestaShop Plesk.

Cómo deshabilitarlos manualmente (sin acceso al panel)

Accede a tu base de datos desde Plesk (normalmente a través de phpMyAdmin).
Selecciona la base de datos de tu tienda PrestaShop.
Busca la tabla ps_module (el prefijo ps_ puede variar).
Haz clic en Examinar (Browse).
Busca los módulos que hayas instalado recientemente o que sospeches que causan el problema.
Marca la casilla de ese módulo y haz clic en Editar.
Cambia el valor de la columna active de 1 a 0.
Guarda los cambios.

Para deshabilitar un tema:

En la misma base de datos, busca la tabla ps_shop_url.
Busca el campo theme_name y cámbialo por el nombre de un tema predeterminado (por ejemplo, classic).
Guarda los cambios.

[WARNING] Si no te sientes cómodo editando la base de datos, es mejor que contactes con soporte técnico. Un error podría dañar tu tienda.

Paso 6: Verificar el archivo `config/settings.inc.php`

Este archivo contiene la configuración de conexión a la base de datos. Si está corrupto, tu tienda no funcionará.

Cómo revisarlo

Desde el Administrador de archivos de Plesk, ve a la carpeta config.
Abre el archivo settings.inc.php.
Verifica que los parámetros de conexión sean correctos:
- _DB_SERVER_ (normalmente localhost)
- _DB_NAME_ (nombre de tu base de datos)
- _DB_USER_ (usuario de la base de datos)
- _DB_PASSWD_ (contraseña de la base de datos)
Si todo parece correcto, puedes intentar reparar la base de datos desde phpMyAdmin (selecciona la base de datos y haz clic en "Reparar").

Paso 7: Preguntas Frecuentes (FAQ)

¿Por qué aparece el error 500 solo en algunas páginas?

Esto suele indicar un problema con un módulo o tema específico que se carga en esas páginas. Activa el modo debug (Paso 1) para identificar el archivo exacto.

¿El error 500 puede deberse a un ataque de seguridad?

Sí, aunque es menos común. Un archivo corrupto o modificado maliciosamente puede causar este error. Si sospechas de un ataque, restaura una copia de seguridad limpia y actualiza PrestaShop y todos los módulos.

¿Qué hago si después de todo sigue apareciendo el error?

Si has seguido todos los pasos y el error persiste, puede ser un problema más profundo del servidor. En ese caso, te recomiendo:

Contactar con tu proveedor de hosting y explicarles que has agotado todas las soluciones básicas.
Revisar los logs de error del servidor en Plesk (Sitios web y dominios > Logs). Allí suele haber información más detallada.

¿Puedo usar Syspanel (HestiaCP) para solucionar este error? (Aunque estemos en Plesk, por si lo mencionas)

Si en algún momento migras tu tienda a un servidor con Syspanel (antes conocido como HestiaCP), el proceso es similar. Accede a tu panel a través del puerto 2106 (ejemplo: tudominio.com:2106). Desde allí, puedes acceder al administrador de archivos, a la base de datos (phpMyAdmin) y a la configuración de PHP, siguiendo los mismos pasos descritos anteriormente.

¿Se puede perder información con el error 500?

Generalmente no. El error 500 es un problema de visualización o de procesamiento del servidor, pero no debería borrar tus productos, clientes o pedidos. Sin embargo, siempre es recomendable tener copias de seguridad periódicas.

Resumen rápido para solucionar el error 500 en PrestaShop con Plesk

Activa el modo debug (config/defines.inc.php) para ver el error exacto.
Repara permisos desde Plesk (Herramientas > Reparar permisos).
Renombra o elimina el archivo .htaccess y luego regenéralo.
Aumenta la memoria PHP en la configuración de PHP de Plesk.
Deshabilita módulos desde la base de datos (phpMyAdmin).
Verifica el archivo config/settings.inc.php.

[TIP] Mi consejo personal: Siempre que instales un nuevo módulo o tema, hazlo en un entorno de pruebas primero. Esto te evitará dolores de cabeza en tu tienda en producción.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave. Si tienes alguna otra duda, no dudes en consultar. ¡Tu tienda online volverá a funcionar en poco tiempo!