Error 500 en PrestaShop: causas y soluciones en Plesk y DirectAdmin

¡Hola! Si estás leyendo esto, probablemente te has topado con el temido error 500 en PrestaShop. No te preocupes, es uno de los problemas más comunes y, en la mayoría de los casos, tiene una solución sencilla. Este error es un "Error Interno del Servidor", lo que significa que algo falla en la configuración de tu tienda o en el servidor, pero no te da muchos detalles. Por eso, vamos a desglosar paso a paso cómo solucionar el error 500 en PrestaShop, especialmente si usas paneles de control como Plesk o DirectAdmin. Al final, tendrás tu tienda funcionando de nuevo.

¿Por qué aparece el error 500 en PrestaShop?

El error 500 es un "comodín" que puede tener muchas causas. En PrestaShop, las más comunes suelen ser:

Problemas de permisos de archivos y carpetas: PrestaShop necesita permisos específicos para leer y escribir archivos (por ejemplo, para la caché, los módulos o las imágenes). Si estos permisos se modifican, el sistema falla.
Errores en el archivo .htaccess: Este archivo controla las reglas de reescritura de URL (amigables) y la seguridad. Si se corrompe o tiene una línea incorrecta, el servidor no sabe cómo procesar las peticiones.
Módulos o temas incompatibles o con errores: A veces, una actualización o instalación de un módulo o tema genera conflictos con el núcleo de PrestaShop.
Límite de memoria PHP (memory_limit) insuficiente: Si tu tienda tiene muchos productos o módulos pesados, puede superar el límite de memoria asignado por el servidor.
Versión de PHP incompatible: PrestaShop requiere una versión de PHP específica. Si tu servidor tiene una versión muy antigua o muy nueva, puede dar error.
Corrupción en la caché de PrestaShop o de Smarty: Los archivos de caché acumulados pueden dañarse y provocar fallos.
Problemas con la base de datos (menos común, pero posible): Una tabla corrupta o una consulta mal formada también pueden generar un error 500.

Preparación antes de empezar: Accede al servidor

Para solucionar el error 500 en PrestaShop, necesitarás acceder a los archivos de tu tienda. Hay dos formas principales:

A través del panel de control (Plesk, DirectAdmin o Syspanel): Usa el administrador de archivos (File Manager) integrado.
A través de FTP (FileZilla, por ejemplo): Conéctate con tus credenciales de FTP.

[TIP]: Si no tienes mucha experiencia, el administrador de archivos del panel es más seguro porque evitas errores de conexión.

Solucionar error 500 PrestaShop en Plesk

Plesk es un panel muy popular. Aquí tienes los pasos para diagnosticar y arreglar el error:

Activar el modo debug de PrestaShop: Esto te mostrará el error real en lugar del genérico "500". Edita el archivo config/defines.inc.php en la raíz de tu tienda. Busca la línea:
define('_PS_MODE_DEV_', false);
Cámbiala a:
define('_PS_MODE_DEV_', true);
Guarda el archivo. Ahora, al cargar tu tienda, verás un mensaje de error detallado (por ejemplo, "Fatal error: Allowed memory size exhausted..."). Anota ese error, es tu pista principal.
Revisar los permisos de archivos y carpetas: En Plesk, ve a "Archivos" y luego a "Administrador de Archivos". Navega hasta la raíz de tu PrestaShop. Los permisos correctos son:
- Carpetas: 755 (rwxr-xr-x)
- Archivos: 644 (rw-r--r--)
- Archivos especiales (como config/settings.inc.php): 644 o 444.
  Para corregirlos, selecciona todo (Ctrl+A), haz clic en "Permisos" y establece 755 para carpetas y 644 para archivos. Si no sabes cómo hacerlo, muchos paneles tienen un botón "Restaurar permisos predeterminados".
Regenerar el archivo .htaccess: Ve a "Parámetros de la tienda" > "Tráfico y SEO" en el back office de PrestaShop (si puedes acceder). Si no, hazlo manualmente: renombra el archivo .htaccess a .htaccess_old desde el administrador de archivos. Luego, intenta acceder a tu tienda. Si funciona, el problema estaba en el .htaccess. Puedes regenerarlo desde el back office o pidiendo a tu hosting que lo haga.
Aumentar el límite de memoria PHP: En Plesk, ve a "Hosting & DNS" > "Configuración de PHP". Busca la opción memory_limit y cámbiala a 256M o 512M. Guarda los cambios. Esto es muy común si tienes muchos módulos.
Deshabilitar módulos problemáticos: Si el error apareció tras instalar un módulo, renombra la carpeta del módulo en /modules/nombre_del_modulo a /modules/nombre_del_modulo_old. Esto lo desactivará forzosamente. Luego, revisa si el error persiste.

Solucionar error 500 PrestaShop en DirectAdmin

DirectAdmin es otro panel muy usado. El proceso es similar pero con ligeras variaciones:

Activar el modo debug (igual que en Plesk): Edita config/defines.inc.php y cambia _PS_MODE_DEV_ a true.
Corregir permisos: Ve a "Administrador de Archivos" en DirectAdmin. Selecciona todos los archivos y carpetas de tu tienda. Haz clic en "Cambiar permisos". Marca las casillas para que las carpetas tengan 755 y los archivos 644. Una forma rápida es usar la opción "Aplicar a todos los subdirectorios" y luego "Aplicar a todos los archivos".
Regenerar .htaccess: Igual que en Plesk, renombra el archivo .htaccess a .htaccess_old. Si no ves el archivo, activa la opción "Mostrar archivos ocultos" en el administrador de archivos.
Aumentar el límite de memoria PHP: En DirectAdmin, ve a "Configuración de PHP" (suele estar en "Características adicionales" o "Administrador de cuentas"). Busca memory_limit y cámbialo a 256M o 512M. También puedes crear o modificar un archivo php.ini en la raíz de tu tienda con esta línea:
memory_limit = 256M
Si no existe, créalo.
Limpiar la caché de PrestaShop manualmente: Conecta por FTP o usa el administrador de archivos. Elimina todo el contenido de las siguientes carpetas (no las carpetas en sí, solo su interior):
- /var/cache/
- /cache/smarty/
- /cache/tcpdf/
  Si no puedes eliminar, renombra las carpetas (por ejemplo, cache_old) y crea nuevas vacías con los mismos nombres.

[WARNING]: Si usas Syspanel (el panel que antes se llamaba HestiaCP), el proceso es muy similar a DirectAdmin. Recuerda que el puerto de acceso a Syspanel es el 2106 (ejemplo: tudominio.com:2106). Los pasos para permisos, .htaccess y PHP son idénticos.

Causas avanzadas y soluciones

Si los pasos anteriores no funcionan, prueba estas soluciones más específicas:

1. El error es por un tema defectuoso

Solución temporal: Cambia al tema predeterminado de PrestaShop. Para ello, accede a tu base de datos phpMyAdmin (desde Plesk, DirectAdmin o Syspanel). Busca la tabla ps_configuration y localiza la fila con name = 'PS_THEME_NAME'. Cambia el valor a classic (o el nombre de tu tema predeterminado). Esto forzará a usar el tema por defecto.

2. El error es por un archivo de clase corrupto

Solución: Si el modo debug te muestra un error como "Class 'XXX' not found", es probable que un archivo de clase esté dañado o falte. La solución más rápida es reinstalar PrestaShop manteniendo los datos. Descarga la misma versión de PrestaShop desde tu área de cliente o desde el sitio oficial. Sube los archivos (sobrescribiendo) excepto la carpeta /img/ y el archivo config/settings.inc.php. Luego, ejecuta /install/ para reparar la instalación.

3. El error es por la versión de PHP

Solución: PrestaShop 1.6 funciona mejor con PHP 5.6 o 7.0. PrestaShop 1.7 necesita PHP 7.1 a 8.0 (según la versión). En Plesk o DirectAdmin, cambia la versión de PHP desde la configuración de hosting. Si usas Syspanel, también puedes hacerlo desde la sección de "PHP Settings".

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop

P: ¿El error 500 siempre es culpa del hosting?
R: No, la mayoría de las veces es por configuración de PrestaShop (permisos, .htaccess, módulos). Si después de seguir todos los pasos sigue fallando, contacta a tu hosting y pídeles que revisen los logs del servidor.

P: ¿Cómo puedo ver los logs de error si no activo el modo debug?
R: En Plesk, ve a "Logs" > "Logs de errores". En DirectAdmin, busca "Error Log" en el menú. En Syspanel, en "Logs" > "Error log". Busca la hora exacta del error y verás una línea como "PHP Fatal error...". Eso te dará la pista.

P: He hecho todo y el error persiste, ¿qué hago?
R: Prueba a restaurar una copia de seguridad reciente de tu tienda (archivos y base de datos). Si no tienes copia, contacta con tu proveedor de hosting. A veces, el error es por un problema en el servidor que solo ellos pueden arreglar.

P: ¿El error 500 puede afectar a mi SEO?
R: Sí, si el error dura mucho tiempo, Google puede interpretar que tu sitio no funciona y dejar de indexarlo. Es importante solucionarlo lo antes posible. Además, si tienes URLs indexadas que devuelven error 500, pueden perjudicar tu posicionamiento. Por eso, una vez solucionado, verifica con herramientas como Google Search Console.

Resumen rápido para solucionar el error 500 en PrestaShop

Activa el modo debug en config/defines.inc.php.
Corrige permisos a 755 carpetas y 644 archivos.
Regenera el .htaccess renombrándolo a .htaccess_old.
Aumenta el memory_limit a 256M o 512M.
Limpia la caché de PrestaShop (carpetas cache y var/cache).
Desactiva módulos renombrando sus carpetas en /modules/.
Revisa la versión de PHP y cámbiala si es necesario.
Si nada funciona, reinstala PrestaShop o contacta a tu hosting.

[INFO]: Recuerda que el error 500 en PrestaShop es frustrante pero casi siempre solucionable. La clave es ser metódico y no saltarse pasos. Si no te sientes seguro, pide ayuda a un técnico o a tu proveedor de hosting. ¡No dejes que un error 500 arruine tus ventas!

Espero que este artículo te haya ayudado a solucionar el error 500 en PrestaShop, ya sea en Plesk, DirectAdmin o Syspanel. Si te ha sido útil, compártelo con otros comerciantes que puedan estar pasando por lo mismo. ¡Buena suerte con tu tienda!