Error 500 en PrestaShop DirectAdmin: Cómo solucionarlo

¿Qué es un Error 500 en PrestaShop y por qué ocurre?

El error 500, también conocido como "Error Interno del Servidor", es uno de los problemas más comunes al gestionar una tienda online con PrestaShop en un servidor con DirectAdmin. Se muestra como una página en blanco o con el mensaje "500 Internal Server Error". Este error es genérico: el servidor no puede procesar la solicitud, pero no da detalles específicos al usuario. La causa puede ser desde un archivo .htaccess corrupto hasta un plugin conflictivo o un límite de memoria excedido.

Para un usuario sin experiencia técnica, ver este error puede ser frustrante, pero la mayoría de las veces se soluciona con pasos sencillos. En este artículo te guiaremos paso a paso para diagnosticar y solucionar el error 500 en PrestaShop alojado en DirectAdmin. Al final, tendrás un checklist claro y herramientas para evitar que vuelva a ocurrir.

Diagnóstico Inicial: ¿Qué está fallando?

Antes de tocar archivos, es clave entender el origen. Sigue este orden:

Revisa los logs de error de DirectAdmin
Accede a tu panel DirectAdmin > "Gestión de Errores" o "Logs de Errores". Busca la sección "Error Log" del dominio afectado. Allí verás líneas como PHP Fatal error: Allowed memory size exhausted o require_once(): Failed opening required. Anota la línea y el archivo mencionado.
Activa el modo debug de PrestaShop
Temporalmente, puedes forzar a PrestaShop a mostrar errores detallados. Edita el archivo /config/defines.inc.php y cambia _PS_MODE_DEV_ de false a true. Esto revelará el error exacto en la pantalla.
Prueba con un tema por defecto
Si el error aparece después de instalar un tema o módulo, cambia temporalmente a un tema nativo (por ejemplo, "classic"). Puedes hacerlo desde el panel de administración de PrestaShop o renombrando la carpeta del tema actual en /themes/.
Desactiva módulos uno por uno
Si el error persiste, renombra la carpeta /modules/ a /modules_backup/ y crea una nueva vacía. Luego, ve añadiendo módulos de a uno para detectar el conflictivo.

[TIP] Si no puedes acceder al panel de administración, usa FTP o el gestor de archivos de DirectAdmin para hacer estos cambios.

Causas Comunes del Error 500 en PrestaShop con DirectAdmin

1. Archivo .htaccess corrupto o mal configurado

El archivo .htaccess de PrestaShop es sensible. Un error de sintaxis (como una regla de redirección mal escrita) provoca un error 500.

Solución:

Conéctate por FTP o al gestor de archivos de DirectAdmin.
Renombra el archivo .htaccess a .htaccess_old (esto desactivará las reglas).
Accede a tu tienda: si funciona, el problema está en el .htaccess.
Regenera el archivo desde el panel de administración de PrestaShop: "Configuración avanzada" > "Rendimiento" > "Regenerar archivo .htaccess".

2. Límite de memoria PHP insuficiente

PrestaShop necesita al menos 128 MB de memoria PHP, pero recomendamos 256 MB. Si tu tienda tiene muchos módulos o tráfico, puede superar el límite.

Solución:

En DirectAdmin, ve a "Configuración de PHP" (o "Select PHP version").
Busca memory_limit y cámbialo a 256M o 512M.
Guarda los cambios y reinicia el servicio PHP (en DirectAdmin suele hacerse automáticamente).

3. Permisos de archivos incorrectos

Los archivos de PrestaShop deben tener permisos específicos:

Carpetas: 755
Archivos: 644

Si accidentalmente cambiaste permisos (por ejemplo, a 777), el servidor puede bloquear la ejecución.

Solución:

Desde DirectAdmin, usa el "Gestor de Archivos" o FTP.
Selecciona la carpeta raíz de tu tienda.
Haz clic derecho > "Cambiar permisos" y establece 755 para carpetas y 644 para archivos.
También puedes ejecutar un script de reparación de permisos (muchos hosts lo ofrecen).

4. Módulo o tema incompatible

Actualizar PrestaShop sin actualizar módulos/temas, o viceversa, genera conflictos.

Solución:

Desactiva todos los módulos no esenciales.
Si el error desaparece, reactívalos de a uno.
Actualiza módulos desde el panel de administración o descarga versiones compatibles desde el marketplace.

5. Versión de PHP incorrecta

PrestaShop 1.6 requiere PHP 5.6 o 7.0; PrestaShop 1.7 necesita PHP 7.1 o superior (recomendado 7.4 o 8.0). Si tu servidor usa una versión antigua o demasiado nueva, puede fallar.

Solución:

En DirectAdmin, ve a "Select PHP Version" y elige la versión adecuada para tu PrestaShop.
Guarda y espera unos segundos.

6. Base de datos corrupta

Un error en la base de datos (por ejemplo, una tabla dañada) también puede generar un error 500.

Solución:

Usa phpMyAdmin en DirectAdmin (sección "Base de Datos").
Selecciona la base de datos de tu tienda.
Marca todas las tablas y elige "Reparar tabla" en el menú desplegable.

Guía Paso a Paso para Solucionar el Error 500

Paso 1: Accede a los logs de DirectAdmin

Inicia sesión en tu panel DirectAdmin (por ejemplo, tudominio.com:2222).
Ve a "Gestión de Errores" > "Error Log".
Busca la última línea con "500" o "Internal Server Error". Anota el archivo y la línea.

Paso 2: Activa el modo debug de PrestaShop

Conéctate por FTP o gestor de archivos.
Abre el archivo /config/defines.inc.php.
Busca define('_PS_MODE_DEV_', false); y cámbialo a define('_PS_MODE_DEV_', true);.
Guarda y recarga la tienda. Ahora verás el error detallado.

Paso 3: Revisa el archivo .htaccess

Renombra .htaccess a .htaccess_old.
Si la tienda funciona, el problema está ahí.
Regenera el .htaccess desde el panel de administración.

Paso 4: Aumenta la memoria PHP

En DirectAdmin, ve a "Configuración de PHP".
Cambia memory_limit a 256M o 512M.
Guarda y reinicia PHP si es necesario.

Paso 5: Verifica permisos

En el gestor de archivos, selecciona la carpeta raíz.
Haz clic en "Cambiar permisos" y aplica 755 a carpetas y 644 a archivos.
Si usas FTP, muchos clientes tienen opción de "Recursivo".

Paso 6: Desactiva módulos

Renombra la carpeta /modules a /modules_old.
Crea una carpeta /modules vacía.
Si la tienda funciona, reactiva módulos de a uno.

Paso 7: Actualiza PHP

En DirectAdmin, selecciona la versión correcta (por ejemplo, 7.4 para PrestaShop 1.7).
Guarda y espera.

Paso 8: Repara la base de datos

Abre phpMyAdmin.
Selecciona tu base de datos.
Marca todas las tablas y elige "Reparar".

[WARNING] Si después de todos estos pasos el error persiste, contacta a tu proveedor de hosting. Podría ser un problema del servidor (como un límite de recursos o un error en la configuración de PHP-FPM).

Preguntas Frecuentes (FAQ)

¿Por qué veo un error 500 solo en algunas páginas de mi tienda?

Esto suele deberse a un módulo específico o a un problema con el tema en esa página en particular. Activa el modo debug para ver el error exacto y desactiva módulos hasta encontrar el culpable.

¿El error 500 puede deberse a un ataque?

Sí, aunque es menos común. Un archivo malicioso o un intento de hacking puede corromper archivos. Revisa los logs de acceso en DirectAdmin para peticiones sospechosas. Si sospechas, restaura una copia de seguridad limpia.

¿Cómo evitar el error 500 en el futuro?

Mantén PrestaShop, módulos y temas actualizados.
Realiza copias de seguridad semanales.
No instales módulos de fuentes no confiables.
Monitorea los logs de error semanalmente.
Aumenta los límites de PHP antes de lanzar campañas de tráfico.

¿Qué hago si no tengo acceso al panel de administración?

Usa FTP o el gestor de archivos de DirectAdmin. Puedes modificar archivos directamente. Si el error impide cargar cualquier página, usa el modo debug como se explicó.

¿El error 500 afecta mi SEO?

Sí, porque los motores de búsqueda no pueden acceder a tu tienda. Si el error dura horas, puede impactar tu posicionamiento. Soluciona lo antes posible y, si es necesario, usa una página de mantenimiento temporal.

Conclusión

El error 500 en PrestaShop con DirectAdmin es frustrante pero casi siempre solucionable con paciencia y método. Recuerda:

Revisa los logs.
Activa el modo debug.
Prueba el .htaccess y los módulos.
Ajusta la memoria PHP y permisos.
Si falla todo, contacta a tu hosting.

Con esta guía, podrás diagnosticar y resolver el 90% de los casos. Si tu servidor usa Syspanel (el panel basado en HestiaCP, accesible por el puerto 2106), los pasos son similares: busca la sección de logs de error y configuración de PHP.

[INFO] Recuerda que mantener una copia de seguridad actualizada es tu mejor seguro contra cualquier error. ¡Buena suerte y que tu tienda vuele!