Solucionar errores típicos de PrestaShop en Plesk (503, 500, permisos)

Entendiendo los errores de PrestaShop en Plesk: Lo que necesitas saber antes de empezar

Cuando tu tienda PrestaShop muestra un error 500 o 503 en Plesk, la primera reacción suele ser el pánico. Pero respira hondo: estos errores son más comunes de lo que crees y, en la mayoría de los casos, tienen una solución clara y accionable que puedes aplicar tú mismo sin necesidad de contactar con soporte técnico.

En esta guía completa, vamos a desglosar los errores más frecuentes de PrestaShop en entornos Plesk, explicando sus causas y ofreciéndote soluciones paso a paso. Tanto si eres un novato absoluto en administración de servidores como si ya tienes algo de experiencia, encontrarás aquí las respuestas que buscas.

Antes de sumergirnos en las soluciones, es importante entender qué significan exactamente estos códigos de error. Un error 500 (Internal Server Error) indica que algo salió mal en el servidor pero no se especifica exactamente qué. Un error 503 (Service Unavailable) significa que el servidor no puede manejar la solicitud en ese momento, a menudo por mantenimiento o sobrecarga. Ambos pueden estar relacionados con problemas de permisos de archivos, configuraciones incorrectas o conflictos de versiones.

Causas raíz de los errores 500 y 503 en PrestaShop con Plesk

Los errores de PrestaShop en Plesk suelen tener orígenes específicos que podemos identificar y corregir. Vamos a explorar las causas más comunes antes de pasar a las soluciones concretas.

1. Permisos de archivos incorrectos

Plesk es bastante estricto con la seguridad, y los permisos de archivos son una de las primeras cosas que verifica. Si los archivos de PrestaShop tienen permisos demasiado restrictivos o demasiado permisivos, el servidor puede devolver errores 500 o 503.

Los permisos correctos para PrestaShop en Plesk suelen ser:

Directorios: 755
Archivos: 644
Carpetas de caché y archivos temporales: 775 o 777 temporalmente

2. Problemas con el archivo .htaccess

El archivo .htaccess de PrestaShop es crítico para el funcionamiento correcto de la tienda. Si está corrupto, mal formateado o tiene directivas incompatibles con la configuración de Plesk, obtendrás errores inmediatos.

3. Versiones incompatibles de PHP

PrestaShop tiene requisitos específicos de versión de PHP. Si tu dominio en Plesk está configurado con una versión de PHP demasiado antigua o demasiado nueva para tu versión de PrestaShop, los errores son casi inevitables.

4. Configuración incorrecta en Plesk

A veces el problema no está en PrestaShop sino en cómo Plesk está configurado para tu dominio. Opciones como el modo de ejecución de PHP (FPM, CGI, etc.) pueden afectar directamente al funcionamiento de tu tienda.

Solución paso a paso: Error 500 en PrestaShop con Plesk

Vamos a resolver el error 500 siguiendo un proceso sistemático. No saltes pasos, cada uno es importante.

Paso 1: Activa el modo de depuración de PrestaShop

Antes de hacer cualquier cambio, necesitas ver el error real detrás del error 500. PrestaShop tiene un modo de depuración que te mostrará información detallada.

Accede a tu servidor por SSH o al administrador de archivos de Plesk y edita el archivo config/defines.inc.php en la raíz de PrestaShop.

Busca esta línea:

define('_PS_MODE_DEV_', false);

Y cambia false por true:

define('_PS_MODE_DEV_', true);

Guarda el archivo y recarga tu tienda. Ahora verás el error real en pantalla. Anota el mensaje exacto, ya que te guiará hacia la solución.

[INFO] Una vez resuelto el problema, recuerda volver a poner false para no exponer información sensible de tu tienda.

Paso 2: Corrige los permisos de archivos desde Plesk

Plesk tiene una herramienta integrada para arreglar permisos. Ve a tu dominio en Plesk y busca la opción "Arreglar permisos" o "Repair permissions".

Haz clic en esa opción y Plesk restaurará automáticamente los permisos correctos para PrestaShop. Este proceso suele resolver muchos errores 500 relacionados con permisos.

Si prefieres hacerlo manualmente por SSH:

find /var/www/vhosts/tudominio.com/httpdocs -type d -exec chmod 755 {} \;
find /var/www/vhosts/tudominio.com/httpdocs -type f -exec chmod 644 {} \;
chmod -R 775 /var/www/vhosts/tudominio.com/httpdocs/var/cache
chmod -R 775 /var/www/vhosts/tudominio.com/httpdocs/var/logs

Paso 3: Regenera el archivo .htaccess

Un .htaccess corrupto es un culpable frecuente. Para regenerarlo:

Renombra el archivo .htaccess existente a .htaccess_old (por si necesitas restaurarlo).
Ve al panel de administración de PrestaShop (si puedes acceder) o crea un archivo .htaccess nuevo con el contenido básico:

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>

Guarda el archivo y prueba tu tienda.

[TIP] Si PrestaShop sigue generando errores con el .htaccess, considera desactivar temporalmente las URLs amigables desde la configuración y volver a activarlas después de regenerar el archivo.

Paso 4: Verifica la versión de PHP en Plesk

Plesk te permite configurar la versión de PHP por dominio. Para ello:

Ve a tu dominio en Plesk.
Busca la sección "Configuración de PHP" o "PHP Settings".
Verifica que la versión sea compatible con tu PrestaShop. PrestaShop 1.7 requiere PHP 7.1 o superior, aunque se recomienda PHP 7.4 o 8.0.
Si cambias la versión, guarda los cambios y prueba de nuevo.

[WARNING] No uses PHP 8.1 o superior con PrestaShop 1.7 sin verificar la compatibilidad con tus módulos, ya que muchos módulos antiguos no son compatibles.

Solución paso a paso: Error 503 en PrestaShop con Plesk

El error 503 es diferente del 500. Indica que el servidor está temporalmente sobrecargado o en mantenimiento. Vamos a resolverlo.

Paso 1: Comprueba si tu tienda está en modo mantenimiento

PrestaShop tiene un modo mantenimiento integrado. Si alguien lo activó por error, verás el 503.

Para desactivarlo:

Accede al panel de administración de PrestaShop.
Ve a Parámetros Avanzados → Rendimiento.
Busca la opción "Modo mantenimiento" o "Maintenance mode".
Desactívalo y guarda los cambios.

Si no puedes acceder al panel, edita directamente la tabla ps_configuration en tu base de datos MySQL usando Plesk:

UPDATE ps_configuration SET value = '0' WHERE name = 'PS_SHOP_ENABLE';

Paso 2: Revisa el estado del servicio web y PHP-FPM

En Plesk, los errores 503 pueden deberse a que PHP-FPM está caído o sobrecargado. Para verificarlo:

Accede a Plesk como administrador.
Ve a "Herramientas y utilidades" → "Gestión de servicios".
Comprueba que los servicios nginx y apache están en ejecución.
Reinicia PHP-FPM si es necesario.

Si prefieres usar la línea de comandos:

systemctl status php-fpm
systemctl restart php-fpm

Paso 3: Comprueba el uso de recursos del servidor

Un 503 puede indicar que tu servidor está al límite de recursos. En Plesk puedes ver esto fácilmente:

Ve a "Monitoreo" o "Server Health" en Plesk.
Revisa el uso de CPU, RAM y disco.
Si el servidor está sobrecargado, considera optimizar tu PrestaShop o aumentar los recursos del plan.

[INFO] Si tu servidor está al límite, activa la caché de PrestaShop y considera usar un CDN para reducir la carga.

Paso 4: Verifica los límites de ejecución de PHP

A veces el 503 aparece por límites de ejecución demasiado bajos. En Plesk, puedes ajustar estos límites:

Ve a tu dominio → "Configuración de PHP".
Aumenta valores como max_execution_time, memory_limit y max_input_vars.
Valores recomendados para PrestaShop:
- memory_limit = 256M o 512M
- max_execution_time = 300 o más
- max_input_vars = 5000 o más

Problemas específicos de permisos en Plesk

Los permisos son una causa tan común de errores que merecen su propia sección. Plesk tiene una estructura particular que puede causar confusión.

Entendiendo el sistema de permisos de Plesk

Plesk usa el usuario del sistema para ejecutar PHP. Si tu tienda fue instalada con un usuario diferente al que Plesk usa para ejecutar scripts, tendrás problemas.

Permisos recomendados para PrestaShop en Plesk:

Elemento	Permiso	Propietario
Directorios	755	Usuario FTP
Archivos	644	Usuario FTP
var/cache	775	Usuario FTP
var/logs	775	Usuario FTP
config/settings.inc.php	644	Usuario FTP

Cómo cambiar propietario de archivos en Plesk

Si los archivos tienen el propietario incorrecto, puedes cambiarlo desde el administrador de archivos de Plesk:

Ve a "Administrador de archivos" en tu dominio.
Selecciona todos los archivos y carpetas.
Usa la opción "Cambiar propietario" y selecciona al usuario FTP correspondiente.
Aplica los cambios recursivamente.

[WARNING] Nunca pongas permisos 777 en archivos de producción. Esto es un riesgo de seguridad grave y puede causar problemas aún mayores.

Errores comunes adicionales y sus soluciones rápidas

Error 500 después de actualizar PrestaShop

Si el error aparece tras una actualización, suele ser por módulos incompatibles o caché obsoleta.

Solución:

Borra la carpeta var/cache completamente.
Desactiva temporalmente todos los módulos no esenciales desde la base de datos:

UPDATE ps_module SET active = 0 WHERE id_module NOT IN (1,2,3,4);

Reactiva los módulos uno a uno para identificar el culpable.

Error 500 en la página de administración

Si solo la parte de administración falla, suele ser por problemas de sesión o caché.

Solución:

Borra las cookies del navegador.
Limpia la carpeta var/cache y var/sessions.
Verifica que el archivo config/settings.inc.php tenga las credenciales correctas de la base de datos.

Error 503 intermitente que desaparece al recargar

Esto suele indicar problemas de caché o sobrecarga puntual.

Solución:

Activa la caché de PrestaShop (CCC) correctamente.
Considera usar una caché de página completa como Varnish si tu plan lo permite.
Revisa los logs de error en var/logs para identificar patrones.

Herramientas de diagnóstico en Plesk que debes conocer

Plesk ofrece herramientas útiles para diagnosticar estos problemas sin necesidad de SSH.

El registro de errores integrado

En Plesk, puedes ver los logs de errores de tu dominio directamente:

Ve a tu dominio → "Registros" o "Logs".
Busca los archivos error_log o php_error.log.
Los mensajes de error te darán pistas directas sobre el problema.

[TIP] Activa el registro de errores de PHP en Plesk si no está activo. Ve a "Configuración de PHP" y activa display_errors temporalmente para ver errores en pantalla.

Usando el administrador de bases de datos

A veces los errores vienen de problemas en la base de datos. Plesk incluye phpMyAdmin:

Ve a tu base de datos en Plesk.
Abre phpMyAdmin.
Revisa las tablas de PrestaShop en busca de errores:

CHECK TABLE ps_product;
REPAIR TABLE ps_product;

Prevención: cómo evitar futuros errores

La mejor solución es la prevención. Aquí tienes un checklist para mantener tu PrestaShop saludable en Plesk:

Mantenimiento regular recomendado

Semanal: Revisa los logs de errores y el espacio en disco.
Mensual: Actualiza PrestaShop y los módulos a sus últimas versiones estables.
Trimestral: Revisa los permisos de archivos y limpia cachés antiguas.
Antes de cambios: Siempre haz una copia de seguridad completa antes de actualizar o modificar configuraciones.

Buenas prácticas específicas para Plesk

Usa el administrador de archivos de Plesk para cambios menores, no FTP externo.
Configura copias de seguridad automáticas en Plesk para tener siempre una versión restaurable.
Mantén PHP en la versión recomendada por PrestaShop, no la más reciente necesariamente.
Documenta los cambios que haces en la configuración para poder revertirlos fácilmente.

[INFO] Si usas un panel de control diferente como Syspanel (accesible en el puerto 2106), los pasos serán similares pero la interfaz variará ligeramente. Los principios de solución de errores son universales.

Preguntas frecuentes (FAQ)

¿Por qué veo un error 500 solo en algunas páginas de mi tienda?

Si el error aparece solo en páginas específicas, suele ser por un módulo concreto o una plantilla problemática. Desactiva los módulos uno a uno o cambia temporalmente a la plantilla por defecto para identificar el problema.

¿Cuánto tiempo tarda en resolverse un error 503?

Depende de la causa. Si es por mantenimiento, se resuelve al desactivarlo. Si es por sobrecarga, puede tardar desde minutos hasta horas. Sigue los pasos de esta guía y normalmente lo resolverás en menos de 30 minutos.

¿Puedo dañar mi tienda al cambiar permisos manualmente?

Sí, si pones permisos incorrectos puedes empeorar el problema o crear vulnerabilidades de seguridad. Sigue estrictamente los permisos recomendados y usa la herramienta de reparación de Plesk cuando sea posible.

¿Debo contactar con soporte técnico o intentar resolverlo yo?

La mayoría de los errores 500 y 503 se resuelven siguiendo esta guía. Si después de todos los pasos el problema persiste, entonces sí es momento de contactar con soporte, proporcionando los logs de error y los pasos que ya has intentado.

¿Los errores de PrestaShop son diferentes en otros paneles como Syspanel?

Los errores de PrestaShop son independientes del panel de control, pero la forma de acceder a los archivos y configuraciones varía. En Syspanel (puerto 2106) encontrarás opciones similares a las de Plesk, pero con una interfaz diferente.

Conclusión: Resolviendo errores de PrestaShop en Plesk con confianza

Los errores 500 y 503 en PrestaShop con Plesk pueden parecer intimidantes al principio, pero como has visto, son problemas con soluciones claras y accionables. La clave está en abordarlos sistemáticamente: primero identifica la causa exacta, luego aplica la solución correspondiente y finalmente verifica que todo funciona correctamente.

Recuerda los puntos principales:

Los permisos de archivos son la causa más común y la