Error 500 en PrestaShop DirectAdmin: Causas y soluciones

¿Tu tienda PrestaShop muestra una pantalla en blanco o un mensaje genérico de Error 500? No te preocupes, es uno de los problemas más comunes en servidores con panel DirectAdmin y, aunque parezca grave, suele tener solución. En esta guía te explicaré paso a paso cómo solucionar error 500 en PrestaShop alojado en un servidor con DirectAdmin, desde lo más básico hasta técnicas avanzadas con logs.

¿Qué significa el Error 500 en PrestaShop?

El error 500 es un error genérico del servidor. Básicamente, significa que algo falló en el backend de tu tienda, pero el servidor no puede dar más detalles sin que revises los registros. En PrestaShop, puede deberse a:

Archivos corruptos o incompletos (por una actualización fallida o mala subida de módulos).
Problemas de permisos de archivos o carpetas.
Conflictos con módulos o temas.
Límites de memoria PHP excedidos.
Errores en el archivo .htaccess.

No te asustes: la mayoría de estos casos se resuelven en minutos si sabes dónde mirar.

Primeros pasos: diagnóstico rápido

Antes de meterte en logs técnicos, prueba estos pasos iniciales. Muchas veces el error es temporal o se soluciona limpiando la caché.

1. Limpia la caché de PrestaShop

Accede a tu panel de administración (si puedes). Ve a Parámetros avanzados > Rendimiento y haz clic en Limpiar caché. Si no puedes acceder al admin, borra manualmente la carpeta /var/cache dentro de la raíz de PrestaShop (por FTP o el administrador de archivos de DirectAdmin).

2. Desactiva temporalmente el SEO friendly (URLs amigables)

Si tienes acceso al administrador, ve a Parámetros de la tienda > Tráfico y SEO y desmarca la opción de URLs amigables. Si no, edita el archivo config/settings.inc.php (en versiones antiguas) o app/config/parameters.php y busca una línea similar a PS_REWRITING_SETTINGS y cambia el valor a 0.

3. Renombra el archivo .htaccess

El archivo .htaccess puede estar dañado. Conéctate por FTP o al administrador de archivos de DirectAdmin, ve a la raíz de tu tienda y renombra .htaccess a .htaccess_old. Luego, desde el admin de PrestaShop (si puedes acceder), ve a Parámetros de la tienda > Tráfico y SEO y haz clic en Guardar para regenerarlo.

[INFO] Si renombras .htaccess y el error desaparece, el problema estaba en ese archivo. Si no, vuelve a ponerle el nombre original.

Acceder a los logs del servidor (la clave para solucionar el error)

Cuando los pasos básicos fallan, necesitas leer los logs error servidor. En DirectAdmin, los logs suelen estar en:

DirectAdmin: Ve a Gestión de cuentas > Logs de errores o directamente a la carpeta /home/usuario/domains/tudominio.com/logs/. Busca archivos como error.log o php_error.log.
PrestaShop: En la carpeta raíz de tu tienda, busca var/logs/ (versiones 1.7+) o log/ (versiones 1.6). El archivo se llama prod.log o dev.log.

Abre el log más reciente con un editor de texto. Busca líneas que contengan PHP Fatal error o 500 Internal Server Error. Allí verás la causa exacta.

Ejemplo de log típico

[2025-03-20 10:15:23] request.CRITICAL: Uncaught PHP Exception Symfony\Component\Debug\Exception\FatalErrorException: "Allowed memory size of 134217728 bytes exhausted"

Eso indica que se agotó la memoria PHP. La solución es aumentarla.

Soluciones específicas según el error en los logs

Aumentar la memoria PHP (límite de memoria)

Si el log dice memory exhausted o allowed memory size, edita el archivo php.ini de tu dominio en DirectAdmin:

En DirectAdmin, ve a Configuración de PHP (o PHP Settings).
Busca memory_limit y cámbialo a 256M o 512M.
Guarda y reinicia el servicio PHP (o espera unos minutos).

También puedes hacerlo desde el archivo .htaccess añadiendo:

php_value memory_limit 256M

Permisos incorrectos de archivos

PrestaShop necesita permisos específicos. Si el log menciona failed to open stream: Permission denied, corrige los permisos:

Carpetas: 755
Archivos: 644
Configuración especial: la carpeta config y cache deben ser 777 temporalmente, pero luego vuelve a 755.

En DirectAdmin, usa el Administrador de archivos: selecciona toda la carpeta de tu tienda, haz clic en Cambiar permisos y aplica los valores correctos.

Módulo o tema conflictivo

Si el error aparece después de instalar un módulo o cambiar de tema, desactívalo. Si no puedes acceder al admin, renombra la carpeta del módulo desde FTP (por ejemplo, de modules/mimodulo a modules/mimodulo_off). Luego, ve al admin y desinstálalo.

Error de base de datos

Un error 500 también puede deberse a una tabla corrupta. Accede a phpMyAdmin desde DirectAdmin, selecciona la base de datos de PrestaShop y haz clic en Reparar tablas. Si hay errores, ejecuta OPTIMIZE TABLE en las tablas problemáticas.

[WARNING] Siempre haz una copia de seguridad de la base de datos antes de cualquier reparación.

Solución avanzada: restaurar archivos de PrestaShop

Si nada funciona, es posible que tengas archivos corruptos. Descarga la misma versión de PrestaShop que tienes instalada desde el sitio oficial y sube solo los archivos del núcleo (carpetas admin, classes, controllers, core, src, etc.). No sobrescribas la carpeta img, themes ni modules para no perder personalizaciones.

Pasos:

Ve a DirectAdmin > Administrador de archivos.
Sube el ZIP de PrestaShop y extráelo en una carpeta temporal.
Copia las carpetas del núcleo (sin img, themes, modules, config si tienes configuraciones personalizadas) y pégalas sobre tu instalación actual.
Sobrescribe los archivos cuando el sistema lo pida.
Limpia la caché de nuevo.

Preguntas frecuentes (FAQ)

¿Por qué aparece el error 500 solo en algunas páginas?

Suele ser por un módulo o tema que carga en esa página específica. Revisa los logs para ver qué archivo PHP falla.

¿El error 500 puede deberse al hosting?

Sí, si el servidor tiene recursos limitados o configuraciones restrictivas. Contacta a tu proveedor de hosting si el error persiste y no puedes aumentarlo desde DirectAdmin.

¿Cómo evito futuros errores 500?

Mantén PrestaShop y sus módulos actualizados.
Haz copias de seguridad periódicas.
No instales módulos de fuentes no confiables.
Monitorea los logs de errores semanalmente.

¿Pierdo datos si restauro archivos?

No, siempre que no sobrescribas la base de datos ni las carpetas de imágenes o temas personalizados.

Conclusión

El error 500 PrestaShop en un servidor DirectAdmin es frustrante, pero casi siempre tiene solución. Empieza por lo más simple (caché, .htaccess) y si no funciona, revisa los logs error servidor. Allí encontrarás la pista definitiva. Recuerda que la paciencia y un enfoque metódico son tus mejores aliados. Si después de todo esto el error persiste, tu proveedor de hosting puede ayudarte con configuraciones más profundas del servidor.

[TIP] Guarda esta guía en tus favoritos. Te será útil cada vez que tu tienda dé un respingo inesperado.