Solucionar error 500 en PrestaShop con Plesk

¡Entendido! Aquí tienes el artículo completo y detallado, siguiendo todas tus instrucciones al pie de la letra.

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

Imagina que estás a punto de recibir un pedido importante en tu tienda online, pero de repente, en lugar de ver tus productos, solo ves una pantalla en blanco con el temido mensaje: "Error 500: Internal Server Error". No te preocupes, es uno de los problemas más comunes en el mundo del hosting y, por suerte, casi siempre tiene solución.

El error 500 es un error genérico del servidor. Básicamente, le está diciendo a tu navegador: "Algo salió mal, pero no te puedo dar más detalles". En el contexto de PrestaShop, una plataforma de tienda online muy potente pero también sensible, este error puede deberse a varias causas. Desde un simple archivo de configuración dañado hasta un plugin (módulo) conflictivo o un problema de permisos en los archivos.

En este artículo, te guiaré paso a paso para que puedas solucionar el error 500 en PrestaShop utilizando Plesk, uno de los paneles de control de hosting más populares. No necesitas ser un experto en programación; solo sigue estas instrucciones con calma.

Primeros pasos: Lo básico antes de entrar en pánico

Antes de meternos en la trinchera de los archivos, hagamos unas comprobaciones rápidas que a veces resuelven el problema de inmediato.

1. Refresca la página y limpia la caché del navegador

A veces, el error 500 es solo un pequeño tropiezo temporal. Prueba a presionar F5 o Ctrl + R (Cmd + R en Mac) para recargar la página. Si no funciona, limpia la caché de tu navegador. En Chrome, por ejemplo, puedes hacerlo con Ctrl + Shift + Supr.

2. Revisa el estado del servidor desde Plesk

Accede a tu panel de Plesk. Normalmente, la URL es algo como https://tudominio.com:8443 o la que te haya proporcionado tu proveedor de hosting. Una vez dentro, busca en el menú principal la sección de "Herramientas y Configuración" y luego "Estado del Servidor". Aquí podrás ver si hay algún servicio caído (como Apache o Nginx, PHP, o MySQL). Si ves algo en rojo, contacta a tu soporte de hosting.

[INFO] Si usas Syspanel (el antiguo HestiaCP), el acceso es por el puerto 2106 (ejemplo: https://tudominio.com:2106). La lógica de solución es similar, pero los nombres de las secciones pueden variar ligeramente.

Diagnóstico Profundo: Activar el modo debug de PrestaShop desde Plesk

PrestaShop tiene un modo de depuración (debug) que, cuando se activa, muestra el error específico en lugar de la pantalla en blanco. Esta es la clave para encontrar la solución.

Paso 1: Accede al Administrador de Archivos de Plesk

Desde el panel principal de Plesk, busca tu dominio (el de tu tienda) y haz clic en "Administrador de Archivos". Esto te permitirá navegar por los archivos de tu web sin necesidad de un cliente FTP.

Paso 2: Encuentra el archivo de configuración

Dentro del Administrador de Archivos, navega hasta la carpeta raíz de tu PrestaShop (normalmente httpdocs o public_html). Busca un archivo llamado defines.inc.php. Está dentro de la carpeta config. La ruta completa suele ser: /httpdocs/config/defines.inc.php.

Paso 3: Edita el archivo para activar el debug

Haz clic derecho sobre el archivo defines.inc.php y selecciona "Editar en el Editor de Texto". Se abrirá un editor. Busca la siguiente línea (normalmente está cerca de la línea 50):

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda los cambios. Ahora, cuando recargues tu tienda, en lugar del error 500, verás un mensaje de error detallado con PHP. Anota ese mensaje, porque te dirá exactamente qué archivo y línea están causando el problema.

[WARNING] No dejes el modo debug activado para siempre. Una vez resuelto el error, vuelve a poner false por seguridad. De lo contrario, cualquier visitante podría ver información sensible de tu servidor.

Las causas más comunes del error 500 en PrestaShop y cómo solucionarlas

Basándonos en el mensaje de error que viste en el paso anterior (o por experiencia), estas son las soluciones más efectivas.

1. Problemas de permisos de archivos y carpetas

PrestaShop necesita permisos específicos para leer y escribir archivos. Si están mal configurados, aparece el error 500.

Cómo solucionarlo desde Plesk:

En el Administrador de Archivos, selecciona la carpeta raíz (ej. httpdocs).
Haz clic en el botón "Cambiar permisos" (o "Permisos de archivo").
Aplica los siguientes permisos (esto es lo recomendado por PrestaShop):
- Carpetas (directorios): 755
- Archivos: 644
Importante: La carpeta config, cache, log, img, mails, modules, override, themes, translations, upload y download deben tener permisos 755 para que PrestaShop pueda escribir en ellas (por ejemplo, para instalar módulos o generar imágenes).
Haz clic en "Aceptar" y luego en "Aplicar a subdirectorios" para que se herede a todos los archivos y carpetas internos.

[TIP] Si no sabes qué permisos poner, una regla segura es: carpetas en 755 y archivos en 644. Luego, si algún módulo te da error, puedes subir temporalmente los permisos de su carpeta a 777, pero nunca lo dejes así por seguridad.

2. Módulo o plugin conflictivo

Un módulo recién instalado o actualizado es el principal sospechoso. Si el error 500 apareció justo después de instalar un nuevo módulo, ese es el culpable.

Cómo solucionarlo desde Plesk (sin acceso al backoffice):

Ve al Administrador de Archivos.
Navega a la carpeta /httpdocs/modules/.
Busca la carpeta del módulo problemático (por su nombre). Si no sabes cuál es, renombra la carpeta del módulo sospechoso añadiendo _old al final (ej: micromodulo -> micromodulo_old).
Esto desactivará el módulo de forma forzosa. Recarga tu tienda. Si el error desaparece, ya sabes quién es el culpable. Puedes eliminarlo o contactar al desarrollador.

3. Límite de memoria PHP (memory_limit) insuficiente

PrestaShop, sobre todo con muchos productos o módulos pesados, puede necesitar más memoria de la que tiene asignada por defecto. Esto provoca un error 500.

Cómo aumentarlo desde Plesk:

En el panel de Plesk, ve a tu dominio y busca la sección "Configuración de PHP" (o "PHP Settings").
Busca la opción memory_limit.
Auméntalo. Un valor seguro para PrestaShop es 256M o incluso 512M si tu hosting lo permite.
También puedes aumentar otros valores relacionados como max_execution_time a 120 o 180, y upload_max_filesize a 32M si tienes problemas al subir imágenes.
Guarda los cambios y recarga tu tienda.

4. Archivo .htaccess dañado o mal configurado

El archivo .htaccess es el "libro de reglas" de tu servidor web. Si está corrupto, puede generar un error 500.

Cómo regenerarlo desde Plesk:

En el Administrador de Archivos, asegúrate de ver los archivos ocultos (hay un botón para ello).
Localiza el archivo .htaccess en la raíz de tu PrestaShop (carpeta httpdocs).
No lo edites. Simplemente, renómbralo a .htaccess_old para desactivarlo.
Ahora, intenta acceder a tu tienda. Si el error 500 desaparece, el .htaccess estaba dañado.
Para regenerar uno nuevo y limpio, accede a tu backoffice de PrestaShop (si puedes). Ve a Configuración de la tienda -> Tráfico y SEO -> URL amigables. Sin cambiar nada, simplemente haz clic en "Guardar". Esto regenerará el archivo .htaccess automáticamente.
Si no puedes acceder al backoffice, puedes crear un archivo .htaccess básico desde Plesk (crea un nuevo archivo de texto, pégalo y guárdalo como .htaccess) o pedirle a tu soporte que lo genere.

5. Problemas con la versión de PHP

PrestaShop es exigente con la versión de PHP. Una versión incompatible (demasiado antigua o demasiado nueva) es una causa frecuente de errores 500.

Cómo cambiarlo desde Plesk:

En el panel de tu dominio en Plesk, busca la sección "Configuración de PHP".
Verás un selector para elegir la versión de PHP. PrestaShop 1.7 funciona bien con PHP 7.4 u 8.0. PrestaShop 8.x necesita PHP 8.1 o superior.
Selecciona una versión compatible y guarda los cambios.

[INFO] Si tu hosting no te permite cambiar la versión de PHP desde Plesk, contacta a tu proveedor. Es un cambio muy común que ellos pueden hacer en segundos.

FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop

P: ¿Puedo solucionar el error 500 sin acceso al panel de Plesk?
R: Si no tienes acceso a Plesk, necesitarás un cliente FTP (como FileZilla) para conectarte a tu servidor. La lógica es la misma: modificar archivos, cambiar permisos, etc. Plesk solo facilita estas tareas desde el navegador.

P: ¿Qué hago si después de todo esto el error 500 persiste?
R: No te desesperes. Puede ser un problema más complejo del servidor, como un error en la base de datos o una configuración de PHP a nivel de servidor que no puedes tocar. En ese caso, contacta al soporte técnico de tu hosting. Diles que ya has revisado permisos, módulos y la versión de PHP. Ellos tendrán acceso a los logs del servidor (error_log) que mostrarán el error exacto.

P: ¿El error 500 puede afectar mi posicionamiento SEO?
R: Sí, si el error se mantiene por mucho tiempo. Google ve un error 500 como una mala señal de experiencia de usuario. Si es temporal (unos minutos u horas), no suele pasar nada grave. Pero si tu tienda está caída días, puedes perder posiciones en los resultados de búsqueda. Por eso es importante solucionar el error lo antes posible.

P: ¿Usar Syspanel (HestiaCP) es muy diferente a Plesk para esto?
R: La lógica es la misma. En Syspanel, accedes por el puerto 2106. Las herramientas se llaman diferente (por ejemplo, "Administrador de archivos" puede ser "Explorador de archivos"), pero los pasos para editar defines.inc.php, cambiar permisos o modificar la configuración de PHP son conceptualmente idénticos. Busca las opciones equivalentes en el menú de tu panel.

Conclusión: No le temas al error 500

El error 500 en tu tienda online puede ser frustrante, pero como has visto, es un problema con solución. La clave está en la paciencia y en seguir un orden lógico: primero activar el modo debug para obtener pistas, y luego atacar las causas más comunes: permisos, módulos, memoria PHP y versión de PHP.

Con Plesk, tienes todas las herramientas necesarias para hacer este diagnóstico y reparación desde un solo lugar, sin necesidad de ser un experto en sistemas. Recuerda que mantener tu PrestaShop actualizado, con una buena configuración de hosting y haciendo copias de seguridad periódicas, es la mejor receta para evitar estos dolores de cabeza.

Ahora ya sabes cómo enfrentarte a la pantalla blanca. ¡Manos a la obra y a recuperar tu tienda online!