Error 500 en PrestaShop | Arreglar con DirectAdmin

¿Qué significa el error 500 en PrestaShop?

El error 500 Internal Server Error es uno de los mensajes más temidos y, a la vez, más comunes en el mundo del hosting. Si estás leyendo esto, es muy probable que tu tienda PrestaShop se haya quedado en blanco con un mensaje parecido a "500 Internal Server Error" o "An error occurred".

Pero no te preocupes: este error no significa que hayas perdido tus datos ni que tu tienda esté rota para siempre. En la mayoría de los casos, es un problema de configuración, permisos o memoria que se puede resolver en pocos minutos, incluso si no eres un experto técnico.

En este artículo, te voy a explicar paso a paso cómo arreglar el error 500 en PrestaShop cuando tu sitio está alojado en un servidor con DirectAdmin. Vamos a ver desde las causas más comunes hasta las soluciones más efectivas, con un lenguaje claro y sin tecnicismos innecesarios.

¿Por qué aparece el error 500 en PrestaShop?

Antes de lanzarnos a solucionar, es importante entender qué está pasando. El error 500 es un mensaje genérico que indica que el servidor encontró un problema interno pero no puede dar más detalles.

En el caso concreto de DirectAdmin + PrestaShop, las causas más frecuentes son:

Permisos de archivos y carpetas incorrectos (el clásico problema de los archivos con permisos 777 o 644 mal configurados).
Archivo .htaccess corrupto o con reglas incompatibles.
Memoria PHP insuficiente (PrestaShop es una plataforma exigente).
Errores en la configuración de PHP (versión incompatible, módulos desactivados, etc.).
Un módulo o plugin recién instalado que genera un conflicto.
Problemas con la caché de PrestaShop o de DirectAdmin.
Sobrescritura de archivos del núcleo (core) por alguna modificación manual.

Vamos a atacar cada una de estas causas de forma ordenada.

Paso 1: Activa el modo debug de PrestaShop

Lo primero que necesitas es saber qué está fallando exactamente. PrestaShop tiene un modo de depuración que muestra el error real en pantalla en lugar de un simple "500".

Cómo activar el modo debug (con acceso a archivos)

Accede a tu panel de DirectAdmin (normalmente en https://tu-dominio.com:2222).
Ve al Administrador de archivos (File Manager).
Navega hasta la carpeta raíz de tu instalación de PrestaShop (por ejemplo, public_html o una subcarpeta).
Busca el archivo config/defines.inc.php.
Ábrelo con el editor de texto integrado.
Busca la línea que dice: define('_PS_MODE_DEV_', false);
Cámbiala por: define('_PS_MODE_DEV_', true);
Guarda los cambios y recarga tu tienda.

Ahora, en lugar del error 500, verás un mensaje detallado con el archivo y la línea exacta del problema. Anota ese mensaje, te será muy útil.

[WARNING] No olvides desactivar el modo debug cuando hayas solucionado el problema. Dejarlo activado en producción es un riesgo de seguridad grave.

Paso 2: Revisa los permisos de archivos y carpetas

Los permisos incorrectos son la causa número uno del error 500 en PrestaShop. Si algún archivo no puede ser leído o ejecutado por el servidor, la tienda fallará.

Permisos correctos para PrestaShop

Carpetas (directorios): deben tener permisos 755.
Archivos: deben tener permisos 644.
Archivos de configuración especiales (como config/settings.inc.php): 644 o 444 en producción.

Cómo cambiar permisos en DirectAdmin

En el Administrador de archivos de DirectAdmin, selecciona la carpeta raíz de PrestaShop.
Marca todos los archivos y carpetas (puedes usar Ctrl+A).
Haz clic en "Cambiar permisos" o "Permissions" en el menú superior.
Introduce 755 para carpetas y 644 para archivos.
Aplica los cambios.

[TIP] Si no sabes distinguir archivos de carpetas, hazlo en dos pasos: primero selecciona solo las carpetas y luego solo los archivos.

Si después de esto el error persiste, pasa al siguiente paso.

Paso 3: Regenera el archivo .htaccess

El archivo .htaccess de PrestaShop es fundamental para el funcionamiento de las URLs amigables y el redireccionamiento. Si se corrompe o contiene reglas incompatibles con tu versión de PHP o Apache, provocará un error 500.

Cómo regenerar el .htaccess

Conéctate a tu servidor por FTP o usa el Administrador de archivos de DirectAdmin.
Localiza el archivo .htaccess en la raíz de PrestaShop.
Renómbralo a algo como .htaccess.bak (esto lo desactiva).
Ve al panel de administración de PrestaShop (si puedes acceder).
Ve a Parámetros avanzados → URL (o "SEO y URLs").
Sin cambiar nada, haz clic en Guardar. Esto regenerará un .htaccess nuevo.
Si no puedes acceder al panel admin, crea un .htaccess nuevo con el contenido básico:

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

Y luego intenta acceder. Si la tienda carga, el problema era el .htaccess.

[INFO] Si usas Syspanel (antes llamado HestiaCP) en lugar de DirectAdmin, el proceso es idéntico. Solo cambia el puerto de acceso, que en Syspanel es el 2106.

Paso 4: Aumenta la memoria PHP

PrestaShop necesita al menos 256 MB de memoria PHP para funcionar correctamente. Si tu servidor tiene un límite inferior, los procesos internos fallarán y verás el error 500.

Cómo aumentar la memoria en DirectAdmin

Accede a tu panel de DirectAdmin.
Ve a Configuración de PHP o PHP Settings (a veces está dentro de "Advanced Features").
Busca la directiva memory_limit.
Cámbiala a 256M o 512M.
Guarda los cambios y reinicia PHP (o espera unos segundos).

Si no encuentras la opción, puedes crear o editar un archivo php.ini en la raíz de tu sitio con este contenido:

memory_limit = 512M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M

[TIP] También puedes añadir estas líneas al archivo .htaccess si tu servidor lo permite:
php_value memory_limit 512M

Paso 5: Cambia la versión de PHP

PrestaShop es muy sensible a la versión de PHP. Si tu tienda fue creada con PHP 7.4 y ahora tu servidor usa PHP 8.3, es muy probable que aparezcan errores de compatibilidad.

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

Entra en DirectAdmin.
Busca la sección "PHP Version" o "Select PHP Version".
Prueba con una versión PHP 7.4 o PHP 8.0 (las más estables para PrestaShop 1.7).
Guarda y recarga la tienda.

[WARNING] Si cambias de versión, ten en cuenta que algunos módulos pueden dejar de funcionar. Si el error desaparece, el problema era la incompatibilidad de versión.

Paso 6: Desactiva módulos recientes o conflictivos

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

Cómo desactivar módulos sin acceso al panel admin

Accede a la base de datos de PrestaShop a través de phpMyAdmin (disponible en DirectAdmin).
Busca la tabla ps_module (el prefijo puede variar si lo cambiaste).
Localiza el módulo sospechoso.
Cambia el valor de active de 1 a 0.
Guarda y recarga la tienda.

Si no sabes cuál es el módulo problemático, puedes desactivarlos todos y luego irlos activando uno a uno.

Alternativa rápida: renombrar la carpeta del módulo

Ve al Administrador de archivos de DirectAdmin.
Navega a modules/.
Busca la carpeta del módulo que crees que está causando el problema.
Renómbrala añadiendo un guion bajo al principio (ej: _ps_banner).
Recarga la tienda.

Si la tienda funciona, ese módulo era el problema.

Paso 7: Limpia la caché de PrestaShop

A veces la caché acumulada puede generar conflictos internos que resultan en el error 500. Limpiarla es una solución muy sencilla.

Cómo limpiar la caché manualmente

Ve al Administrador de archivos de DirectAdmin.
Navega a var/cache/ (en PrestaShop 1.7) o cache/ (en versiones antiguas).
Elimina todos los archivos dentro de la carpeta dev y prod (pero no las carpetas en sí).
También puedes eliminar la carpeta cache/class_index.php si existe.

[TIP] Si no puedes acceder por archivos, puedes limpiar la caché desde el panel admin en Parámetros avanzados → Rendimiento → Vaciar la caché.

Paso 8: Revisa los logs del servidor

Si después de todos los pasos anteriores el error 500 PrestaShop sigue apareciendo, es hora de mirar los logs del servidor. Ellos te dirán exactamente qué está fallando.

Dónde encontrar los logs en DirectAdmin

Ve a DirectAdmin → Logs o Error Logs.
Busca el archivo error.log correspondiente a tu dominio.
Revisa las últimas líneas. Busca errores como:
- PHP Fatal error: Allowed memory size exhausted
- PHP Parse error: syntax error
- Failed to open stream: Permission denied

Con esa información, podrás aplicar una solución específica.

Paso 9: Restaura desde una copia de seguridad

Si nada de lo anterior funciona, la solución más rápida y segura es restaurar una copia de seguridad de tu tienda a un estado anterior donde funcionaba correctamente.

Cómo restaurar en DirectAdmin

Ve a DirectAdmin → Backup/Restore.
Selecciona la copia de seguridad más reciente (idealmente de antes de que apareciera el error).
Restaura tanto los archivos como la base de datos.
Espera a que termine y recarga tu tienda.

[INFO] Si no tienes copias de seguridad en DirectAdmin, revisa si tu proveedor de hosting las hace automáticamente. Muchos ofrecen copias diarias.

Preguntas frecuentes sobre el error 500 en PrestaShop

¿El error 500 significa que he perdido mis datos?

No, en absoluto. El error 500 es solo un mensaje de fallo temporal. Tus productos, pedidos y configuraciones siguen intactos en la base de datos.

¿Puedo evitar que vuelva a pasar?

Sí, siguiendo buenas prácticas:

Mantén PrestaShop y sus módulos siempre actualizados.
No instales módulos de dudosa procedencia.
Haz copias de seguridad semanales.
Revisa los permisos de archivos después de cualquier modificación.

¿Cuánto tiempo se tarda en arreglar?

Si sigues los pasos en orden, la mayoría de los casos se resuelven en menos de 30 minutos. Los casos más complejos (como conflictos de módulos) pueden llevar algo más.

¿Necesito conocimientos avanzados?

No. Con este artículo y acceso a tu panel de DirectAdmin, puedes resolver el problema tú mismo. Si te sientes inseguro, siempre puedes contactar con tu proveedor de hosting, pero te recomiendo intentarlo antes.

Conclusión

El error 500 en PrestaShop con DirectAdmin puede ser frustrante, pero como has visto, tiene solución. Hemos recorrido los pasos más efectivos: desde activar el modo debug, revisar permisos, regenerar el .htaccess, aumentar la memoria PHP, cambiar la versión de PHP, desactivar módulos conflictivos, limpiar caché y, en última instancia, restaurar una copia de seguridad.

Mi recomendación es que vayas paso a paso, en orden, y que vayas comprobando después de cada uno si el error desaparece. Así identificarás la causa raíz y podrás solucionar PrestaShop de forma definitiva.

Recuerda que este tipo de errores son normales en el mundo del hosting y no significan que tu tienda esté mal hecha. Con paciencia y las herramientas adecuadas, tu tienda volverá a estar en línea en poco tiempo.

[TIP] Guarda este artículo en favoritos. Te será útil la próxima vez que aparezca un error 500 PrestaShop o cualquier otro error de PrestaShop similar.

Y si en algún momento necesitas ayuda con Syspanel (el panel que antes se llamaba HestiaCP), recuerda que su acceso es por el puerto 2106 y el proceso de solución es prácticamente el mismo que el que hemos visto aquí.

¡Mucha suerte con tu tienda y no dudes en volver a consultar esta guía si lo necesitas!