Solucionar error 500 en PrestaShop con DirectAdmin: Guía de diagnóstico

¿Qué significa exactamente el error 500 en PrestaShop?

Ver un mensaje de error 500 Internal Server Error en tu tienda PrestaShop es, sin duda, una de las experiencias más frustrantes para cualquier propietario de un negocio online. La tienda se vuelve inaccesible, los clientes no pueden comprar y tú no sabes por dónde empezar a buscar.

Lo primero que debes saber es que este error es genérico. No te dice qué está fallando, solo que algo ha salido mal en el servidor. Es como si tu coche se parara y el salpicadero solo te mostrara un mensaje de "fallo general" sin más detalles.

La buena noticia es que, si tu hosting utiliza DirectAdmin como panel de control, tienes a tu disposición todas las herramientas necesarias para diagnosticar y solucionar el problema. En esta guía completa, te explicaré paso a paso cómo solucionar el error 500 en PrestaShop desde DirectAdmin, incluso si no tienes experiencia técnica avanzada.

Antes de empezar, ten claro que este error puede deberse a múltiples causas: archivos con permisos incorrectos, un plugin conflictivo, problemas de memoria PHP, o un archivo .htaccess corrupto. Vamos a ir descartando causas una a una.

¿Por qué aparece el error 500 en PrestaShop?

El error 500 PrestaShop puede aparecer de repente o tras realizar algún cambio en la tienda. Las causas más comunes son:

Permisos de archivos y carpetas incorrectos: Si subiste archivos por FTP con permisos demasiado restrictivos o demasiado abiertos, el servidor no puede leerlos correctamente.
Archivo .htaccess dañado o con directivas incompatibles: PrestaShop genera este archivo automáticamente, pero a veces se corrompe.
Problemas de memoria PHP: Si tu tienda necesita más memoria de la que el servidor permite, PHP se detiene y lanza el error.
Módulos o temas incompatibles: Tras una actualización o instalación de un módulo, puede haber conflictos.
Errores en la base de datos: Aunque menos común, una tabla corrupta puede provocar este fallo.
Versión de PHP incompatible: Si tu hosting actualizó la versión de PHP y tu PrestaShop es antiguo, no funcionará.

Para solucionar 500 DirectAdmin, necesitamos identificar cuál de estas causas está provocando el problema. Vamos a hacerlo de forma metódica.

Paso 1: Accede a los logs de error desde DirectAdmin

El primer paso para cualquier diagnóstico 500 es revisar los registros de error del servidor. Estos logs contienen la información exacta de qué archivo y qué línea está fallando.

¿Dónde encontrar los logs en DirectAdmin?

Inicia sesión en tu panel de DirectAdmin.
Busca la sección "Gestión de Errores" o "Error Logs". En la mayoría de las versiones de DirectAdmin, esta opción está en el menú principal o dentro de "Información del dominio".
Selecciona tu dominio en el desplegable si tienes varios.
Haz clic en "Error Log" o "Registro de errores".

Verás un listado con líneas como esta:

[Thu Oct 10 10:15:32 2024] [error] [client 192.168.1.1] PHP Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 4096 bytes) in /home/usuario/domains/tutienda.com/public_html/classes/module/Module.php on line 1234

Esa línea te dice exactamente qué está fallando. En este ejemplo, el problema es que se agotó la memoria PHP permitida.

[TIP] Si no encuentras la sección de logs, usa el buscador del panel y escribe "Error Logs" o "Registro de errores".

¿Qué buscar en los logs?

"PHP Fatal error": Indica un error crítico de PHP. Lee el mensaje completo.
"Allowed memory size exhausted": Problema de memoria.
"Permission denied": Problema de permisos.
"Invalid command" o "RewriteRule": Problema con el .htaccess.

Anota el mensaje exacto, la ruta del archivo y el número de línea. Esta información es oro puro para solucionar el problema.

Paso 2: Comprueba y corrige los permisos de archivos y carpetas

Si los logs no muestran nada claro o no puedes acceder a ellos, el siguiente paso es revisar los permisos. PrestaShop necesita permisos específicos para funcionar.

Permisos correctos en PrestaShop

Carpetas (directorios): Deben tener permisos 755.
Archivos: Deben tener permisos 644.
Archivos especiales como config/settings.inc.php a veces necesitan 444 (solo lectura) por seguridad, pero si necesitas editarlos, 644.

Cómo cambiar permisos desde DirectAdmin

Entra en el Administrador de Archivos de DirectAdmin. Lo encontrarás en el menú principal.
Navega hasta la carpeta public_html de tu tienda.
Selecciona todos los archivos y carpetas. Puedes usar "Seleccionar todo" en la parte superior.
Haz clic en el botón "Cambiar permisos" o "Chmod".
Marca la opción "Aplicar a todos los archivos y subcarpetas" o similar.
Establece 755 para directorios y 644 para archivos. DirectAdmin suele tener opciones predefinidas para esto.

[WARNING] Ten cuidado al cambiar permisos masivamente. Si tu tienda tiene archivos con permisos especiales (como el settings.inc.php), puede que después tengas que ajustarlos manualmente.

Después de cambiar los permisos, prueba a cargar tu tienda. Si el error 500 persiste, sigue con el siguiente paso.

Paso 3: Regenera el archivo .htaccess

El archivo .htaccess de PrestaShop es crucial para el funcionamiento de las URLs amigables y otras funciones. Si está dañado, provoca el error 500.

Cómo regenerar el .htaccess desde el panel de PrestaShop

Accede a tu Panel de Administración de PrestaShop (normalmente en tutienda.com/admin).
Ve a Parámetros avanzados > Rendimiento.
En la sección "URLs amigables" o "Reglas de reescritura", encontrarás un botón que dice "Guardar" o "Actualizar". Haz clic en él.
PrestaShop regenerará automáticamente el archivo .htaccess.

¿No puedes acceder al panel de administración?

Si el error 500 también te bloquea el acceso al admin, tendrás que hacerlo manualmente:

Entra al Administrador de Archivos de DirectAdmin.
Navega a public_html.
Busca el archivo .htaccess. Puede que esté oculto. En el Administrador de Archivos, activa la opción "Mostrar archivos ocultos".
Renombra el archivo a .htaccess.bak (esto lo desactiva).
Intenta acceder a tu tienda. Si el error desaparece, el problema era el .htaccess.
Para regenerarlo, accede al panel de administración de PrestaShop (ahora debería funcionar) y sigue los pasos anteriores.

[INFO] Si no puedes regenerarlo desde el panel, puedes crear un .htaccess básico con el siguiente contenido y luego ajustarlo desde PrestaShop:
<IfModule mod_rewrite.c>
RewriteEngine On
</IfModule>
Esto no restaurará la funcionalidad completa, pero te permitirá acceder al panel para regenerar el archivo correcto.

Paso 4: Aumenta el límite de memoria PHP

Uno de los errores más comunes en los logs es el de "Allowed memory size exhausted". Si tu tienda tiene muchos productos, módulos o un tema pesado, el límite de memoria por defecto (normalmente 128M) puede ser insuficiente.

Cómo aumentar la memoria PHP en DirectAdmin

En DirectAdmin, busca la sección "Configuración de PHP" o "PHP Settings". En algunos paneles, está dentro de "Dominios" o "Cuenta".
Si tu hosting usa CloudLinux (muy común), verás una opción llamada "PHP Selector" o "MultiPHP Manager".
Selecciona tu dominio.
Busca la opción "memory_limit".
Cambia el valor a 256M o incluso 512M si tu plan de hosting lo permite.
Guarda los cambios y reinicia PHP si es necesario (puede que el panel te lo indique).

Si no encuentras esta opción, puedes intentar editarla manualmente:

Ve al Administrador de Archivos.
Navega a public_html.
Busca un archivo llamado php.ini. Si no existe, créalo.
Añade o modifica la línea: memory_limit = 256M
Guarda el archivo.

[WARNING] No todos los hostings permiten modificar php.ini. Si no funciona, contacta con tu proveedor de hosting y solicita el aumento de memoria.

Paso 5: Desactiva módulos o temas conflictivos

Si el error 500 apareció después de instalar o actualizar un módulo o tema, es muy probable que sea el culpable.

¿Cómo identificar el módulo problemático?

Accede a tu Panel de Administración de PrestaShop.
Ve a Módulos > Gestor de Módulos.
Revisa los módulos instalados recientemente o los que hayas actualizado.
Desactiva los módulos uno por uno, guardando los cambios y probando tu tienda después de cada uno.

¿No puedes acceder al panel de administración?

Si el error te impide entrar al admin, tendrás que desactivar módulos manualmente:

Entra al Administrador de Archivos de DirectAdmin.
Navega a public_html/modules/.
Verás una lista de carpetas, una por cada módulo instalado.
Renombra la carpeta del módulo sospechoso añadiendo un sufijo, por ejemplo: ps_googleanalytics.bak.
Prueba tu tienda. Si el error desaparece, has encontrado al culpable.
Repite el proceso con otros módulos si es necesario.

[TIP] Si no sabes cuál es el módulo problemático, renombra todos los módulos y ve activándolos de uno en uno. Es más tedioso, pero infalible.

Paso 6: Verifica la versión de PHP y PrestaShop

La incompatibilidad entre la versión de PHP de tu servidor y la de tu PrestaShop es otra causa frecuente del error servidor PrestaShop.

¿Cómo comprobar la versión de PHP?

En DirectAdmin, busca "PHP Version" o "Administrador de PHP".
Verás la versión actual de PHP para tu dominio.
Comprueba qué versión necesita tu PrestaShop. Puedes verlo en el archivo config/settings.inc.php o en la documentación de tu versión.

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

En el Administrador de PHP de DirectAdmin, selecciona tu dominio.
Elige una versión compatible. Para PrestaShop 1.7, se recomienda PHP 7.4 o 8.0. Para PrestaShop 8, PHP 8.1 o superior.
Guarda los cambios.

[INFO] Si tu PrestaShop es muy antiguo (1.6 o anterior), es posible que no sea compatible con PHP 8. En ese caso, deberías considerar actualizar PrestaShop o usar una versión de PHP más antigua (PHP 5.6 o 7.0), aunque esto último es menos seguro.

Paso 7: Revisa la base de datos

Aunque es menos común, una tabla corrupta en la base de datos puede causar el error 500.

Cómo verificar la base de datos desde DirectAdmin

En DirectAdmin, busca "MySQL Management" o "phpMyAdmin".
Entra en la base de datos de tu tienda.
En la pestaña "Exportar", exporta una copia de seguridad por si acaso.
En la pestaña "SQL", ejecuta la siguiente consulta para verificar las tablas:
```
CHECK TABLE nombre_de_tu_tabla;
```
(Reemplaza nombre_de_tu_tabla con cada tabla, o usa CHECK TABLE *; si tu versión de MySQL lo permite).
Si alguna tabla está dañada, ejecuta:
```
REPAIR TABLE nombre_de_tu_tabla;
```

[WARNING] Si no estás seguro de lo que estás haciendo, contacta con tu proveedor de hosting antes de ejecutar consultas SQL. Un error en la base de datos puede causar más problemas.

Paso 8: Restaura una copia de seguridad

Si has probado todos los pasos anteriores y el error 500 persiste, la solución más rápida puede ser restaurar una copia de seguridad de tu tienda de un momento en que funcionaba correctamente.

Cómo restaurar una copia de seguridad en DirectAdmin

Ve a "Backup" o "Copia de Seguridad" en DirectAdmin.
Verás las copias de seguridad disponibles (si tu hosting las realiza automáticamente).
Selecciona la copia más reciente anterior al problema.
Elige restaurar solo los archivos de public_html y la base de datos.
Confirma la restauración.

[TIP] Si no tienes copias de seguridad en DirectAdmin, revisa si tienes alguna en tu ordenador o en servicios de backup externos. Si no tienes ninguna, contacta con tu hosting para ver si pueden ayudarte.

Resumen rápido: Checklist para solucionar el error 500

Para que no te pierdas, aquí tienes una lista de verificación rápida:

Revisar los logs de error en DirectAdmin.
Corregir permisos de archivos y carpetas (755/644).
Regenerar el .htaccess desde PrestaShop o manualmente.
Aumentar la memoria PHP a 256M o 512M.
Desactivar módulos sospechosos.
Verificar la compatibilidad de la versión de PHP.
Revisar la base de datos con CHECK TABLE y REPAIR TABLE.
Restaurar una copia de seguridad si todo lo demás falla.

Preguntas frecuentes (FAQ)

¿Cuánto tiempo se tarda en solucionar el error 500?

Depende de la causa. Si es un problema de permisos o .htaccess, puede resolverse en 10-15 minutos. Si es un módulo conflictivo, puede llevar más tiempo identificar al culpable.

¿Puedo solucionar el error 500 sin acceso al panel de administración?

Sí, todos los pasos que hemos descrito se pueden realizar desde DirectAdmin y el Administrador de Archivos, sin necesidad de acceder al panel de PrestaShop.

¿El error 500 puede deberse a un ataque o hackeo?

Es posible. Si tu tienda ha sido comprometida, los archivos pueden haber sido modificados. Revisa los logs de acceso y busca archivos sospechosos en public_html. Si sospechas de un hackeo, contacta con tu proveedor de hosting inmediatamente.

¿Debo contactar con mi proveedor de hosting?

Si has agotado todos los pasos de esta guía y el error persiste, sí, es momento de contactar con tu proveedor de hosting. Ellos tienen acceso directo a los logs del servidor y pueden diagnosticar problemas a nivel de servidor que tú no puedes ver.

¿Cómo puedo prevenir el error 500 en el futuro?

Mantén PrestaShop, los módulos y el tema actualizados.
Realiza copias de seguridad periódicas y guárdalas en un lugar seguro.
Evita instalar módulos de fuentes no oficiales.
Monitoriza el espacio en disco y el uso de memoria de tu cuenta de hosting.
Revisa los logs de error regularmente para detectar problemas antes de que se conviertan en errores 500.

Espero que esta guía completa te haya sido de ayuda para solucionar el error 500 en PrestaShop desde DirectAdmin. Rec