Error 500 en PrestaShop con DirectAdmin: Solución definitiva

¿Qué significa exactamente el error 500 en PrestaShop?

Cuando ves un error 500 PrestaShop, significa que algo ha fallado en el servidor, pero el sistema no te dice exactamente qué es. Es un mensaje genérico que puede aparecer por muchas razones: un archivo con permisos incorrectos, un módulo incompatible, un problema con la memoria PHP o incluso un fallo en la base de datos.

Lo bueno es que, en la mayoría de los casos, puedes resolverlo tú mismo siguiendo una serie de pasos lógicos. En este artículo te voy a guiar para que arregles el DirectAdmin error 500 de tu tienda PrestaShop, incluso si no tienes mucha experiencia técnica.

Vamos a ir paso a paso, desde lo más básico hasta lo más avanzado, para que puedas recuperar tu tienda online cuanto antes.

Paso 1: Activa el modo de depuración de PrestaShop (¡el primer paso imprescindible!)

Antes de tocar nada, necesitas saber qué está fallando. PrestaShop tiene un modo de desarrollo que muestra el error real en pantalla, en lugar de la página genérica de "Error 500".

¿Cómo activar el modo debug?

Accede a tu panel de control DirectAdmin.
Busca la sección Administrador de archivos y entra en la carpeta public_html (o la carpeta donde esté instalada tu tienda).
Localiza el archivo llamado config/defines.inc.php.
Ábrelo con el editor de texto que te ofrece DirectAdmin (clic derecho → Editar).
Busca la línea que dice:
```
define('_PS_MODE_DEV_', false);
```
Cambia false por true:
```
define('_PS_MODE_DEV_', true);
```
Guarda los cambios y recarga tu tienda.

Ahora, en lugar del error 500, verás un mensaje más específico, como "Fatal error: Allowed memory size..." o "Uncaught exception...". Anota ese mensaje, porque te dirá exactamente qué problema tienes.

[INFO] Si no ves nada o la página sigue en blanco, revisa también el archivo .htaccess en la raíz de tu instalación. A veces también es necesario activar la visualización de errores de PHP desde ahí.

Paso 2: Aumenta el límite de memoria PHP (la solución más común)

El error 500 PrestaShop suele aparecer cuando el servidor se queda sin memoria PHP. Esto es especialmente común si tu tienda tiene muchos módulos o si acabas de instalar un plugin pesado.

¿Cómo aumentar el límite de memoria en DirectAdmin?

Entra en DirectAdmin y ve a la sección Configuración de PHP (o PHP Settings, dependiendo de la versión).
Busca la opción memory_limit.
Cambia el valor a al menos 256M (o 512M si tu plan lo permite).
Guarda los cambios y recarga tu tienda.

Si no encuentras esa sección, también puedes hacerlo manualmente:

Ve al Administrador de archivos.
Abre el archivo php.ini (si no existe, créalo en la raíz de tu instalación).
Añade o modifica esta línea:
```
memory_limit = 256M
```
Guarda y prueba de nuevo.

[TIP] Si tu tienda es grande o tienes muchos productos, te recomiendo poner 512M directamente. Es mejor prevenir que lamentar.

Paso 3: Revisa los permisos de archivos y carpetas

Los permisos incorrectos son otra causa muy frecuente del DirectAdmin error 500. PrestaShop necesita que ciertos archivos y carpetas tengan permisos específicos para funcionar.

Permisos correctos que deberías tener:

Carpetas: 755
Archivos: 644
La carpeta cache y var/cache: 755 (o incluso 777 si tu hosting es antiguo)

¿Cómo cambiar permisos en DirectAdmin?

Ve al Administrador de archivos.
Selecciona todos los archivos y carpetas de tu instalación (Ctrl+A o Cmd+A).
Haz clic derecho → Cambiar permisos.
Introduce 755 para carpetas y 644 para archivos.

[WARNING] No pongas permisos 777 en todos los archivos de forma general. Eso es un riesgo de seguridad muy grave. Solo hazlo en carpetas temporales si es estrictamente necesario y durante poco tiempo.

Paso 4: Limpia la caché de PrestaShop y de tu navegador

A veces el error 500 no es un problema real, sino una caché corrupta que sigue intentando cargar algo que ya no existe.

Limpiar caché de PrestaShop:

Accede a tu panel de administración de PrestaShop (si puedes entrar, claro).
Ve a Parámetros avanzados → Rendimiento.
Haz clic en Vaciar la caché (tanto la de Smarty como la de compilación).

Si no puedes acceder al panel de administración, hazlo manualmente:

Entra en DirectAdmin → Administrador de archivos.
Ve a la carpeta var/cache (o cache, dependiendo de la versión).
Elimina todo el contenido de esa carpeta (no la carpeta en sí, solo lo que hay dentro).

Limpiar caché del navegador:

En Google Chrome, pulsa Ctrl + Shift + Supr.
Marca la opción Imágenes y archivos almacenados en caché.
Haz clic en Borrar datos.

Vuelve a cargar tu tienda y comprueba si el error ha desaparecido.

Paso 5: Desactiva módulos sospechosos (si puedes acceder al panel)

Un módulo recién instalado o actualizado puede estar causando el conflicto. Si puedes entrar en el panel de administración, sigue estos pasos:

Ve a Módulos → Administrador de módulos.
Ordena por Últimamente actualizados o Más recientes.
Desactiva los módulos que hayas instalado o actualizado recientemente.
Ve a Parámetros avanzados → Rendimiento y vuelve a vaciar la caché.

Si el error desaparece, ya sabes cuál es el culpable. Puedes probar a actualizarlo o contactar con el desarrollador del módulo.

Si no puedes acceder al panel:

Entra en DirectAdmin → Administrador de archivos.
Ve a la carpeta modules.
Renombra la carpeta del módulo sospechoso añadiendo _backup al final (por ejemplo, ps_banner_backup).
Recarga la tienda. Si se arregla, ese era el problema.

[TIP] Haz una copia de seguridad antes de renombrar cualquier módulo. Siempre es mejor prevenir.

Paso 6: Revisa el archivo .htaccess

El archivo .htaccess de PrestaShop puede estar dañado o contener reglas incompatibles con tu servidor.

¿Cómo regenerar el .htaccess?

Ve al Administrador de archivos en DirectAdmin.
Localiza el archivo .htaccess en la raíz.
Renómbralo a .htaccess_bak (para tener una copia de seguridad).
Si tu tienda funciona, genial. Si no, tendrás que generar uno nuevo.

Para generar uno nuevo:

Entra en tu panel de administración de PrestaShop.
Ve a Parámetros avanzados → URLs.
Guarda la configuración sin cambiar nada (clic en Guardar).

PrestaShop regenerará el .htaccess automáticamente.

[WARNING] Si no puedes acceder al panel, puedes usar el archivo .htaccess que viene por defecto en la instalación de PrestaShop. Búscalo en internet o en la documentación oficial y sustitúyelo.

Paso 7: Comprueba la versión de PHP

PrestaShop es muy sensible a la versión de PHP. Si tu hosting ha actualizado PHP recientemente a una versión incompatible, tu tienda puede dar error 500.

Versiones recomendadas según la versión de PrestaShop:

PrestaShop 1.7: PHP 7.1 a 7.4 (PHP 8.0 si tienes la última versión).
PrestaShop 1.6: PHP 5.6 a 7.1.

¿Cómo cambiar la versión de PHP en DirectAdmin?

Ve a Configuración de PHP o PHP Selector en tu panel.
Elige la versión adecuada para tu PrestaShop.
Guarda y recarga tu tienda.

[INFO] Si no sabes qué versión de PrestaShop tienes, mira el archivo config/settings.inc.php o app/config/parameters.php en la raíz. Ahí suele aparecer la versión.

Paso 8: Revisa los logs del servidor

Si nada de lo anterior funciona, es hora de mirar los registros del servidor. DirectAdmin guarda logs de errores que te darán pistas exactas.

¿Dónde encontrar los logs en DirectAdmin?

Ve a Registros de errores o Error Logs en tu panel.
Busca la sección de Apache o PHP.
Abre el log más reciente y busca errores relacionados con tu dominio.

Los mensajes suelen ser algo como:

PHP Fatal error: Uncaught Error: Call to undefined function...
PHP Warning: require(...): failed to open stream...

Con esa información, puedes buscar soluciones específicas en Google o contactar con soporte técnico.

Paso 9: Verifica la base de datos

Un error en la base de datos también puede provocar el error 500 PrestaShop. Por ejemplo, si una tabla está corrupta o si hay un problema de conexión.

¿Cómo comprobar la base de datos?

Ve a phpMyAdmin desde DirectAdmin.
Selecciona tu base de datos de PrestaShop.
En la pestaña Operaciones, busca la opción Optimizar tablas o Reparar tablas.

Si no encuentras esa opción, también puedes ejecutar una consulta SQL:

CHECK TABLE ps_connections;

[WARNING] No hagas cambios en la base de datos sin hacer una copia de seguridad antes. Un error aquí puede dejarte la tienda completamente inaccesible.

Paso 10: Contacta con tu proveedor de hosting

Si has probado todos los pasos anteriores y el DirectAdmin error 500 persiste, puede que el problema esté en el servidor, no en tu tienda.

Cuándo contactar con soporte:

Si el error empezó después de un cambio en el servidor.
Si otros sitios en el mismo hosting también dan error.
Si no puedes acceder ni al panel de administración.

Cuando contactes con ellos, dales toda la información que hayas recopilado: el mensaje de error exacto, los logs que has visto y los pasos que ya has probado. Así te ayudarán mucho más rápido.

Preguntas frecuentes (FAQ)

¿Por qué me sale error 500 en PrestaShop sin haber tocado nada?

Puede deberse a una actualización automática de PHP, a un cambio en los permisos del servidor o a un módulo que ha fallado en segundo plano. Sigue los pasos anteriores en orden y seguro que lo encuentras.

¿Cuánto tiempo se tarda en arreglar un error 500?

Depende de la causa. Si es la memoria PHP, en 5 minutos está solucionado. Si es un módulo conflictivo, puede llevar un par de horas. Si es un problema del servidor, tendrás que esperar a tu proveedor.

¿Puedo perder datos si sigo estos pasos?

No, siempre que no borres archivos o bases de datos sin hacer copia de seguridad. Los pasos que te he dado son seguros y reversibles.

¿Qué hago si el error 500 aparece solo en el panel de administración?

Eso suele indicar un problema con un módulo de administración o con la caché. Prueba a limpiar la caché manualmente y a desactivar módulos recientes.

Resumen final

El error 500 PrestaShop es frustrante, pero en la mayoría de los casos tiene solución. Recuerda el orden lógico:

Activa el modo debug para ver el error real.
Aumenta la memoria PHP.
Revisa los permisos.
Limpia la caché.
Desactiva módulos sospechosos.
Regenera el .htaccess.
Comprueba la versión de PHP.
Mira los logs del servidor.
Repara la base de datos.
Contacta con soporte si nada funciona.

Con paciencia y siguiendo estos pasos, tu tienda volverá a estar online en poco tiempo. Y si tienes alguna duda, déjala en los comentarios o consulta con tu proveedor de hosting. ¡Mucho ánimo!