Error 500 en PrestaShop: causas y soluciones en cPanel y DirectAdmin

¡Hola! Soy tu técnico de soporte amigable y experto en Hosting. Hoy vamos a desentrañar uno de los errores más temidos por cualquier usuario de PrestaShop: el temido error 500. No te preocupes, es más común de lo que crees y, con esta guía paso a paso, lo solucionaremos juntos. Vamos a ver cómo arreglar el error 500 PrestaShop tanto si usas cPanel como DirectAdmin.

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

El error 500, también conocido como "Error interno del servidor", es una respuesta genérica que indica que algo salió mal en el servidor, pero no da detalles específicos. En PrestaShop, puede aparecer de repente al intentar acceder a tu tienda, al panel de administración o al instalar un módulo. Las causas más comunes incluyen:

Archivos .htaccess corruptos o mal configurados.
Permisos de archivos y carpetas incorrectos.
Problemas con módulos o temas recién instalados.
Límites de memoria PHP excedidos.
Conflictos con la versión de PHP o extensiones faltantes.
Errores en el archivo de configuración config/defines.inc.php.

No te asustes. Vamos a revisar cada una de estas causas y te enseñaré cómo solucionar error 500 PrestaShop de forma segura y sin perder datos.

Requisitos previos antes de empezar

Antes de lanzarnos a modificar archivos, asegúrate de tener:

Acceso a tu panel de hosting (cPanel, DirectAdmin o Syspanel). Si tu hosting usa Syspanel, recuerda que el puerto de acceso es el 2106.
Acceso FTP o al administrador de archivos del panel para poder editar y borrar archivos.
Una copia de seguridad reciente de tu tienda. Siempre es mejor prevenir. Si no la tienes, haz una ahora desde el panel de hosting (suele estar en la sección de "Backups" o "Copias de seguridad").

[WARNING] No modifiques archivos sin tener una copia de seguridad. Un error podría dejar tu tienda inaccesible.

Paso 1: Identificar el error exacto (logs del servidor)

El error 500 es muy genérico, así que lo primero es obtener más detalles. Para ello, debemos revisar los logs de error del servidor.

En cPanel

Inicia sesión en cPanel.
Busca la sección "Registros" o "Logs".
Haz clic en "Error Log" o "Registro de errores".
Busca las últimas líneas que contengan "error 500" o "PHP Fatal error". Anota el mensaje o la ruta del archivo que aparece.

En DirectAdmin

Inicia sesión en DirectAdmin.
Ve a "Advanced Tools" > "Error Log Viewer".
Filtra por tu dominio y busca errores recientes.

En Syspanel

Inicia sesión en Syspanel (puerto 2106).
Ve a "Logs" > "Error Log".
Busca el mismo patrón.

Los logs te darán pistas clave, como "Allowed memory size exhausted" (falta de memoria) o "require(): Failed opening required" (archivo faltante). Anota cualquier pista.

Paso 2: Solución rápida: renombrar el archivo .htaccess

El archivo .htaccess de PrestaShop suele ser el culpable número uno. Vamos a desactivarlo temporalmente.

Accede a tu tienda por FTP o al Administrador de Archivos de tu panel.
Busca en la raíz de tu instalación de PrestaShop (donde están las carpetas admin, config, img, etc.) el archivo .htaccess.
Renómbralo a .htaccess_old o simplemente bórralo (pero renombrarlo es más seguro).
Ahora intenta acceder a tu tienda. Si el error 500 desaparece, el problema era el .htaccess.

[INFO] Si renombras el archivo, PrestaShop generará uno nuevo automáticamente la próxima vez que guardes la configuración de URL amigables desde el panel de administración.

Si el error persiste, continúa con el siguiente paso.

Paso 3: Verificar permisos de archivos y carpetas

Los permisos incorrectos son otra causa frecuente del error 500 PrestaShop. Los valores correctos son:

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)

Cómo cambiarlos en cPanel

Ve a "Archivos" > "Administrador de archivos".
Selecciona la carpeta raíz de tu tienda.
Marca todos los archivos y carpetas (Ctrl+A).
Haz clic en "Permisos" en la barra superior.
Cambia a 755 para carpetas y 644 para archivos. Si tienes muchos archivos, esto puede tardar un poco.

Cómo cambiarlos en DirectAdmin

Ve a "File Manager".
Selecciona la carpeta raíz.
Marca todo y haz clic en "Change Permissions".
Aplica los valores mencionados.

En Syspanel

Ve a "File Manager".
Selecciona la carpeta raíz y haz clic en "Permissions".
Cambia los permisos de forma masiva.

[TIP] Si usas FTP, la mayoría de los clientes (como FileZilla) permiten cambiar permisos en lote: selecciona todo, haz clic derecho y ve a "File Permissions".

Paso 4: Aumentar el límite de memoria PHP

Si en los logs viste "Allowed memory size of X bytes exhausted", necesitas aumentar la memoria PHP.

Opción 1: Desde cPanel (MultiPHP INI Editor)

Ve a "Software" > "MultiPHP INI Editor".
Selecciona tu dominio.
Busca la línea memory_limit y cámbiala a 256M o 512M.
Haz clic en "Apply".

Opción 2: Desde DirectAdmin (PHP Settings)

Ve a "Account Manager" > "PHP Settings".
Busca memory_limit y ajústalo.

Opción 3: Editando el archivo php.ini

Si no tienes acceso desde el panel, puedes crear o editar un archivo php.ini en la raíz de tu tienda con el siguiente contenido:

memory_limit = 256M
max_execution_time = 180
max_input_time = 180

Guarda el archivo y comprueba si el error desaparece.

Paso 5: Desactivar módulos y temas problemáticos

A veces un módulo o tema recién instalado causa el error 500. Para probar esto sin acceso al panel de administración, podemos renombrar la carpeta de módulos.

Accede por FTP o Administrador de archivos.
Ve a la carpeta modules dentro de tu instalación de PrestaShop.
Renombra la carpeta modules a modules_old.
Crea una nueva carpeta vacía llamada modules.
Intenta acceder a tu tienda. Si funciona, el problema es un módulo específico.

[WARNING] Al renombrar la carpeta modules, PrestaShop no cargará ningún módulo. Esto es solo para diagnóstico. Luego deberás restaurar la carpeta original e ir probando módulos uno por uno (renombrándolos dentro de la carpeta original) hasta encontrar el culpable.

Si el error persiste, prueba con el tema:

Ve a la carpeta themes.
Renombra la carpeta de tu tema activo (por ejemplo, classic a classic_old).
PrestaShop usará el tema por defecto si existe. Si no, puede que debas subir un tema básico temporalmente.

Paso 6: Verificar la versión de PHP y extensiones

PrestaShop requiere una versión de PHP específica (generalmente 7.4 o 8.0, según la versión). Además, necesita extensiones como mysqli, gd, curl, mbstring, etc.

En cPanel

Ve a "Software" > "Select PHP Version".
Elige una versión compatible con tu PrestaShop (consulta la documentación oficial).
Marca las extensiones necesarias (al menos las que te mencioné).

En DirectAdmin

Ve a "Account Manager" > "PHP Version Selector".
Cambia la versión y las extensiones.

En Syspanel

Ve a "PHP Settings" y selecciona la versión deseada.

[INFO] Si cambias la versión de PHP, puede que algunos módulos dejen de funcionar. Siempre es recomendable probar en un entorno de pruebas antes.

Paso 7: Revisar el archivo config/defines.inc.php

Este archivo contiene configuraciones importantes. A veces, al activar el modo de depuración, se puede generar un error 500 si hay un fallo de sintaxis.

Abre el archivo config/defines.inc.php con un editor de texto.
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a define('_PS_MODE_DEV_', true); para activar el modo de desarrollo. Esto mostrará errores más detallados en pantalla.
Guarda el archivo y recarga la tienda. Ahora verás el error específico (por ejemplo, "Class not found" o "Parse error").
Una vez resuelto, vuelve a poner false para desactivar el modo de desarrollo.

[WARNING] No dejes el modo de desarrollo activo en una tienda en producción, ya que muestra información sensible.

Paso 8: Comprobar la base de datos

Un error en la base de datos también puede causar un error 500, aunque es menos común. Puedes repararla desde cPanel o DirectAdmin.

En cPanel

Ve a "Bases de datos" > "phpMyAdmin".
Selecciona la base de datos de tu tienda.
Marca todas las tablas y en el menú desplegable elige "Reparar tabla".

En DirectAdmin

Ve a "MySQL Management" > "phpMyAdmin".
Realiza el mismo proceso.

Paso 9: Contactar con el soporte técnico de hosting

Si después de todos estos pasos el error 500 PrestaShop persiste, es momento de pedir ayuda profesional. El problema podría estar en la configuración del servidor, como un módulo de Apache deshabilitado o un problema de recursos.

Proporciona a tu proveedor de hosting la siguiente información:

Los logs de error que encontraste.
Los pasos que ya realizaste.
La versión de PrestaShop y PHP que usas.

Preguntas frecuentes (FAQ)

¿El error 500 puede dañar mi base de datos?

Generalmente no. El error 500 es un error del servidor que impide que la página se cargue, pero no modifica ni borra datos de la base de datos. Sin embargo, si el error se debe a un módulo que escribe en la base de datos, podría haber inconsistencias. Siempre ten un backup.

¿Puedo solucionar el error 500 sin acceso al panel de administración?

Sí, como hemos visto, puedes usar FTP o el Administrador de archivos del panel de hosting para modificar archivos, renombrar carpetas y cambiar permisos. También puedes editar el archivo config/defines.inc.php vía FTP.

¿Qué hago si después de renombrar el .htaccess el error sigue?

Prueba los otros pasos: permisos, memoria PHP, módulos, etc. Si nada funciona, revisa los logs del servidor con más detalle. A veces el error está en un archivo de idioma o en una plantilla.

¿El error 500 afecta a todos los visitantes?

Sí, cuando el error 500 está activo, cualquier persona que intente acceder a tu tienda verá la misma pantalla de error. Por eso es importante solucionarlo rápidamente.

¿Puedo evitar el error 500 en el futuro?

Sí, siguiendo buenas prácticas:

Mantén PrestaShop y todos los módulos actualizados.
Haz copias de seguridad periódicas.
Prueba módulos y temas en un entorno de desarrollo antes de instalarlos en producción.
No modifiques archivos del core sin saber lo que haces.
Monitorea los logs de error regularmente.

Conclusión

El error 500 PrestaShop puede parecer aterrador, pero con esta guía tienes todas las herramientas para solucionar error 500 PrestaShop tanto en cPanel como en DirectAdmin (y también en Syspanel). Recuerda siempre empezar por lo más simple (renombrar .htaccess) y luego ir subiendo en complejidad.

Si te has quedado atascado en algún paso, no dudes en consultar los logs o pedir ayuda a tu hosting. Y recuerda: la paciencia es clave. ¡Tu tienda volverá a funcionar en poco tiempo!

[TIP] Si usas Syspanel, recuerda que el puerto de acceso es el 2106. Allí también puedes hacer todas las gestiones que hemos visto.

Espero que esta guía te haya sido de gran ayuda. ¡Nos vemos en el próximo artículo!