Error 500 en PrestaShop con DirectAdmin: Causas y soluciones

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

El error 500 en PrestaShop DirectAdmin es uno de los problemas más comunes y, a la vez, más frustrantes para cualquier tienda online. Cuando aparece, verás una pantalla en blanco o un mensaje genérico que dice "Error interno del servidor". Este código de estado HTTP significa que algo salió mal en el servidor, pero no te dice exactamente qué es.

En la mayoría de los casos, el error 500 en PrestaShop está relacionado con problemas de permisos de archivos, errores en el archivo .htaccess, falta de memoria PHP, o conflictos con módulos o temas. La buena noticia es que, en la gran mayoría de las ocasiones, puedes solucionarlo siguiendo una serie de pasos lógicos y sencillos.

A lo largo de esta guía rápida, te explicaré cómo diagnosticar y arreglar error 500 PrestaShop alojado en un servidor con DirectAdmin. No necesitas ser un experto técnico, solo seguir las instrucciones con calma y en orden.

Paso 1: Identifica si el problema es general o solo en algunas páginas

Antes de tocar nada, es importante que sepas si el error afecta a toda tu tienda o solo a determinadas secciones.

Si el error aparece en todas las páginas, el problema suele ser global: archivos corruptos, permisos mal configurados o un conflicto serio con el servidor.
Si el error solo aparece en páginas específicas (por ejemplo, al ir al carrito o a la ficha de un producto), es muy probable que el problema esté relacionado con un módulo o con un archivo de plantilla concreto.

Esta primera observación te ahorrará mucho tiempo, ya que te permitirá centrar tus esfuerzos en la causa más probable.

Paso 2: Revisa el registro de errores del servidor

El registro de errores es tu mejor aliado. En DirectAdmin, puedes acceder a los logs de error desde el panel de control.

Cómo acceder a los logs en DirectAdmin

Inicia sesión en tu panel de DirectAdmin.
Busca la sección "Logs" o "Registros" (normalmente en el menú principal).
Haz clic en "Error Log" o "Registro de errores".
Busca las entradas más recientes que coincidan con la hora en la que empezó el error.

Los mensajes de error suelen ser técnicos, pero te darán pistas clave. Por ejemplo:

Si ves "PHP Fatal error: Allowed memory size of X bytes exhausted", el problema es falta de memoria.
Si ves "File not found" o "Permission denied", el problema está en los permisos de archivos.
Si ves "Invalid command" o "RewriteRule", el problema está en el archivo .htaccess.

[WARNING] Si no encuentras el log de errores, puedes activar la visualización de errores temporalmente desde el archivo de configuración de PHP. Te lo explico más adelante.

Paso 3: Solución rápida para el error 500 en PrestaShop: regenerar el .htaccess

El archivo .htaccess es uno de los principales sospechosos cuando aparece el DirectAdmin error 500 PrestaShop. Este archivo contiene reglas de reescritura de URL y configuración del servidor. Si se corrompe, se modifica incorrectamente o tiene permisos inadecuados, el servidor no sabrá cómo procesar las solicitudes.

Cómo regenerar el .htaccess de PrestaShop

Accede a tu hosting mediante FTP o al administrador de archivos de DirectAdmin.
Busca la carpeta raíz de tu PrestaShop (normalmente public_html).
Localiza el archivo .htaccess. Si no lo ves, activa la opción de "mostrar archivos ocultos" en tu cliente FTP.
Descarga una copia de seguridad de este archivo a tu ordenador (por si acaso).
Elimina el archivo .htaccess del servidor.
Ve a tu panel de administración de PrestaShop: https://tudominio.com/admin123/.
Si PrestaShop sigue funcionando, ve a Parámetros avanzados > Rendimiento.
Haz clic en "Regenerar el archivo .htaccess" (en algunos temas está en la parte inferior).
Guarda los cambios.

Si no puedes acceder al panel de administración, prueba a crear un archivo .htaccess nuevo y vacío con permisos 644. A veces, con esto es suficiente para que PrestaShop lo regenere automáticamente.

[TIP] El archivo .htaccess debe tener permisos 644 (lectura y escritura para el propietario, solo lectura para el grupo y el resto). Si tiene permisos 666 o 777, es muy probable que sea la causa del error 500.

Paso 4: Comprueba los permisos de archivos y carpetas

Los permisos incorrectos son otra causa muy común del error 500 PrestaShop DirectAdmin. PrestaShop necesita permisos específicos para funcionar correctamente.

Permisos correctos para PrestaShop

Carpetas (directorios): deben tener permisos 755.
Archivos: deben tener permisos 644.
Carpetas especiales como config, cache, log, img, mails, modules, themes, translations, var y upload: deben tener permisos 755.
Archivos especiales como settings.inc.php (en la carpeta config): debe tener permisos 644 (aunque en algunos casos se recomienda 444, pero eso puede causar problemas al guardar configuración).

Cómo cambiar permisos desde DirectAdmin

Entra en el Administrador de archivos de DirectAdmin.
Navega hasta la raíz de tu PrestaShop.
Selecciona todos los archivos y carpetas.
Haz clic en "Cambiar permisos".
Introduce los valores correctos: 755 para carpetas y 644 para archivos.

[WARNING] No es recomendable usar permisos 777 en ningún archivo de producción, ya que supone un grave riesgo de seguridad. Si alguien te ha recomendado usar 777 para solucionar el error, es mejor que busques la causa real.

Paso 5: Aumenta el límite de memoria PHP

Muchos errores 500 en PrestaShop ocurren porque el script agota la memoria asignada por PHP. Esto es especialmente común si tienes muchos módulos activos o si tu catálogo de productos es muy grande.

Cómo aumentar el límite de memoria en DirectAdmin

Accede a tu panel de DirectAdmin.
Busca la sección "Configuración de PHP" o "PHP Settings" (puede variar según la versión de DirectAdmin).
Busca la variable memory_limit.
Cámbiala a un valor más alto, por ejemplo: 256M o 512M.
Guarda los cambios y reinicia el servicio PHP si es necesario.

Si no encuentras esta opción en tu panel, puedes crearla manualmente:

Accede por FTP a la raíz de tu PrestaShop.
Crea un archivo llamado php.ini (si no existe).
Añade la siguiente línea:

memory_limit = 256M

Guarda el archivo y sube al servidor.

[INFO] Si tu hosting usa PHP-FPM, también puedes modificar estos valores desde el archivo php.ini específico de tu dominio o desde el panel de DirectAdmin en la sección "PHP Version" o "PHP Extensions".

Paso 6: Desactiva temporalmente los módulos conflictivos

Si el error 500 apareció después de instalar o actualizar un módulo, es muy probable que ese módulo esté causando el conflicto. Para comprobarlo, puedes desactivar todos los módulos temporalmente.

Cómo desactivar módulos sin entrar al panel

A veces, el error impide que accedas al panel de administración. En ese caso, puedes desactivar los módulos manualmente:

Accede por FTP a la carpeta de tu PrestaShop.
Ve a la carpeta modules.
Renombra la carpeta del módulo sospechoso, por ejemplo, de ps_googleanalytics a ps_googleanalytics_BACKUP.
Intenta acceder de nuevo a tu tienda.

Si el error desaparece, ya sabes cuál es el módulo problemático. Puedes intentar actualizarlo, reinstalarlo o contactar con su desarrollador.

[TIP] Para desactivar todos los módulos de golpe, puedes renombrar la carpeta modules a modules_backup y crear una carpeta nueva vacía llamada modules. PrestaShop no tendrá módulos activos, pero la tienda debería cargar. Luego, ve restaurando módulos poco a poco hasta encontrar el culpable.

Paso 7: Cambia la versión de PHP

PrestaShop es sensible a las versiones de PHP. Si tu servidor usa una versión demasiado nueva o demasiado antigua, es posible que aparezca el error 500 en PrestaShop.

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

Accede a tu panel de DirectAdmin.
Busca la opción "PHP Version" o "Select PHP Version".
Elige una versión compatible con tu PrestaShop. Por ejemplo:
- PrestaShop 1.7: PHP 7.1 a 7.4 (PHP 8.0 puede funcionar, pero requiere ajustes).
- PrestaShop 8.0: PHP 7.2 a 8.0.
Guarda los cambios y prueba de nuevo.

[INFO] Si tu PrestaShop es muy antiguo (1.6 o anterior), te recomiendo usar PHP 5.6 o 7.0. Las versiones más nuevas de PHP eliminan funciones que estos PrestaShop usan, provocando errores fatales.

Paso 8: Verifica el archivo de configuración `settings.inc.php`

El archivo config/settings.inc.php contiene la configuración de conexión a la base de datos. Si este archivo está corrupto o tiene datos incorrectos, PrestaShop no podrá conectarse a la base de datos y lanzará un error 500.

Cómo revisar el archivo de configuración

Accede por FTP a tu PrestaShop.
Ve a la carpeta config.
Abre el archivo settings.inc.php con un editor de texto.
Verifica que los datos de conexión sean correctos:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASSWD_', 'tu_contraseña');

Si algo no cuadra, corrígelo.

[WARNING] Asegúrate de que el archivo settings.inc.php tenga permisos 644. Si tiene permisos 444, PrestaShop no podrá escribir en él y podría dar error al guardar configuración, aunque no suele provocar un error 500 directamente.

Paso 9: Activa el modo de depuración de PrestaShop

Si después de todos los pasos anteriores sigues sin saber cuál es la causa, activa el modo de depuración de PrestaShop. Esto te mostrará el error real en pantalla en lugar de la página en blanco genérica.

Cómo activar el modo de depuración

Accede por FTP a la raíz de tu PrestaShop.
Abre el archivo config/defines.inc.php.
Busca la línea que dice:

define('_PS_MODE_DEV_', false);

Cámbiala a:

define('_PS_MODE_DEV_', true);

Guarda el archivo y sube los cambios.

Ahora, cuando recargues tu tienda, verás un mensaje de error detallado que te indicará el archivo y la línea exacta donde se produce el problema. Una vez solucionado, recuerda volver a poner false para no mostrar información sensible a tus clientes.

[WARNING] Nunca dejes el modo depuración activado en producción. Expone rutas internas, nombres de archivos y posibles vulnerabilidades de seguridad.

Paso 10: Restaura una copia de seguridad reciente

Si has probado todo lo anterior y el error persiste, la solución más rápida y segura es restaurar una copia de seguridad de tu tienda. Si tienes una copia reciente (de antes de que apareciera el error), este paso te ahorrará mucho tiempo.

Cómo restaurar desde DirectAdmin

Accede a DirectAdmin.
Busca la sección "Backup" o "Copias de seguridad".
Selecciona la copia de seguridad que quieras restaurar.
Elige restaurar archivos y base de datos.
Confirma la restauración.

[INFO] Si no tienes una copia de seguridad reciente, contacta con tu proveedor de hosting. Muchos ofrecen copias de seguridad automáticas diarias o semanales y pueden ayudarte a restaurar una versión anterior.

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop con DirectAdmin

¿Por qué aparece el error 500 después de actualizar PrestaShop?

Es muy común que las actualizaciones de PrestaShop provoquen conflictos con módulos o temas antiguos. Los archivos de caché también pueden quedar obsoletos. Prueba a borrar la carpeta var/cache (o cache en versiones antiguas) y regenerar el .htaccess.

¿El error 500 puede estar causado por mi tema?

Sí, especialmente si el tema no es compatible con la versión de PrestaShop o con la versión de PHP que estás usando. Prueba a cambiar temporalmente a un tema predeterminado (como "classic" en PrestaShop 1.7) para descartar esta posibilidad.

¿Cuánto tiempo se tarda en solucionar este error?

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

¿Debo contactar con mi proveedor de hosting si no lo soluciono?

Sí, absolutamente. Si has seguido todos los pasos y el error persiste, es posible que el problema esté en la configuración del servidor (por ejemplo, un módulo de Apache desactivado o un límite de ejecución). Tu proveedor de hosting puede revisar los logs del servidor y ver si hay algo a nivel de infraestructura que esté causando el error.

Conclusión

El error 500 PrestaShop DirectAdmin puede parecer abrumador al principio, pero en la mayoría de los casos tiene una solución clara y accesible. Siguiendo esta guía rápida, podrás diagnosticar y resolver el problema sin necesidad de ser un experto en servidores.

Recuerda siempre trabajar con calma, hacer copias de seguridad antes de modificar archivos importantes y no cambiar varias cosas a la vez. Así podrás identificar exactamente qué ha solucionado el problema y evitarás crear nuevos conflictos.

Si después de todo el error persiste, no dudes en contactar con tu proveedor de hosting. Ellos tienen acceso a herramientas y logs que tú no puedes ver, y estarán encantados de ayudarte a arreglar error 500 PrestaShop de forma definitiva.

[TIP] Para evitar futuros sustos, te recomiendo configurar un sistema de copias de seguridad automáticas y mantener siempre tu PrestaShop, módulos y temas actualizados a las últimas versiones estables. Prevenir es siempre mejor que curar.