Error 500 en PrestaShop DirectAdmin: Solución Rápida

¿Qué significa el error 500 en PrestaShop y por qué aparece?

El error 500 prestashop es uno de los mensajes más temidos por cualquier persona que tenga una tienda online. Es un error genérico del servidor que indica que algo ha fallado internamente, pero no te dice exactamente qué es. Es como si tu tienda dijera "algo se ha roto, pero no te voy a decir el qué". Esto puede ser frustrante, pero no te preocupes: en la mayoría de los casos tiene solución y puedes diagnosticarlo tú mismo sin ser un experto en programación.

Cuando trabajas con prestashop directadmin, el error 500 puede aparecer por muchas razones. Las más comunes son: archivos con permisos incorrectos, un archivo .htaccess dañado, problemas de memoria PHP, módulos incompatibles o incluso una actualización fallida. La buena noticia es que, con una guía paso a paso, puedes identificar la causa y solucionar error 500 sin necesidad de contratar a un desarrollador.

En este artículo voy a explicarte, de forma clara y sencilla, cómo diagnosticar y resolver este problema en un entorno DirectAdmin. Vamos a ir desde lo más básico hasta lo más técnico, siempre con explicaciones fáciles de entender.

Antes de empezar: prepara tu entorno de trabajo

Para hacer un diagnóstico prestashop correcto, necesitas tener acceso a dos cosas: tu panel de control DirectAdmin y un cliente FTP o el administrador de archivos que incluye el propio panel. Si no sabes qué es esto, no te preocupes, te lo explico.

DirectAdmin es el panel desde donde gestionas tu hosting. Desde ahí puedes ver los archivos de tu web, cambiar permisos, gestionar bases de datos y mucho más. Para acceder a los archivos de PrestaShop, tienes dos opciones: usar el "Administrador de archivos" que viene integrado en DirectAdmin, o usar un programa como FileZilla conectándote por FTP. Cualquiera de las dos sirve, aunque para este tutorial te recomiendo usar el administrador de archivos de DirectAdmin porque es más visual y no necesitas instalar nada.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso es por el puerto 2106. El proceso de diagnóstico es prácticamente el mismo, solo cambia la interfaz del panel.

Primer paso: activa el modo depuración de PrestaShop

Lo primero que debes hacer para solucionar error 500 es saber qué está fallando exactamente. PrestaShop tiene un modo de depuración que muestra los errores en pantalla, pero normalmente está desactivado por seguridad. Vamos a activarlo.

Para ello, accede al administrador de archivos de DirectAdmin y busca la carpeta raíz de tu tienda. Normalmente se llama public_html o www. Dentro de esa carpeta, busca el archivo config/defines.inc.php. Ábrelo con el editor de texto que te ofrece DirectAdmin (suele tener un botón de "Editar").

Dentro del archivo, busca una línea que dice algo así:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda el archivo y recarga tu tienda. Ahora, en lugar del error 500 genérico, deberías ver un mensaje de error más específico, con una descripción del problema y la línea exacta donde se produce. Anota ese mensaje, porque te va a dar pistas muy valiosas.

[WARNING] No olvides volver a poner false cuando termines de diagnosticar, o tu tienda mostrará errores a los clientes y podría ser un riesgo de seguridad.

Segundo paso: revisa los permisos de archivos y carpetas

Uno de los motivos más habituales del error 500 prestashop son los permisos incorrectos. Cada archivo y carpeta de tu servidor tiene unos permisos que indican quién puede leer, escribir o ejecutar. Si estos permisos están mal configurados, PrestaShop no puede funcionar correctamente.

En DirectAdmin, selecciona todos los archivos y carpetas de tu tienda y haz clic en "Cambiar permisos". Los valores correctos para PrestaShop son:

Carpetas (directorios): 755
Archivos: 644
Archivos que necesitan escritura (como config/settings.inc.php o la carpeta cache): 775 o 777 temporalmente

Si no quieres hacerlo uno a uno, muchos paneles permiten aplicar permisos de forma recursiva. En DirectAdmin, marca la opción "Aplicar a subdirectorios" o similar.

[TIP] Si después de cambiar los permisos sigue el error, prueba a poner la carpeta var/cache (o cache en versiones antiguas) a 777, vaciar su contenido y volver a 755. Esto resuelve muchos problemas de caché corrupta.

Tercer paso: revisa el archivo .htaccess

El archivo .htaccess es un archivo de configuración que controla cómo funciona tu servidor web. Si está dañado o tiene reglas incompatibles, puede provocar un error 500 directo.

Para comprobarlo, ve al administrador de archivos y busca el archivo .htaccess en la raíz de tu tienda. Como los archivos que empiezan por punto suelen estar ocultos, activa la opción "Mostrar archivos ocultos" en la configuración de DirectAdmin.

Una solución rápida es renombrar este archivo a algo como .htaccess.bak y recargar tu tienda. Si el error desaparece, el problema era el .htaccess. PrestaShop generará uno nuevo automáticamente cuando recargues la página. Si no lo hace, ve a "Parámetros avanzados > Rendimiento" en el panel de administración y haz clic en "Regenerar archivo .htaccess".

[INFO] Al regenerar el .htaccess, PrestaShop crea uno limpio con las reglas de reescritura de URLs. Si usas URLs amigables, recuerda activarlas de nuevo si se desactivaron.

Cuarto paso: aumenta el límite de memoria PHP

Otro motivo muy común del error 500 prestashop es que PHP se queda sin memoria. Esto pasa sobre todo si tu tienda tiene muchos módulos, un catálogo grande o si acabas de instalar algo pesado.

Para aumentar el límite de memoria, busca en la raíz de tu tienda un archivo llamado php.ini. Si no existe, créalo. Dentro, escribe:

memory_limit = 256M
max_execution_time = 300
max_input_vars = 5000

Guarda el archivo y recarga. Si no funciona, también puedes probar a crear un archivo llamado .user.ini con el mismo contenido, o modificar estos valores desde DirectAdmin en la sección "Configuración PHP" o "Selector de versiones PHP".

[WARNING] Si tu hosting es compartido, el proveedor puede tener límites máximos que no puedas superar. En ese caso, contacta con soporte y pregunta por el límite permitido.

Quinto paso: desactiva módulos o temas problemáticos

Si el error apareció después de instalar un módulo o cambiar de tema, es muy probable que el problema esté ahí. Puedes desactivar módulos sin entrar al panel de administración editando la base de datos, pero hay una forma más sencilla.

Renombra la carpeta modules a modules_backup y crea una carpeta nueva llamada modules. Recarga tu tienda. Si el error desaparece, el problema es uno de los módulos. Ahora, para encontrar cuál es, ve moviendo los módulos de la carpeta modules_backup a la nueva carpeta modules de uno en uno, recargando la tienda cada vez. Cuando el error vuelva a aparecer, habrás encontrado al culpable.

Si el problema es del tema, renombra la carpeta themes de forma similar, o cambia temporalmente a un tema por defecto de PrestaShop como "classic".

[TIP] Antes de hacer esto, haz una copia de seguridad de tu tienda. Es mejor prevenir que curar, y si algo sale mal, puedes restaurarlo todo fácilmente.

Sexto paso: revisa los logs del servidor

Si después de todos estos pasos sigues con el error 500 prestashop, es hora de mirar los registros del servidor. DirectAdmin guarda logs de errores en la carpeta logs de tu cuenta, normalmente en ~/logs/error.log o ~/logs/error_domain.log.

Accede a estos archivos desde el administrador de archivos y busca las últimas líneas. Ahí verás el error exacto de PHP, con la ruta del archivo y la línea donde falla. Esto te dará la pista definitiva.

Algunos errores típicos que verás:

PHP Fatal error: Allowed memory size exhausted → problema de memoria (solución en el paso 4)
PHP Parse error: syntax error → archivo corrupto, probablemente de un módulo o tema
Permission denied → problema de permisos (solución en el paso 2)

[INFO] Si no encuentras los logs, revisa la sección "Registros de errores" dentro de DirectAdmin. Algunos paneles los muestran directamente en la interfaz.

Séptimo paso: comprueba la versión de PHP y requisitos de PrestaShop

PrestaShop tiene requisitos mínimos de PHP que van cambiando según la versión. Si tu hosting usa una versión de PHP demasiado antigua o demasiado nueva, puede dar errores.

En DirectAdmin, ve a la sección "Selector de versiones PHP" o "Configuración PHP" y comprueba qué versión tienes. Para PrestaShop 8, necesitas PHP 7.2.5 o superior, aunque se recomienda PHP 8.0 o 8.1. Para versiones antiguas de PrestaShop (1.6 o 1.7), PHP 7.4 suele ser la opción más estable.

Si cambias la versión de PHP, guarda los cambios y recarga tu tienda. A veces, simplemente cambiar a una versión más estable resuelve el problema.

[WARNING] Antes de cambiar de versión de PHP, asegúrate de que tus módulos y tema sean compatibles. Si no lo son, el error puede empeorar.

Octavo paso: restaura una copia de seguridad

Si nada de lo anterior funciona, la solución más rápida es restaurar una copia de seguridad reciente de tu tienda. DirectAdmin suele tener un sistema de copias de seguridad automáticas, o puedes tener las tuyas propias.

Ve a la sección "Copias de seguridad" de DirectAdmin, elige la más reciente anterior al error y restaura. Esto te devolverá a un estado en el que tu tienda funcionaba correctamente.

[TIP] Si no tienes copias de seguridad, pregúntale a tu proveedor de hosting si tiene alguna. Muchos guardan copias diarias aunque no lo anuncien.

Noveno paso: contacta con soporte

Si has llegado hasta aquí y sigues con el problema, no te desesperes. A veces el error 500 está causado por algo específico del servidor que no puedes controlar desde tu panel. En ese caso, contacta con el soporte de tu hosting.

Explícales qué has hecho y qué errores has visto en los logs. Cuanta más información les des, más rápido podrán ayudarte. Recuerda que el soporte técnico de hosting está para esto, y no tienes por qué saber resolverlo todo tú solo.

[INFO] Si tu hosting usa Syspanel (antes HestiaCP), recuerda que el acceso es por el puerto 2106. El soporte de ese panel suele ser muy ágil y pueden revisar los logs del servidor como tú no puedes hacerlo.

Preguntas frecuentes sobre el error 500 en PrestaShop

¿El error 500 afecta a mis clientes?
Sí, si tu tienda muestra un error 500, los clientes no podrán ver tu catálogo ni hacer pedidos. Es importante solucionarlo lo antes posible.

¿Puedo seguir trabajando en el panel de administración mientras hay error 500?
Depende. Si el error afecta solo a la parte pública, podrás acceder al panel. Si afecta a toda la instalación, no podrás entrar por ningún lado.

¿Cada cuánto debo hacer copias de seguridad?
Como mínimo una vez a la semana, y siempre antes de hacer cambios importantes como actualizaciones o instalación de módulos.

¿El error 500 puede deberse a un ataque informático?
Es posible, aunque no es lo más común. Si sospechas de un ataque, revisa los logs y busca archivos extraños en tu carpeta raíz.

Conclusión: el error 500 tiene solución, no te rindas

El error 500 prestashop puede parecer un muro infranqueable, pero como has visto, la mayoría de las veces tiene una solución clara y accesible. Siguiendo estos pasos de diagnóstico prestashop, podrás identificar la causa y solucionar error 500 en la mayoría de los casos.

Recuerda el orden lógico: activa el modo depuración para ver el error, revisa permisos, comprueba el .htaccess, aumenta la memoria PHP, desactiva módulos sospechosos, mira los logs y, si todo falla, restaura una copia o pide ayuda a soporte.

La paciencia es clave. No te saltes pasos y ve anotando todo lo que haces. Si al final tienes que contactar con soporte, esa información será oro puro para ellos.

Y sobre todo, no olvides desactivar el modo depuración cuando termines. Tu tienda y tus clientes te lo agradecerán.

Si este artículo te ha sido útil, compártelo con otros dueños de tiendas PrestaShop que puedan estar pasando por el mismo problema. Todos hemos estado ahí, y ayudar a otros a resolver este tipo de problemas hace que la comunidad sea más fuerte.