Error 500 en PrestaShop: Soluciones para Plesk y DirectAdmin

Comprendiendo el Error 500 en PrestaShop

El temido error 500 PrestaShop (también conocido como "Error interno del servidor") es uno de los problemas más comunes y frustrantes que puedes encontrar al gestionar tu tienda online. Básicamente, significa que algo salió mal en el servidor, pero el sistema no te da detalles específicos para proteger la seguridad del sitio.

No te preocupes, la mayoría de las veces tiene solución y no necesitas ser un experto técnico para resolverlo. Vamos a guiarte paso a paso para solucionarlo, tanto si usas Plesk como DirectAdmin como panel de control de tu hosting.

[INFO] El error 500 es genérico. Puede deberse a un plugin conflictivo, un archivo .htaccess corrupto, falta de memoria PHP o incluso un tema mal configurado. Lo importante es ir descartando causas una por una.

Causas Más Comunes del Error 500 en PrestaShop

Antes de lanzarnos a las soluciones, es útil entender qué puede estar provocando el error:

Archivo .htaccess dañado o mal configurado: Es el archivo de configuración del servidor web. Si se corrompe, PrestaShop no puede funcionar.
Módulo o tema incompatible: Una actualización reciente de un módulo o tema puede romper la compatibilidad con tu versión de PrestaShop.
Límite de memoria PHP excedido: Si tu tienda tiene muchos productos o procesos pesados, puede superar el límite de memoria asignado.
Permisos de archivos incorrectos: Los archivos y carpetas de PrestaShop necesitan permisos específicos para que el servidor pueda leerlos y escribirlos.
Problemas con la caché: La caché de PrestaShop o del servidor puede almacenar configuraciones corruptas.
PHP desactualizado o incompatible: Una versión de PHP muy antigua o muy nueva puede no ser compatible con tu versión de PrestaShop.

Solucionar Error 500 PrestaShop en Plesk

Plesk es un panel de control muy popular. Aquí tienes los pasos para atacar el problema desde este entorno.

Paso 1: Habilitar el Modo Debug de PrestaShop

El primer paso para solucionar error 500 PrestaShop es obtener más información. Necesitas activar el modo de depuración (debug mode).

Conéctate a tu servidor por FTP usando un cliente como FileZilla, o accede al Administrador de Archivos desde el panel de Plesk.
Navega hasta la carpeta raíz de tu tienda (normalmente httpdocs o public_html).
Busca el archivo config/defines.inc.php.
Ábrelo con un editor de texto (como el bloc de notas).
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda el archivo y súbelo de nuevo (si usaste FTP).
Ahora, recarga tu tienda. Verás un mensaje de error mucho más descriptivo, como "Fatal error: Uncaught Error: Class 'X' not found...". Ese mensaje te indicará exactamente qué módulo o archivo está fallando.

[WARNING] Una vez resuelto el error, NO OLVIDES volver a poner _PS_MODE_DEV_ en false. Dejarlo activo en producción expone información sensible de tu servidor.

Paso 2: Renombrar el Archivo .htaccess

A veces, el archivo .htaccess se corrompe. Forzar a PrestaShop a regenerarlo es una solución rápida.

Desde el Administrador de Archivos de Plesk o por FTP, localiza el archivo .htaccess en la raíz de tu tienda.
Renómbralo a htaccess_old o .htaccess_backup.
Ve al panel de administración de PrestaShop (si puedes acceder).
Ve a Configuración de la tienda > Tráfico y SEO > URL amigables.
Sin cambiar nada, haz clic en Guardar. Esto regenerará el archivo .htaccess automáticamente.
Prueba tu tienda de nuevo.

Paso 3: Aumentar el Límite de Memoria PHP en Plesk

Si el error persiste, puede ser falta de memoria.

En Plesk, ve a Hosting & DNS y selecciona tu dominio.
Busca la sección Configuración de PHP (a veces está en un botón de "Opciones de PHP").
Busca el parámetro memory_limit.
Si está en 128M o menos, cámbialo a 256M o incluso 512M.
Haz clic en Aceptar o Aplicar.
Limpia la caché de tu navegador y vuelve a cargar tu tienda.

[TIP] Si no encuentras memory_limit, puedes crearlo manualmente en el mismo cuadro de texto. Escribe memory_limit = 256M.

Solucionar Error 500 PrestaShop en DirectAdmin

DirectAdmin es otro panel muy común. Los pasos son similares pero con ligeras diferencias en la interfaz.

Paso 1: Activar el Modo Debug (igual que en Plesk)

El proceso es exactamente el mismo. Accede por FTP o al Administrador de Archivos de DirectAdmin, edita config/defines.inc.php y cambia _PS_MODE_DEV_ a true. Esto te dará la pista definitiva.

Paso 2: Regenerar el .htaccess

Desde el Administrador de Archivos de DirectAdmin, ve a la carpeta domains -> tudominio.com -> public_html.
Localiza el archivo .htaccess y renómbralo a .htaccess.bak.
Accede a tu back office de PrestaShop (si puedes).
Navega a Configuración de la tienda > Tráfico y SEO > URL amigables y pulsa Guardar.

Paso 3: Ajustar la Memoria PHP desde DirectAdmin

En DirectAdmin, ve a Configuración de la cuenta.
Busca y haz clic en Versión de PHP y Configuración (o Select PHP Version).
Se abrirá una nueva ventana o pestaña. Busca la opción Switch to PHP Options.
Localiza memory_limit y cámbialo a 256M.
Guarda los cambios.

Paso 4: Deshabilitar Módulos Problemáticos

Si el modo debug te señaló un módulo específico (por ejemplo, "ps_facebook"), debes deshabilitarlo desde la base de datos o por FTP.

Por FTP: Ve a la carpeta modules dentro de tu instalación de PrestaShop. Busca la carpeta del módulo problemático (ej. ps_facebook) y renómbrala a ps_facebook_old. Esto forzará a PrestaShop a ignorarlo.
Por Base de Datos (más avanzado): Accede a phpMyAdmin desde tu panel de control. Busca la tabla ps_module (el prefijo ps_ puede variar). Localiza el módulo y cambia su estado de 1 a 0.

Soluciones Generales para Ambos Paneles

Limpiar la Caché de PrestaShop

A veces, una caché corrupta es la culpable.

Accede a tu Back Office de PrestaShop.
Ve a Configuración avanzada > Rendimiento.
En la parte superior, verás un botón que dice Limpiar la caché. Púlsalo.
También puedes hacerlo manualmente borrando la carpeta /var/cache desde FTP (no la borres entera, solo su contenido: dev, prod, class_index.php, etc.).

Verificar los Permisos de Archivos

Los permisos incorrectos pueden generar un error 500.

Las carpetas deben tener permiso 755.
Los archivos deben tener permiso 644.
El archivo settings.inc.php (en /config/) debe tener permiso 644 o 444.

Puedes cambiar los permisos desde el Administrador de Archivos de Plesk o DirectAdmin, o con tu cliente FTP (clic derecho > "Permisos de archivo" o "File permissions").

Probar con el Tema por Defecto

Si el error apareció tras instalar un tema nuevo, el tema es el sospechoso.

Accede a la base de datos por phpMyAdmin.
Busca la tabla ps_configuration.
Localiza la fila con name = PS_CSS_THEME y PS_JS_THEME. Anota el valor (será el nombre de tu tema actual).
Cambia esos valores por el nombre del tema por defecto (normalmente classic).
Guarda y recarga tu tienda. Si funciona, el problema es tu tema.

[INFO] Si no te sientes cómodo tocando la base de datos, contacta a tu soporte técnico para que te ayuden a cambiar el tema desde ahí.

FAQ: Preguntas Frecuentes sobre el Error 500 en PrestaShop

P: ¿Por qué veo un error 500 solo en algunas páginas?
R: Esto suele indicar un problema con un módulo específico que se carga solo en esas páginas. Activa el modo debug para identificar el módulo conflictivo.

P: ¿Actualizar PHP soluciona el error 500?
R: Sí, a veces. Asegúrate de usar una versión de PHP compatible con tu PrestaShop. PrestaShop 1.7 funciona bien con PHP 7.4, 8.0 y 8.1. PrestaShop 8 requiere PHP 8.1 o superior.

P: ¿Puedo solucionar el error 500 sin acceso al Back Office?
R: Sí. Puedes hacerlo todo por FTP o desde el panel de control (Plesk/DirectAdmin): editar archivos, renombrar módulos, regenerar .htaccess y cambiar permisos.

P: ¿El error 500 puede ser por un ataque de seguridad?
R: Es posible. Si el error aparece de repente y no has hecho cambios, revisa los archivos de tu tienda en busca de código sospechoso o consulta los logs de acceso del servidor.

P: ¿Qué hago si después de todo el error persiste?
R: Contacta con tu proveedor de hosting. Puede ser un problema de configuración del servidor (como un límite de ejecución de scripts o un error en la configuración de PHP-FPM) que solo ellos pueden resolver. Proporciónales los mensajes de error del modo debug.

Resumen Final

El error 500 PrestaShop es frustrante, pero casi siempre reparable. Recuerda la secuencia lógica:

Activa el modo debug para obtener la pista exacta.
Renombra el .htaccess y deja que PrestaShop lo regenere.
Aumenta el límite de memoria PHP a 256M o 512M.
Deshabilita módulos y temas sospechosos uno por uno.
Limpia la caché y verifica los permisos de archivos.
Si nada funciona, pide ayuda a tu hosting.

Con paciencia y estos pasos, tu tienda volverá a estar online en pocos minutos. ¡Mucho éxito!