Cómo solucionar el error 500 en PrestaShop (DirectAdmin y Syspanel)

[INFO] Este artículo está pensado para que cualquier persona, aunque no tenga experiencia técnica avanzada, pueda seguir los pasos y resolver el temido error 500 PrestaShop. Vamos a ello, sin prisas, paso a paso.

El error 500 es, probablemente, el error más frustrante que te puedes encontrar al gestionar una tienda online con PrestaShop. Es un error genérico del servidor que te dice "algo ha ido mal, pero no te digo exactamente qué". Afortunadamente, en la mayoría de los casos, tiene una solución clara y no implica perder tus datos. En este artículo, nos vamos a centrar en cómo solucionar el error 500 específicamente en entornos de hosting con paneles de control DirectAdmin y Syspanel (el antiguo HestiaCP, que ahora se accede por el puerto 2106).

Vamos a desglosar el problema en pasos lógicos, desde los más sencillos y seguros hasta los que requieren un poco más de manipulación técnica. No te preocupes, iremos de la mano.

¿Qué es exactamente el Error 500 y por qué aparece?

Antes de lanzarnos a arreglar nada, es importante entender qué significa. El código 500 Internal Server Error es una respuesta genérica del servidor web (Apache, LiteSpeed, Nginx) que indica que ha ocurrido un error inesperado en el servidor mientras intentaba procesar tu solicitud. No es un error de tu navegador, sino un problema en el servidor donde está alojada tu tienda.

Las causas más comunes en PrestaShop son:

• Permisos de archivos incorrectos: Los archivos de tu tienda tienen permisos que no permiten al servidor leerlos o escribirlos correctamente.
• Archivo .htaccess corrupto o con directivas incompatibles: Este archivo es crucial para las URL amigables y la configuración del servidor.
• Errores de PHP: Un módulo o tema está generando un error fatal que detiene la ejecución de todo el script.
• Memoria PHP insuficiente: Tu tienda necesita más memoria de la que el servidor le permite usar.
• Problemas con la caché: Una caché corrupta o desactualizada puede provocar conflictos.
• Archivos de configuración dañados: Como config/settings.inc.php o los archivos de parámetros.

Paso 1: Lo Primero es Diagnosticar (Activa el Modo Depuración)

No podemos arreglar lo que no entendemos. La primera y mejor arma es activar el modo de depuración de PrestaShop. Esto hará que, en lugar de un escueto "error 500", veas un mensaje de error detallado con la causa exacta.

Para ello, necesitas acceder a los archivos de tu tienda. Puedes hacerlo de dos maneras:

1. A través del Administrador de Archivos en DirectAdmin o Syspanel (más fácil).
2. A través de un cliente FTP como FileZilla.

Una vez que tengas acceso a la raíz de tu instalación de PrestaShop (la carpeta donde están las carpetas admin, config, classes, etc.), busca el archivo llamado config/defines.inc.php.

Abre este archivo con un editor de texto (el propio visor de archivos del panel o el bloc de notas de tu ordenador). Busca la línea que dice:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda el archivo y vuelve a cargar tu tienda. Ahora verás un mensaje de error mucho más descriptivo, como "Fatal error: Uncaught Error: Call to undefined function...". Ese mensaje es oro puro. Apúntalo, porque si no sabes qué significa, nos lo puedes pegar en un buscador o en un foro de ayuda.

[WARNING] Si activas el modo desarrollo, tu tienda será visible para el público con errores técnicos. Te recomiendo que lo hagas y lo revises rápidamente, y luego lo vuelvas a poner en false. Si no puedes ver el error porque la tienda está en producción, puedes intentar acceder desde el móvil con datos en lugar de WiFi, o usar una herramienta de "ver como" de tu navegador.

Paso 2: Soluciones Rápidas y Comunes para el Error 500

Si el mensaje de error no es claro o prefieres probar soluciones genéricas, aquí tienes las más efectivas.

2.1. Regenerar el Archivo .htaccess

Este es el primer sospechoso habitual. Un archivo .htaccess dañado o con reglas de reescritura (URL amigables) incompatibles con el servidor es una causa muy común.

Cómo solucionarlo:

1. Accede a la raíz de tu PrestaShop.
2. Busca el archivo .htaccess. Es un archivo oculto, así que asegúrate de que tu visor de archivos o FTP muestre los archivos ocultos.
3. Descárgalo a tu ordenador como copia de seguridad (por si acaso).
4. Elimina el archivo .htaccess del servidor.
5. Ve a la parte de administración de tu tienda: Back Office > Parámetros avanzados > Rendimiento.
6. En la sección "URLs amigables", haz clic en el botón "Guardar" (aunque no hayas cambiado nada). Esto regenerará el archivo .htaccess con las reglas correctas para tu servidor.

Si no puedes acceder al Back Office, simplemente deja el archivo eliminado. PrestaShop funcionará, aunque las URLs no serán tan bonitas. Es una solución temporal para que puedas entrar al panel de administración.

2.2. Verificar los Permisos de Archivos y Carpetas

Los permisos incorrectos son otra causa muy frecuente. Los archivos deben tener permisos 644 y las carpetas 755. Si algo tiene 777 o 666, puede ser un riesgo de seguridad y provocar errores.

Cómo solucionarlo:

1. En tu panel de control (DirectAdmin o Syspanel), busca la herramienta "Administrador de Archivos" o "File Manager".
2. Navega hasta la raíz de tu PrestaShop.
3. Selecciona todos los archivos y carpetas. En la mayoría de los gestores, hay una opción para "seleccionar todo".
4. Busca la opción "Cambiar permisos" o "Chmod".
5. Establece los permisos en 755 para las carpetas y 644 para los archivos. La herramienta suele tener una casilla para "aplicar a subcarpetas y archivos". Márcala y aplica.

[INFO] Si tienes dudas de cómo hacerlo, el soporte de tu hosting puede hacerlo por ti, pero es un proceso sencillo que puedes aprender en 5 minutos.

2.3. Aumentar el Límite de Memoria PHP

A veces, un módulo o una página muy compleja agota la memoria asignada a PHP.

Cómo solucionarlo:

1. Accede a la raíz de tu PrestaShop.

2. Busca el archivo llamado index.php.

3. Ábrelo con un editor de texto.

4. Al principio del archivo, justo después de la línea <?php, añade la siguiente línea:

   ini_set('memory_limit', '512M');

5. Guarda el archivo y recarga la página.

Si esto funciona, el error desaparecerá. Si no, no pasa nada, podemos probar otra cosa. Si el problema persiste, es posible que tu plan de hosting no permita ese límite, y tendrías que hablar con tu proveedor.

Paso 3: Soluciones Avanzadas en DirectAdmin y Syspanel

Ahora vamos a entrar en el panel de control. Aquí es donde podemos hacer cambios más profundos.

3.1. Reiniciar PHP y el Servidor Web

A veces, un simple reinicio del servicio de PHP o del servidor web (Apache/LiteSpeed) puede limpiar errores temporales y procesos colgados.

En DirectAdmin:

1. Inicia sesión en DirectAdmin.
2. Ve a la sección "Servicios del sistema" o "System Services". A veces está en "Extra Features" o similar.
3. Busca los servicios relacionados con PHP (PHP-FPM, por ejemplo) y el servidor web (Apache, LiteSpeed, Nginx).
4. Haz clic en el botón de reiniciar (normalmente un icono de "restart").

En Syspanel (HestiaCP, puerto 2106):

1. Accede a tu Syspanel escribiendo https://tu-dominio.com:2106 en tu navegador.
2. Ve a la sección "Servidor" o "Server" en el menú lateral.
3. Busca la lista de servicios. Deberías ver "Apache" o "Nginx" y "PHP-FPM".
4. Haz clic en el icono de reiniciar junto a cada uno de ellos.

[TIP] Reiniciar los servicios no borra ningún dato, es completamente seguro. Es como apagar y encender tu ordenador cuando va lento.

3.2. Revisar los Logs de Error del Servidor

Esta es la forma más profesional de diagnosticar. Los logs son archivos donde el servidor registra todos los errores que ocurren.

En DirectAdmin:

1. Ve a la carpeta logs dentro de tu cuenta de usuario.
2. Busca archivos como error_log, error.log o php-error.log. Suele haber uno en la raíz de tu dominio.
3. Descarga el archivo y ábrelo con un editor de texto. Busca las últimas líneas que coincidan con la hora en que se produjo el error. Verás la ruta exacta del archivo PHP que falla y el motivo.

En Syspanel:

1. En el menú lateral, busca la sección "Logs" o "Registros".
2. Puedes ver los logs del servidor web y de PHP en tiempo real o descargarlos.
3. Filtra por fecha y hora para encontrar el error exacto.

Con la información de los logs, puedes saber qué módulo o archivo está causando el problema y buscar una solución específica.

Paso 4: Soluciones Específicas para Módulos y Temas

Si el error 500 aparece después de instalar o actualizar un módulo o un tema, la causa es casi con seguridad ese componente.

4.1. Desactivar o eliminar el módulo problemático

No puedes entrar al Back Office, así que tendrás que hacerlo "a mano" desde el servidor.

Cómo solucionarlo:

1. Accede a la carpeta de tu PrestaShop.
2. Navega a la carpeta modules.
3. Busca la carpeta del módulo que crees que está causando el problema. El nombre de la carpeta suele ser el nombre técnico del módulo (ej. blockcart, ps_googleanalytics, etc.).
4. Renombra la carpeta del módulo, por ejemplo, añadiendo un _old al final (ej. blockcart_old). Esto hace que PrestaShop no lo encuentre y lo desactive automáticamente.
5. Recarga tu tienda. Si el error desaparece, has encontrado al culpable.

4.2. Cambiar al Tema por Defecto

Si el problema viene del tema, puedes forzar el uso del tema por defecto.

Cómo solucionarlo:

1. Accede a la carpeta themes.
2. Verás una carpeta con el nombre de tu tema (ej. classic, warehouse, etc.).
3. Renombra la carpeta de tu tema actual (ej. mi-tema_old).
4. Si existe una carpeta llamada classic (el tema por defecto de PrestaShop), úsala. Si no, tendrás que crear una copia de un tema base. A menudo, renombrar la carpeta del tema actual hará que PrestaShop use el tema por defecto de la instalación.

Paso 5: Resumen y Prevención

Hemos cubierto los pasos más efectivos para solucionar el error 500 PrestaShop. Es un proceso de eliminación. Empieza por lo más fácil y ve subiendo la complejidad.

Resumen rápido:

1. Activa el modo depuración para ver el error real.
2. Regenera el .htaccess.
3. Corrige los permisos de archivos y carpetas.
4. Aumenta la memoria PHP.
5. Reinicia los servicios en DirectAdmin o Syspanel.
6. Revisa los logs del servidor para pistas concretas.
7. Desactiva módulos o temas renombrando sus carpetas.

[WARNING] Antes de hacer cualquier cambio, siempre es recomendable hacer una copia de seguridad de los archivos y la base de datos. Esto te permitirá volver atrás si algo sale mal.

Prevención:

• Mantén PrestaShop, los módulos y el tema actualizados.
• No instales módulos de fuentes no oficiales.
• Realiza copias de seguridad periódicas.
• Antes de instalar algo nuevo, hazlo en un entorno de pruebas si es posible.

Esperamos que esta guía te haya sido de gran ayuda. Recuerda que el error 500 PrestaShop es un problema común con solución. Con paciencia y siguiendo estos pasos, podrás volver a tener tu tienda online funcionando en poco tiempo. Si después de todo el proceso el error persiste, te recomendamos contactar con tu proveedor de hosting, ya que podría ser un problema de configuración del servidor a nivel más profundo, y ellos tendrán las herramientas para solucionarlo. ¡Mucha suerte!