Solucionar error 500 en PrestaShop: Guía para DirectAdmin y Plesk

¿Por qué aparece el error 500 en PrestaShop?

El temido error 500 PrestaShop (también llamado "Error interno del servidor") es uno de los problemas más comunes y frustrantes para cualquier tienda online. La buena noticia es que, en la mayoría de los casos, tiene solución y no implica que hayas perdido tus datos.

Este error significa que el servidor encontró una condición inesperada que le impidió completar la petición. Es decir, tu tienda no puede cargar porque algo en la configuración del servidor o en los archivos de PrestaShop está fallando. Lo complicado es que el mensaje no te dice exactamente qué es lo que falla, pero no te preocupes: aquí te voy a enseñar a diagnosticarlo y solucionar error 500 paso a paso, tanto si usas DirectAdmin como Plesk.

Primeros pasos: identifica el problema

Antes de tocar nada, es fundamental saber si el error afecta a toda la web o solo a algunas páginas. También conviene revisar si has realizado algún cambio reciente (instalar un módulo, modificar un archivo, cambiar de servidor, etc.). Esto te dará pistas valiosas.

Activa el modo de depuración de PrestaShop

La forma más rápida de ver el error real es activar el modo de depuración. Para ello, edita el archivo config/defines.inc.php de tu instalación de PrestaShop.

Accede a tu panel de control (DirectAdmin o Plesk) y abre el Administrador de archivos.
Navega hasta la carpeta donde tienes instalado PrestaShop (normalmente public_html o httpdocs).
Busca la carpeta config y dentro de ella el archivo defines.inc.php.
Ábrelo con el editor de texto y busca la línea que dice define('_PS_MODE_DEV_', false);.
Cambia false por true. Guarda los cambios.

[WARNING] No dejes el modo de depuración activado para siempre. Es una herramienta de diagnóstico y, si se queda activo, cualquier visitante podrá ver errores internos de tu tienda. Desactívalo en cuanto termines de arreglar el problema.

Ahora recarga tu tienda. Verás un mensaje de error mucho más detallado (por ejemplo, un error de memoria, de permisos o de una consulta SQL). Apunta ese mensaje, te será muy útil para los siguientes pasos.

Solución 1: Revisa los permisos de archivos y carpetas

La causa más habitual del PrestaShop error servidor son los permisos incorrectos en archivos o carpetas. Si los permisos son demasiado restrictivos, el servidor no puede leer o escribir los archivos necesarios.

Cómo corregir permisos en DirectAdmin

Entra en DirectAdmin y abre el Administrador de archivos.
Selecciona todos los archivos y carpetas de tu instalación de PrestaShop (marca la casilla de "Seleccionar todo").
Haz clic en el botón "Cambiar permisos" (o "Chmod").
Aplica los siguientes valores:
- Carpetas: 755 (permisos de lectura, escritura y ejecución para el propietario; lectura y ejecución para el resto).
- Archivos: 644 (lectura y escritura para el propietario; solo lectura para el resto).
Guarda los cambios. A veces es necesario aplicar esta configuración de forma recursiva (a todas las subcarpetas), así que asegúrate de marcar la opción "aplicar a todos los archivos y subcarpetas".

Cómo corregir permisos en Plesk

En Plesk, ve a Sitios web y dominios y haz clic en Administrador de archivos.
Selecciona todos los archivos y carpetas de la raíz de tu dominio.
Haz clic en el icono de "Permisos" (suele ser un engranaje o un candado).
En la ventana emergente, define los permisos:
- Directorio: 755.
- Archivo: 644.
Marca la casilla "Cambiar los permisos de forma recursiva" y confirma.

[TIP] Si después de esto el error persiste, prueba con permisos 775 para carpetas y 664 para archivos. Algunos servidores con PHP ejecutado como módulo de Apache requieren permisos de grupo más amplios.

Solución 2: Aumenta el límite de memoria de PHP

Otro desencadenante muy común del error 500 PrestaShop es que el script se quede sin memoria. PrestaShop es una plataforma exigente, y si tu servidor tiene un límite de memoria bajo, puede fallar.

Modificar el límite de memoria en DirectAdmin

En DirectAdmin, ve a la sección "Administrador de archivos" y busca el archivo .htaccess en la raíz de tu dominio.
Ábrelo con el editor. Si no existe, puedes crearlo (asegúrate de que el nombre empiece por un punto).
Añade al principio del archivo (después de la línea RewriteEngine On) las siguientes líneas:
```
php_value memory_limit 256M
php_value max_execution_time 300
php_value max_input_time 120
```
Guarda el archivo y recarga tu tienda.

Modificar el límite de memoria en Plesk

En Plesk, ve a Sitios web y dominios y selecciona tu dominio.
Busca la sección "Configuración de PHP" (o "PHP Settings").
Dentro, localiza la opción memory_limit y cámbiala a 256M (o más, si tu plan lo permite).
Guarda los cambios. Plesk reiniciará PHP automáticamente.

[INFO] Si no encuentras la opción de PHP en Plesk, es posible que tu plan no la incluya. En ese caso, contacta con tu proveedor de hosting para que te la aumente.

Solución 3: Revisa el archivo `.htaccess`

El archivo .htaccess es el "manual de instrucciones" de Apache. Si está dañado o tiene reglas incorrectas, puede provocar un error 500 PrestaShop.

Regenerar el `.htaccess` desde el panel de administración de PrestaShop

La forma más sencilla de solucionar problemas con este archivo es regenerarlo desde el propio PrestaShop:

Accede a tu panel de administración de PrestaShop (por ejemplo, tudominio.com/admin123).
Ve a Parámetros Avanzados → Rendimiento.
En la sección "URLs", asegúrate de que la opción "Utilizar el archivo .htaccess" esté marcada.
Haz clic en "Guardar". Esto regenerará el archivo .htaccess automáticamente.

Si no puedes acceder al panel de administración

Si el error te impide entrar al panel, tendrás que hacerlo manualmente:

Ve al Administrador de archivos de tu panel de control.
Localiza el archivo .htaccess en la raíz de tu instalación.
Descárgalo a tu ordenador como copia de seguridad.
Crea un archivo nuevo vacío y súbelo (o edita el existente y bórralo por completo).
Recarga tu tienda. PrestaShop debería regenerarlo automáticamente al acceder a la página.

Solución 4: Revisa el registro de errores del servidor

Si los pasos anteriores no funcionan, el problema puede estar más oculto. La clave está en el log de errores del servidor. Ahí se registra el error exacto que está provocando el fallo.

Consultar logs en DirectAdmin

Entra en DirectAdmin.
Ve a la sección "Registros" o "Logs" (puede variar según la versión).
Busca el archivo error.log o error_log correspondiente a tu dominio.
Ábrelo y busca las últimas líneas. Ahí verás el error de PHP o de Apache que causa el problema.

Consultar logs en Plesk

En Plesk, ve a Sitios web y dominios.
Haz clic en el botón "Registros" (suele ser un icono de documento o un engranaje).
Selecciona el dominio y el tipo de registro (error).
Pulsa "Abrir" para ver el contenido del log.

[TIP] Los logs pueden ser abrumadores. Busca la palabra "error" o "fatal" en la última parte del archivo. Un error típico podría ser algo como PHP Fatal error: Call to undefined function... o Allowed memory size of X bytes exhausted.

Solución 5: Desactiva módulos problemáticos

A veces, un módulo mal configurado o incompatible es el culpable del error 500 PrestaShop. Si el error empezó después de instalar o actualizar un módulo, es muy probable que sea el responsable.

Desactivar módulos desde el panel de administración

Si tienes acceso al panel:

Ve a Módulos → Gestor de Módulos.
Ordena la lista por estado y ve desactivando los módulos que no sean esenciales (especialmente los de terceros).
Prueba a cargar tu tienda después de desactivar cada módulo.

Desactivar módulos manualmente

Si no puedes acceder al panel, tendrás que hacerlo desde el servidor:

Accede a tu base de datos MySQL desde phpMyAdmin (en DirectAdmin o Plesk).
Busca la tabla ps_module (el prefijo puede variar si lo cambiaste).
Localiza el módulo sospechoso y cambia su estado de 1 a 0 en la columna active.
Guarda y recarga tu tienda.

Solución 6: Verifica la versión de PHP

PrestaShop requiere una versión de PHP específica. Si tu servidor usa una versión demasiado antigua o demasiado nueva, puede provocar conflictos.

Cambiar la versión de PHP en DirectAdmin

En DirectAdmin, ve a "Opciones de PHP" (o "PHP Settings").
Selecciona la versión recomendada para tu PrestaShop (generalmente 7.4, 8.0 o 8.1, dependiendo de la versión de PrestaShop que uses).
Guarda los cambios.

Cambiar la versión de PHP en Plesk

En Plesk, ve a Sitios web y dominios.
Haz clic en "Configuración de PHP".
En la parte superior, verás un selector de versión de PHP. Elige la adecuada.
Guarda los cambios.

[WARNING] Verifica siempre la compatibilidad de tu versión de PrestaShop con la versión de PHP antes de cambiarla. Una versión incompatible puede generar más errores.

Preguntas frecuentes (FAQ)

¿Qué significa exactamente el error 500?

El error 500 es un error genérico del servidor. Significa que algo falló en la ejecución del código PHP o en la configuración del servidor, pero el servidor no puede mostrar el error específico al visitante. Por eso es tan importante revisar los logs.

¿Puedo perder mis datos si intento arreglar el error?

No, los pasos que te he mostrado (cambiar permisos, modificar .htaccess, aumentar memoria, desactivar módulos) no borran ni modifican tus productos, pedidos o clientes. Siempre es recomendable hacer una copia de seguridad antes de realizar cambios importantes.

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

Es posible, aunque no es la causa más común. Si sospechas que tu tienda ha sido comprometida, cambia todas las contraseñas (de la base de datos, del panel de control, del FTP) y revisa si hay archivos extraños en tu servidor.

¿Qué hago si nada de esto funciona?

Si después de seguir todos los pasos el error 500 PrestaShop persiste, te recomiendo contactar con el soporte técnico de tu hosting. Ellos tienen acceso a los logs a nivel de servidor y pueden identificar el problema más rápidamente. Proporciónales toda la información que hayas recopilado (mensajes de error, cambios recientes, etc.).

Conclusión final

El error 500 PrestaShop puede parecer un monstruo, pero con un diagnóstico metódico y las soluciones que te he dado, en la mayoría de los casos lo puedes resolver tú mismo. Recuerda: activa el modo de depuración para ver el error real, revisa los permisos, aumenta la memoria PHP y consulta los logs del servidor.

Si trabajas con DirectAdmin o Plesk, los pasos son muy similares y siempre tienes acceso a las herramientas necesarias. No te desesperes, respira hondo y ve paso a paso. Tu tienda volverá a estar operativa en poco tiempo.

[TIP] Si estás en un servidor con Syspanel (antes conocido como HestiaCP), recuerda que el acceso al panel se realiza a través del puerto 2106 (por ejemplo, https://tu-servidor:2106). Los pasos para arreglar el error son los mismos que en cualquier otro panel: revisar permisos, logs y configuración de PHP.

Y recuerda, la prevención es la mejor cura: mantén tu PrestaShop actualizado, haz copias de seguridad periódicas y no instales módulos de fuentes dudosas. Así evitarás muchos dolores de cabeza futuros.