Cómo solucionar error 500 en PrestaShop en cPanel

¡Hola! Soy tu técnico de soporte amigable. Entiendo que ver un error 500 en PrestaShop puede ser frustrante, especialmente si no sabes por dónde empezar. Pero no te preocupes, este es uno de los problemas más comunes en el hosting y, por suerte, tiene solución. En esta guía extensa y paso a paso, te explicaré qué significa este error, por qué aparece y, lo más importante, cómo solucionar el error 500 en PrestaShop cuando tu sitio está alojado en un hosting con cPanel (o incluso si usas Syspanel, antes conocido como HestiaCP).

Vamos a desglosarlo de forma sencilla, como si estuviéramos viendo la pantalla juntos. No necesitas ser un experto, solo seguir las instrucciones con calma.

¿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". Es una forma genérica que tiene el servidor de decir: "Algo salió mal, pero no puedo darte más detalles por seguridad". En PrestaShop, esto suele estar relacionado con problemas de configuración, archivos corruptos, límites de memoria o conflictos entre módulos.

Las causas más frecuentes en un hosting PrestaShop con cPanel son:

Problemas de permisos de archivos: Archivos con permisos incorrectos que impiden la lectura o escritura.
Errores en el archivo .htaccess: Reglas mal escritas o incompatibles.
Límites de memoria PHP: PrestaShop necesita un mínimo de memoria para funcionar.
Módulos o temas defectuosos: Una actualización reciente puede haber roto algo.
Archivos PHP corruptos: Subidas incompletas o modificaciones manuales mal hechas.
Versión de PHP incompatible: PrestaShop requiere una versión específica de PHP.

[INFO] El error 500 no borra tus datos. Es un problema de funcionamiento, no de pérdida de información. Respira hondo, que lo solucionaremos.

Preparación antes de empezar a solucionar el error 500

Antes de tocar nada, es importante que te prepares. Así evitarás empeorar el problema.

1. Accede a tu panel de control (cPanel o Syspanel)

Lo primero es entrar a tu panel de hosting. Si usas cPanel, normalmente accedes mediante tudominio.com/cpanel o la IP que te proporcionó tu proveedor. Si usas Syspanel (HestiaCP), recuerda que el puerto de acceso es el 2106, por ejemplo: tudominio.com:2106.

2. Activa los logs de error de PHP

Los logs son tus mejores amigos. Te dirán exactamente qué está fallando.

En cPanel: Ve a "Seleccionar versión de PHP" (o "MultiPHP Manager") y asegúrate de que la opción "display_errors" esté en "On" temporalmente. También puedes buscar "Error Log" en la sección de métricas.
En Syspanel: Ve a "Configuración de PHP" y activa "log_errors" y "display_errors". Los logs suelen estar en /var/log/apache2/error.log o en la carpeta de tu sitio.

[WARNING] No dejes los errores visibles para los usuarios en producción. Desactiva "display_errors" después de solucionar el problema.

3. Haz una copia de seguridad (por si acaso)

Antes de modificar archivos, descarga una copia de seguridad de tu sitio desde cPanel (opción "Backup") o desde Syspanel. Si algo sale mal, podrás restaurar todo.

Paso a paso: Solucionar error 500 en PrestaShop (hosting cPanel)

Voy a guiarte por los métodos más efectivos, ordenados del más sencillo al más avanzado. Prueba cada uno y verifica si el error desaparece.

1. Limpiar la caché de PrestaShop

A veces el error 500 es solo un problema de caché corrupta.

Accede a tu hosting por FTP (FileZilla, por ejemplo) o al administrador de archivos de cPanel.
Navega a la carpeta raíz de tu PrestaShop (normalmente public_html o www).
Busca la carpeta var/cache y dentro de ella, elimina todo su contenido (no la carpeta en sí, solo los archivos y subcarpetas).
También puedes eliminar la carpeta cache si existe en la raíz.

Después de esto, recarga tu web. Si el error persiste, sigue al siguiente paso.

2. Revisar y regenerar el archivo .htaccess

El archivo .htaccess es un archivo oculto que controla las reglas de URL y seguridad. Un error aquí puede causar el 500.

Conéctate por FTP o al administrador de archivos de cPanel.
Asegúrate de ver archivos ocultos (en cPanel, suele haber un botón "Mostrar archivos ocultos").
Renombra el archivo .htaccess a algo como .htaccess_old (esto lo desactiva temporalmente).
Recarga tu web. Si el error desaparece, el problema está en el .htaccess.
Para regenerarlo, ve al panel de administración de PrestaShop (si puedes acceder) a "Parámetros de la tienda > Tráfico y SEO > SEO y URLs" y guarda la configuración sin cambiar nada. Esto creará un nuevo .htaccess.

[TIP] Si no puedes acceder al panel de administración, puedes crear un .htaccess básico manualmente. Busca en Google "PrestaShop .htaccess default" y copia el contenido.

3. Verificar y corregir permisos de archivos

PrestaShop necesita permisos específicos para funcionar: las carpetas deben tener permisos 755 y los archivos 644.

En cPanel, usa el "Administrador de archivos" y selecciona todos los archivos y carpetas de tu sitio.
Haz clic derecho y elige "Cambiar permisos".
Marca las casillas adecuadas: para carpetas, 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para grupo y otros). Para archivos, 644 (lectura y escritura para propietario; solo lectura para grupo y otros).
También puedes hacerlo por FTP: selecciona todo y cambia los permisos en lote.

[WARNING] No pongas permisos 777, ya que es un riesgo de seguridad. Solo 755 y 644.

4. Aumentar el límite de memoria PHP

PrestaShop es exigente con la memoria. Si tu hosting tiene un límite bajo, puede dar error 500.

En cPanel: Ve a "Seleccionar versión de PHP" o "MultiPHP INI Editor".
Busca la opción memory_limit y cámbiala a 256M o 512M. También ajusta max_execution_time a 300 y upload_max_filesize a 64M.
En Syspanel: Ve a "Configuración de PHP" y modifica los mismos valores.
Guarda los cambios y reinicia el servicio web (en cPanel suele hacerse automáticamente, en Syspanel puedes reiniciar Apache desde la opción "Servicios").

5. Deshabilitar módulos y temas desde la base de datos

Si no puedes acceder al panel de administración, puedes desactivar módulos problemáticos directamente desde la base de datos.

En cPanel, busca "phpMyAdmin" y accede a la base de datos de tu PrestaShop.
Busca la tabla ps_module (el prefijo puede variar, por ejemplo ps_).
Ejecuta una consulta SQL para desactivar todos los módulos no esenciales: UPDATE ps_module SET active = 0 WHERE id_module > 1; (esto desactiva todos excepto el módulo de configuración básica).
También puedes cambiar el tema por defecto: en la tabla ps_configuration, busca PS_CATALOG_MODE y PS_THEME_NAME, y ajústalos a valores seguros (por ejemplo, tema "classic").

[INFO] Si no sabes SQL, mejor pide ayuda a tu proveedor de hosting. Un error aquí puede romper la base de datos.

6. Revisar la versión de PHP

PrestaShop 1.7 requiere PHP 7.1 o superior, y PrestaShop 8 necesita PHP 8.0+. Una versión incorrecta causa el error 500.

En cPanel: Ve a "Seleccionar versión de PHP" y elige la recomendada para tu versión de PrestaShop (por ejemplo, PHP 7.4 o 8.1).
En Syspanel: Ve a "Configuración de PHP" y cambia la versión desde el selector.

7. Verificar archivos de configuración de PrestaShop

Los archivos config/defines.inc.php y config/settings.inc.php (en versiones antiguas) pueden tener errores.

Abre config/defines.inc.php con un editor de texto (desde cPanel o FTP).
Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a true. Esto mostrará errores detallados en pantalla.
Recarga tu web. Verás un mensaje de error más específico (por ejemplo, "Class not found" o "Parse error"). Anota ese error para solucionarlo.
Después, vuelve a poner false para no mostrar errores a los usuarios.

8. Comprobar el espacio en disco

Un disco lleno puede provocar errores internos. En cPanel, ve a "Estadísticas" y revisa el uso del disco. Si está al 100%, libera espacio eliminando archivos temporales, logs o copias de seguridad antiguas.

9. Contactar al soporte de hosting

Si después de todos estos pasos el error 500 PrestaShop sigue apareciendo, es hora de pedir ayuda profesional. El problema podría estar en el servidor (por ejemplo, problemas con el módulo de PHP, restricciones de seguridad o configuraciones del firewall).

Proporciona a tu soporte los logs de error que activaste al principio. Ellos podrán ver el error exacto.
Si usas Syspanel (HestiaCP), recuerda mencionar que el puerto de acceso es el 2106 para que te guíen mejor.

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop

¿El error 500 borra mis productos o clientes?

No. El error 500 es solo un problema de ejecución. Tus datos en la base de datos están seguros. Una vez solucionado, todo vuelve a la normalidad.

¿Puedo evitar el error 500 en el futuro?

Sí, con buenas prácticas:

Mantén PrestaShop, módulos y temas actualizados.
Haz copias de seguridad periódicas.
No instales módulos de fuentes no confiables.
Aumenta los límites de PHP antes de que se vuelvan un problema.
Usa un hosting que cumpla con los requisitos de PrestaShop.

¿Qué hago si no puedo acceder ni al panel de administración ni al FTP?

Si tu hosting está caído, contacta a tu proveedor. Ellos pueden reiniciar servicios o darte acceso temporal de emergencia. Si es un problema de contraseña, usa la opción "Olvidé mi contraseña" en cPanel o Syspanel.

¿El error 500 puede ser por un ataque de hackers?

Es posible, pero no es lo más común. Si sospechas, revisa los logs en busca de accesos extraños y cambia todas las contraseñas. También puedes escanear tu sitio con herramientas de seguridad como las que ofrece tu hosting.

Conclusión: No te rindas, el error 500 tiene solución

Como has visto, solucionar error 500 en PrestaShop es cuestión de método y paciencia. Empieza siempre por lo más simple (caché, .htaccess, permisos) y ve subiendo en complejidad (PHP, base de datos, logs). Recuerda que los logs son tu mejor aliado: te dirán exactamente qué falla.

Si en algún momento te sientes abrumado, no dudes en pedir ayuda. Tu proveedor de hosting está para eso. Y si usas Syspanel (HestiaCP), ya sabes que el puerto de acceso es el 2106, así que menciónalo cuando solicites soporte.

Espero que esta guía te haya sido útil. ¡Ánimo, que tu tienda online volverá a funcionar en poco tiempo! Si tienes más dudas, aquí estoy para ayudarte.