Error 500 en PrestaShop DirectAdmin | Cómo arreglarlo

¡Entendido! Aquí tienes el artículo completo, optimizado para SEO y redactado en un tono cercano y didáctico, siguiendo todas las reglas de formato establecidas.

¿Te ha aparecido un molesto error 500 PrestaShop DirectAdmin en tu tienda online? Respira hondo. Aunque parezca un problema grave, es uno de los errores más comunes en el mundo del hosting y, en la mayoría de los casos, tiene una solución rápida y sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

Este error, conocido técnicamente como "Error Interno del Servidor", es una respuesta genérica del servidor cuando algo sale mal en la configuración de tu web. Es como si el servidor te dijera: "Algo ha pasado, pero no te voy a dar más detalles". Por eso, vamos a desglosar paso a paso cómo diagnosticar y solucionar error 500 PrestaShop utilizando el panel de control DirectAdmin, que es uno de los más usados y completos en el sector del hosting.

A lo largo de esta guía, te explicaré desde las causas más habituales hasta las soluciones más efectivas, siempre con un lenguaje claro y sin tecnicismos innecesarios. Al final, tendrás un plan de acción completo para que tu tienda vuelva a funcionar en pocos minutos.

¿Por qué ocurre el error 500 en PrestaShop?

Antes de lanzarnos a arreglar nada, es fundamental entender qué lo causa. El error 500 en PrestaShop no es un problema único, sino un síntoma de varios posibles fallos. Identificar la causa raíz es el primer paso para aplicar la solución correcta. Las causas más frecuentes suelen ser:

Permisos de archivos incorrectos: Es la causa más común. Si los archivos de tu tienda tienen permisos demasiado restrictivos o demasiado permisivos (por ejemplo, 777 en todos los archivos), el servidor puede bloquear la ejecución.
Archivo .htaccess corrupto o con errores: Este archivo es el "director de orquesta" de tu servidor. Una línea mal escrita o una directiva incompatible puede provocar un error inmediato.
Problemas de memoria PHP: Si tu tienda necesita más memoria de la que permite la configuración del servidor, se cae. Esto es habitual al instalar módulos nuevos o ampliar el catálogo.
Incompatibilidad de versiones de PHP: PrestaShop es exigente con la versión de PHP. Si tu hosting actualiza la versión y tu PrestaShop no está actualizado, pueden aparecer conflictos.
Módulos o temas conflictivos: Un módulo recién instalado o un tema mal codificado puede generar un conflicto fatal que detenga la ejecución de la tienda.

Conocer estas causas te ayudará a seguir los pasos de diagnóstico con una idea clara de por dónde empezar.

Primeros pasos: Diagnóstico inicial en DirectAdmin

Cuando veas el error 500, no entres en pánico. Lo primero que debes hacer es recopilar información. DirectAdmin te ofrece herramientas excelentes para ello. Vamos a empezar con un diagnóstico rápido.

1. Revisa el "Error Log" (Registro de errores)

Esta es la fuente de la verdad. El servidor guarda un registro detallado de todo lo que falla. Para acceder a él en DirectAdmin:

Inicia sesión en tu panel de DirectAdmin (normalmente en tudominio.com:2222).
Busca la sección "Gestión de Errores" o "Error Logs".
Haz clic en el enlace que dice "Errores del sitio" o "Site Error Log".
Verás un listado de los últimos errores con la fecha y hora exactas.

[INFO] El error log es tu mejor amigo. Busca la entrada que coincida con la hora en que empezó el problema. Verás un mensaje como PHP Fatal error: Allowed memory size of X bytes exhausted o PHP Warning: require(...): failed to open stream. Ese mensaje te indicará exactamente qué falla.

2. Comprueba el estado de tu PHP

DirectAdmin te permite cambiar la versión de PHP muy fácilmente. A veces, el error 500 aparece después de una actualización automática del PHP en el servidor.

En DirectAdmin, busca la sección "Configuración de PHP" o "PHP Settings".
Revisa qué versión de PHP está activa. Si es una versión muy reciente (como PHP 8.3) y tu PrestaShop es antiguo (versión 1.6 o inferior), es muy probable que ese sea el problema.
Prueba a cambiar temporalmente a una versión anterior (como PHP 7.4, que es la más estable para PrestaShop 1.7) para ver si el error desaparece.

Soluciones prácticas para el error 500 en PrestaShop

Una vez que tienes una pista de lo que ocurre, es hora de aplicar soluciones concretas. Aquí tienes las técnicas más efectivas, ordenadas de la más simple a la más compleja.

Solución 1: Aumentar el límite de memoria PHP

Este es el "arreglo mágico" para el 70% de los casos. Si el error log menciona "Allowed memory size", esta es tu solución.

¿Cómo se hace?

En tu panel de DirectAdmin, ve a la sección "Configuración de PHP" (a veces llamada "Selector de Versión de PHP").
Busca un campo llamado memory_limit.
Normalmente viene en 128M o 256M. Cámbialo a 512M o incluso 1024M (1GB) si tu plan de hosting lo permite.
Haz clic en "Guardar" o "Actualizar".
Recarga tu tienda. El error 500 debería desaparecer.

[TIP] Si no encuentras esta opción en el panel, también puedes intentar creando un archivo llamado php.ini en la carpeta raíz de tu tienda (donde está el archivo index.php). Dentro, escribe la línea: memory_limit = 512M. Luego, sube el archivo por FTP o desde el Administrador de Archivos de DirectAdmin.

Solución 2: Restablecer el archivo `.htaccess`

Un archivo .htaccess dañado es otra causa muy frecuente. Este archivo esconde la configuración de las URL amigables de PrestaShop y otras directivas importantes.

Pasos para restablecerlo:

Accede al Administrador de Archivos de DirectAdmin (también puedes usar un cliente FTP como FileZilla).
Navega hasta la carpeta raíz de tu tienda (normalmente public_html o una subcarpeta).
IMPORTANTE: Muestra los archivos ocultos. En DirectAdmin, suele haber un botón o casilla que dice "Mostrar archivos ocultos" o "Show Hidden Files".
Busca el archivo .htaccess. Si existe, renómbralo a .htaccess.bak (esto crea una copia de seguridad). Si no existe, no pasa nada, continúa.
Ahora, entra al panel de administración de tu PrestaShop. Si puedes entrar, ve a Preferencias > SEO y URLs y haz clic en el botón "Guardar" (no necesitas cambiar nada). Esto regenerará un archivo .htaccess limpio y funcional.
Si no puedes entrar al panel de administración, tendrás que crear un archivo .htaccess básico desde cero. Crea un archivo de texto llamado .htaccess en la raíz y pega este código básico:

<IfModule mod_rewrite.c>
RewriteEngine On
</IfModule>

Luego, recarga tu tienda. Si el error persiste, el problema no es el .htaccess.

Solución 3: Verificar y corregir los permisos de archivos

Los permisos de archivos en un servidor Linux son cruciales. PrestaShop necesita que los archivos tengan permisos de lectura y escritura, pero no todos.

¿Cómo corregirlos?

En el Administrador de Archivos de DirectAdmin, selecciona todos los archivos y carpetas de tu tienda.
Busca la opción "Cambiar permisos" o "Change Permissions".
Aplica los siguientes valores estándar:
- Carpetas (Directorios): 755
- Archivos: 644
Haz clic en "Guardar" o "Aplicar".
Excepción importante: La carpeta config y la carpeta cache necesitan permisos de escritura para el servidor. A veces, darlos a 755 no es suficiente. Si el error continúa, cambia los permisos de la carpeta config a 755 y los archivos dentro de config a 644. Para la carpeta cache, intenta con 755 para la carpeta y 644 para los archivos.

[WARNING] Evita usar permisos 777 de forma generalizada. Aunque soluciona el problema temporalmente, es un grave agujero de seguridad que permite a cualquiera modificar tus archivos. Úsalo solo como prueba rápida y vuelve a 755/644 en cuanto funcione.

Solución 4: Desactivar módulos problemáticos (por FTP o archivos)

Si el error apareció después de instalar o actualizar un módulo, es muy probable que el módulo sea el culpable. Si no puedes acceder al panel de administración, puedes desactivarlo manualmente.

Método manual:

Accede al Administrador de Archivos de DirectAdmin.
Ve a la carpeta /config/.
Busca el archivo settings.inc.php.
Ábrelo con el editor de texto de DirectAdmin.
Busca una línea que diga define('_PS_DISABLE_MODULES_', false); o algo similar.
Cambia el valor de false a true.
Guarda el archivo.
Ahora, intenta acceder a tu tienda. Debería cargar con los módulos desactivados.
Entra al panel de administración, ve a Módulos > Módulos y Servicios y desactiva el módulo que crees que causa el problema.
Vuelve a cambiar el valor en settings.inc.php a false para reactivar los módulos.

Solución 5: Verificar los logs de DirectAdmin (Acceso y Errores de Apache)

A veces, el error no es de PHP sino del propio servidor web (Apache). DirectAdmin tiene logs específicos para esto.

En DirectAdmin, ve a la sección "Gestión de Errores".
Busca el enlace a "Errores de Apache" o "Apache Error Log".
Revisa las últimas entradas. Busca mensajes como [core:error] o [cgi:error]. Estos te darán pistas sobre problemas de configuración del servidor o de scripts CGI.

Solución Avanzada: El modo de depuración de PrestaShop

Si has llegado hasta aquí y el error persiste, necesitas más información. PrestaShop tiene un modo de depuración que muestra el error exacto en la pantalla, en lugar de un simple "Error 500".

¿Cómo activarlo?

Accede al Administrador de Archivos.
Ve a la carpeta raíz de tu tienda y localiza el archivo config/defines.inc.php.
Ábrelo con el editor.
Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cambia false por true.
Guarda el archivo y recarga tu tienda.

Ahora verás un mensaje de error detallado en pantalla, con la ruta exacta del archivo y la línea donde ocurre el problema. Esto es oro puro para encontrar la solución.

[WARNING] ¡IMPORTANTE! No dejes el modo debug activado en tu tienda de producción. Es un riesgo de seguridad enorme, ya que muestra información sensible. Una vez que hayas solucionado el error, vuelve a poner _PS_MODE_DEV_ en false y guarda el archivo.

Preguntas Frecuentes (FAQ) sobre el Error 500

¿El error 500 puede deberse a un problema de mi conexión a internet?

No, el error 500 es un error del servidor. Aunque tu conexión esté fallando, el servidor procesará la solicitud y devolverá el error. Es un problema del lado del servidor, no de tu red local.

¿Puedo solucionar el error 500 sin acceso a DirectAdmin?

Es complicado, pero posible. Si solo tienes acceso FTP, puedes intentar las soluciones que no requieren el panel, como renombrar el .htaccess, cambiar permisos o activar el modo debug mediante el editor de archivos de tu cliente FTP. Sin embargo, DirectAdmin facilita mucho el proceso, especialmente para cambiar la versión de PHP o los límites de memoria.

¿Qué es Syspanel y qué tiene que ver con el error 500?

Syspanel es el nombre que damos a otro panel de control similar a DirectAdmin (específicamente HestiaCP). Si tu hosting usa Syspanel en lugar de DirectAdmin, el puerto de acceso es el 2106 (por ejemplo, tudominio.com:2106). Muchos de los pasos de esta guía son similares, pero la ubicación de las opciones puede variar. Busca secciones como "Configuración de PHP" o "Gestión de archivos".

¿Cuánto tiempo se tarda en solucionar este error?

Depende de la causa. Si es un problema de memoria, la solución es de 2 minutos. Si es un módulo conflictivo, puede llevarte 15-20 minutos. Con la ayuda de esta guía, la mayoría de los usuarios resuelven el problema en menos de 30 minutos.

Conclusión: Recupera el control de tu tienda

Enfrentarse a un error 500 PrestaShop DirectAdmin puede ser frustrante, pero como has visto, no es un callejón sin salida. Siguiendo estos pasos de diagnóstico y aplicación de soluciones, tendrás todas las herramientas para resolver el problema por ti mismo.

Recuerda que la clave está en la paciencia y en leer los mensajes de error. No te saltes pasos, y sobre todo, no te olvides de hacer una copia de seguridad de tus archivos antes de realizar cambios importantes. Con un poco de método, tu tienda volverá a estar operativa en muy poco tiempo.

Si después de todo esto el error persiste, es posible que el problema sea más profundo. En ese caso, te recomiendo contactar con el soporte técnico de tu proveedor de hosting, proporcionándoles los mensajes exactos del log de errores. Ellos tendrán acceso a la configuración del servidor y podrán ayudarte a nivel más avanzado. Pero no te desanimes, en el 99% de los casos, una de las soluciones de esta guía será suficiente.