Error 500 en PrestaShop con DirectAdmin: causas y soluciones

¡Hola! Si has llegado hasta aquí, seguramente te has encontrado con la temida pantalla en blanco o el mensaje "Error 500: Internal Server Error" en tu tienda PrestaShop alojada en un panel de control DirectAdmin. No te preocupes, es uno de los errores más comunes y, por suerte, casi siempre tiene solución.

En esta guía completa, paso a paso, te explicaré cómo solucionar el error 500 en PrestaShop con DirectAdmin. Vamos a ir desde lo más básico hasta técnicas un poco más avanzadas, pero siempre con un lenguaje claro y sencillo. No necesitas ser un experto en programación para seguir estos pasos.

¿Qué es el error 500 en PrestaShop y por qué aparece?

El error 500 es un código de estado HTTP que significa "Error interno del servidor". En términos simples, tu servidor (donde está alojada tu web) está teniendo un problema para ejecutar el código de PrestaShop, pero no te da más detalles.

Las causas más frecuentes en un entorno DirectAdmin suelen ser:

Archivos con permisos incorrectos (demasiado restrictivos o demasiado abiertos).
Un archivo .htaccess corrupto o mal configurado.
Problemas de memoria PHP (límite de memoria agotado).
Un módulo o tema defectuoso que rompe la tienda.
Errores en el archivo config/defines.inc.php (especialmente si has activado el modo debug incorrectamente).
Problemas con la versión de PHP (PrestaShop 1.6, 1.7 o 8 requieren versiones específicas).

[WARNING] Antes de empezar, haz una copia de seguridad completa de tu tienda (archivos y base de datos). Muchos de estos pasos modifican archivos. Si algo sale mal, podrás restaurar todo.

Paso 1: Lo primero, activar el modo debug de PrestaShop

El error 500 es genérico. Para saber exactamente qué está fallando, necesitamos que PrestaShop nos muestre el error real. Esto se hace activando el modo debug.

¿Cómo activar el modo debug en DirectAdmin?

Accede a tu panel DirectAdmin.
Ve a Administrador de Archivos (File Manager).
Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html o una subcarpeta como tienda).
Busca el archivo config/defines.inc.php. Haz clic derecho y selecciona Editar.
Dentro del archivo, busca la siguiente línea (normalmente está cerca de la línea 40 o 50):
```
define('_PS_MODE_DEV_', false);
```
Cámbiala a:
```
define('_PS_MODE_DEV_', true);
```
También te recomiendo añadir justo debajo estas dos líneas para ver más detalles:
```
define('_PS_MODE_DEV_', true);
define('_PS_DISPLAY_COMPRESSION_', false);
```
Guarda el archivo (Ctrl+S o Cmd+S).
Recarga tu tienda. Ahora, en lugar de la pantalla blanca, verás un mensaje de error PHP con más detalles, como el nombre del archivo y la línea exacta donde falla.

[TIP] Si después de hacer esto tu web sigue en blanco, revisa el log de errores del servidor. En DirectAdmin, puedes encontrarlo en: Gestión de Sitios Web > Registros de Errores (Error Logs). Busca errores recientes con la palabra "PHP Fatal error".

Paso 2: Solucionar el error 500 según el mensaje de debug

Una vez que tengas el mensaje de error real, podrás actuar con precisión. Aquí tienes las soluciones para los casos más comunes:

Caso A: Error de memoria ("Allowed memory size exhausted")

Si ves algo como Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate... significa que tu tienda necesita más memoria PHP.

Solución en DirectAdmin:

Ve a Gestión de Sitios Web > Configuración PHP (o PHP Selector).
Busca la opción memory_limit.
Aumenta el valor, por ejemplo, de 128M a 256M o 512M.
Guarda los cambios y recarga la tienda.

Si no encuentras la opción, puedes hacerlo manualmente creando o editando un archivo llamado php.ini en la raíz de tu web con este contenido:

memory_limit = 512M
max_execution_time = 180
max_input_vars = 5000

Caso B: Error en el archivo `.htaccess`

Un .htaccess corrupto es una causa muy común. Prueba lo siguiente:

Desde el Administrador de Archivos de DirectAdmin, ve a la raíz de tu tienda.
Busca el archivo .htaccess (puede estar oculto; activa la opción "Mostrar archivos ocultos").
Renómbralo a algo como .htaccess_old o simplemente bórralo (temporalmente).
Recarga tu tienda. Si el error desaparece, el problema está en el .htaccess.
Para regenerarlo correctamente, ve al Back Office de PrestaShop > Parámetros de la tienda > Tráfico y SEO > SEO y URLs y haz clic en Guardar (sin cambiar nada). Esto regenerará el archivo.

Caso C: Módulo o tema conflictivo

Si el error menciona un archivo dentro de modules/ o themes/, ese módulo o tema está causando el problema.

Solución:

Desde el Administrador de Archivos, renombra la carpeta del módulo sospechoso (por ejemplo, de mimodulo a mimodulo_old).
Recarga la tienda. Si funciona, ese módulo es el culpable. Desinstálalo desde el Back Office.
Si es un tema, cambia temporalmente a un tema por defecto (como el "classic") renombrando la carpeta del tema actual.

Caso D: Problemas con el archivo `settings.inc.php`

Este archivo contiene la configuración de la base de datos. Si está corrupto o tiene permisos incorrectos, dará error 500.

Ve a config/settings.inc.php (en PrestaShop 1.6) o app/config/parameters.php (en PrestaShop 1.7+).
Asegúrate de que los permisos del archivo sean 644 (lectura y escritura para el usuario, solo lectura para el grupo y otros).
Si el archivo está vacío o tiene datos extraños, restáuralo desde tu copia de seguridad.

Paso 3: Solucionar el error 500 sin mensaje de debug (pantalla en blanco total)

Si no consigues ver ningún error ni siquiera con el modo debug activado, prueba estas soluciones genéricas:

Solución 1: Restaurar permisos de archivos y carpetas

Los permisos incorrectos son una causa muy común en DirectAdmin.

Conéctate a tu servidor vía SSH (si no sabes, puedes usar la opción "Ejecutar comandos" en DirectAdmin, aunque es limitada). Si no tienes acceso SSH, salta al siguiente paso.
Ejecuta estos comandos desde la raíz de tu tienda (normalmente public_html):
```
# Para archivos (permisos 644)
find . -type f -exec chmod 644 {} \;

# Para carpetas (permisos 755)
find . -type d -exec chmod 755 {} \;
```
Si no tienes SSH, puedes usar el Administrador de Archivos de DirectAdmin: selecciona todos los archivos y carpetas, haz clic en Permisos y establece 755 para carpetas y 644 para archivos. Es un poco tedioso, pero funciona.

Solución 2: Forzar una versión de PHP compatible

PrestaShop 1.6 necesita PHP 5.6 o 7.0-7.2. PrestaShop 1.7 funciona mejor con PHP 7.1-7.4. PrestaShop 8 requiere PHP 7.4 o 8.0.

En DirectAdmin, ve a Gestión de Sitios Web > Configuración PHP y selecciona la versión adecuada. Si no aparece, contacta a tu proveedor de hosting.

Solución 3: Deshabilitar todos los módulos temporalmente

A veces un módulo rompe todo al cargar. Puedes deshabilitarlos todos desde la base de datos (es un poco más técnico, pero seguro).

Ve a phpMyAdmin en DirectAdmin (base de datos).
Selecciona la base de datos de tu tienda.
Busca la tabla ps_module (o tu_prefijo_module).
Haz clic en SQL y ejecuta esta consulta:
```
UPDATE ps_module SET active = 0 WHERE active = 1;
```
(Reemplaza ps_ por tu prefijo real de tablas).
Recarga tu tienda. Si funciona, ve al Back Office y activa los módulos uno por uno para encontrar el culpable.

Paso 4: ¿Y si nada funciona? Consejos finales

Si después de todos estos pasos el error 500 persiste, considera estas opciones:

Revisa los logs del servidor en DirectAdmin: Ve a Gestión de Sitios Web > Registros de Errores y busca errores recientes. A veces el error está en el servidor, no en PrestaShop (por ejemplo, un límite de inodos o de procesos).
Aumenta el límite de inodos: En DirectAdmin, ve a Configuración de Paquete (si eres administrador) o pídele a tu hosting que lo haga. Un límite bajo puede provocar errores 500.
Prueba con un hosting diferente: Si tu servidor es muy básico (por ejemplo, un plan compartido barato), puede no ser capaz de ejecutar PrestaShop correctamente. Considera migrar a un hosting especializado en PrestaShop.

[INFO] Recuerda que, si usas Syspanel (anteriormente conocido como HestiaCP), el proceso es muy similar. El puerto de acceso a Syspanel es el 2106, y las rutas de archivos suelen ser /home/usuario/web/dominio/public_html. Los pasos para activar el modo debug y modificar permisos son idénticos.

FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop y DirectAdmin

1. ¿El error 500 puede deberse a un plugin de caché?

Sí, totalmente. Si tienes un módulo de caché (como el de PrestaShop o alguno de terceros) y está mal configurado, puede generar un error 500. Limpia la caché desde el Back Office (si puedes acceder) o manualmente borrando la carpeta /var/cache desde el Administrador de Archivos.

2. ¿Qué hago si no puedo acceder ni al Back Office?

Si el error también afecta al panel de administración, tendrás que arreglarlo todo desde el Administrador de Archivos de DirectAdmin o mediante phpMyAdmin. Sigue los pasos de este artículo, especialmente los de deshabilitar módulos o renombrar el .htaccess.

3. ¿El error 500 puede ser culpa de mi hosting?

Sí. A veces el servidor tiene una configuración demasiado restrictiva (como un límite de memoria muy bajo o un max_execution_time muy corto). También puede ser un problema de recursos (CPU, RAM) si tu tienda recibe mucho tráfico. Revisa los logs del servidor en DirectAdmin para ver si hay errores de "resource limit".

4. ¿Puedo evitar el error 500 en el futuro?

Sí, con buenas prácticas:

Actualiza PrestaShop y todos tus módulos y temas regularmente.
Haz copias de seguridad antes de cualquier cambio importante.
No instales módulos de fuentes dudosas.
Mantén un archivo .htaccess limpio y evita añadir reglas complejas si no sabes lo que haces.

5. ¿Qué significa "500 Internal Server Error" en mi tienda PrestaShop?

Significa que el servidor encontró una condición inesperada que le impidió completar la solicitud. En la práctica, es un error genérico que puede deberse a cientos de causas, pero las más comunes en PrestaShop con DirectAdmin son las que hemos cubierto: permisos, .htaccess, memoria o módulos.

Conclusión

El error 500 en PrestaShop con DirectAdmin puede ser frustrante, pero con paciencia y siguiendo estos pasos, lo más probable es que puedas solucionarlo. Recuerda: activa el modo debug, mira el mensaje de error real, y actúa en consecuencia. Si no ves nada, prueba con las soluciones genéricas (permisos, .htaccess, módulos).

Y si todo falla, no dudes en contactar al soporte técnico de tu hosting. Ellos pueden revisar los logs del servidor a nivel raíz que tú no puedes ver.

¡Espero que esta guía te haya sido de gran ayuda! Si tienes alguna otra duda, déjala en los comentarios (si tu web lo permite) o busca en los foros de PrestaShop. ¡Buena suerte!