Solucionar error 500 en PrestaShop en cPanel | Causas y arreglos

¡Hola! ¿Ves una pantalla en blanco o un mensaje de error 500 en tu tienda PrestaShop? No te preocupes, es uno de los errores más comunes y, por suerte, casi siempre tiene solución. Este error significa que algo salió mal en el servidor, pero no nos dice exactamente qué. En esta guía, te explicaré paso a paso cómo solucionar el error 500 en PrestaShop alojado en cPanel. Vamos a desglosarlo de forma sencilla, desde lo más básico hasta soluciones más técnicas, para que puedas recuperar tu tienda rápidamente.

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

El error 500, también conocido como "Error interno del servidor", es una respuesta genérica que da el servidor cuando no puede procesar tu solicitud. En PrestaShop, las causas más frecuentes son:

Archivos corruptos o modificados: Por ejemplo, el archivo .htaccess o settings.inc.php.
Problemas de permisos: Archivos o carpetas con permisos incorrectos.
Módulos incompatibles o mal configurados: Un módulo recién instalado puede romper la tienda.
PHP Memory Limit insuficiente: Si tu tienda tiene muchos productos o tráfico, puede necesitar más memoria.
Errores en la base de datos: Tablas dañadas o conexión fallida.

[INFO] No te asustes si ves el error 500. La mayoría de las veces se soluciona en pocos minutos siguiendo estos pasos.

Paso 1: Accede a los logs de errores (la llave maestra)

Antes de tocar nada, lo más inteligente es leer los logs de error del servidor. Allí verás la causa exacta del error 500 PrestaShop cPanel.

¿Cómo ver los logs en cPanel?

Inicia sesión en tu cPanel (normalmente es tudominio.com/cpanel o tudominio.com:2083).
Busca la sección "Métricas" o "Registros".
Haz clic en "Errores" o "Error Log" (a veces aparece como "Registro de errores").
Verás una lista de errores recientes. Busca líneas que contengan "PHP Fatal error" o "require_once". Copia el mensaje completo.

Ejemplo de un log útil:

[Sun Jan 14 10:00:00.123456 2025] [php:notice] [pid 12345] [client 192.168.1.1:54321] PHP Fatal error:  Uncaught Error: Class 'Module' not found in /home/usuario/public_html/config/config.inc.php:123

Este error te dice exactamente qué archivo y línea fallan. Si ves algo así, ya tienes pista.

[TIP] Si no ves logs, revisa que el registro de errores esté activado. En cPanel, ve a "Seleccionar versión de PHP" y asegúrate de que "display_errors" esté en "On" temporalmente.

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

El archivo .htaccess es uno de los principales culpables del error 500 en PrestaShop. A veces se corrompe o tiene reglas incorrectas.

¿Cómo hacerlo?

Desde cPanel, abre el Administrador de archivos (File Manager).
Ve a la carpeta public_html (o la raíz de tu tienda).
Busca el archivo llamado .htaccess. Si no lo ves, activa "Mostrar archivos ocultos" (en la esquina superior derecha).
Renómbralo a algo como .htaccess_backup o .htaccess_old. No lo borres, solo desactívalo.
Ahora, intenta cargar tu tienda. Si el error 500 desaparece, el problema estaba en ese archivo.

¿Qué sigue? Si funcionó, PrestaShop generará un nuevo .htaccess automáticamente al acceder al back office. Pero si no, puedes regenerarlo manualmente desde el panel de administración (Ajustes > SEO y URLs > Configurar URLs amigables > Guardar).

[WARNING] Si renombras .htaccess y tu tienda se ve sin CSS o con enlaces rotos, no te alarmes. Es normal porque las reglas de reescritura se perdieron. Al regenerarlo, todo volverá a la normalidad.

Paso 3: Verifica los permisos de archivos y carpetas

Los permisos incorrectos son otra causa común del error interno del servidor. En cPanel, los permisos ideales son:

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)
Archivos de configuración como settings.inc.php: 644 (nunca 777)

Pasos para corregir permisos en cPanel:

En el Administrador de archivos, selecciona toda la carpeta public_html.
Haz clic en "Permisos" en la barra superior.
Marca las opciones:
- 755 para directorios.
- 644 para archivos.
Marca la casilla "Recursivo" para aplicar a todas las subcarpetas.
Haz clic en "Cambiar permisos".

[INFO] Si tienes muchos archivos, este proceso puede tardar unos segundos. No cierres la ventana hasta que termine.

Paso 4: Aumenta el límite de memoria PHP (memory_limit)

Si tu tienda es grande o tienes muchos módulos, el error 500 puede deberse a falta de memoria. PrestaShop recomienda al menos 128 MB, pero 256 MB es ideal.

¿Cómo aumentarlo en cPanel?

Ve a "Seleccionar versión de PHP" (en la sección Software).
Haz clic en "Cambiar a opciones de PHP" o "Switch to PHP Options".
Busca la opción memory_limit y cámbiala a 256M o 512M.
Guarda los cambios y recarga la tienda.

Si no ves la opción, puedes hacerlo manualmente desde el archivo php.ini (si existe) o agregando una línea en el .htaccess que renombraste antes:

php_value memory_limit 256M

[TIP] No pongas un valor excesivo como 1024M a menos que sepas que tu servidor lo soporta. Con 256M suele ser suficiente.

Paso 5: Desactiva módulos problemáticos desde la base de datos

Si el error 500 apareció después de instalar o actualizar un módulo, es probable que ese módulo esté causando el problema. Si no puedes acceder al back office, desactívalo desde la base de datos.

Cómo hacerlo:

En cPanel, abre phpMyAdmin.
Selecciona la base de datos de tu tienda (la que uses en PrestaShop).
Busca la tabla ps_module (el prefijo ps_ puede variar si lo cambiaste).
Haz clic en "Examinar" (o "Browse").
Busca el módulo sospechoso por su nombre y haz clic en "Editar" (el lápiz).
Cambia el valor de active de 1 a 0.
Guarda y vuelve a cargar tu tienda.

[WARNING] Si no sabes qué módulo desactivar, desactiva todos los módulos no esenciales. Luego, desde el back office, los reactivas uno por uno para identificar el culpable.

Paso 6: Revisa el archivo settings.inc.php

Este archivo contiene la configuración de la base de datos y otras constantes. Si está dañado, tu tienda no funcionará.

¿Cómo verificarlo?

En el Administrador de archivos, navega a public_html/config/.
Busca el archivo settings.inc.php.
Ábrelo con el editor de texto.

Verifica que las líneas de conexión a la base de datos sean correctas:

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

Si ves caracteres extraños o está vacío, restaura una copia de seguridad o reemplázalo con el contenido original de una instalación limpia.

[INFO] Si no tienes copia de seguridad, puedes generar un nuevo archivo desde el instalador de PrestaShop, pero esto es más avanzado. Mejor contacta a soporte.

Paso 7: Verifica la versión de PHP

PrestaShop requiere una versión específica de PHP. Por ejemplo, PrestaShop 1.7 funciona con PHP 7.1 a 8.0, pero versiones más nuevas pueden causar errores.

¿Cómo cambiar la versión de PHP en cPanel?

Ve a "Seleccionar versión de PHP".
Elige una versión compatible con tu PrestaShop (por ejemplo, 7.4 o 8.0).
Guarda y prueba la tienda.

[TIP] Si usas módulos antiguos, prueba con PHP 7.4, ya que es la más estable para PrestaShop.

Paso 8: Limpia la caché de PrestaShop

A veces, la caché corrupta puede generar el error 500. Si no puedes acceder al back office, hazlo manualmente.

Pasos:

En el Administrador de archivos, ve a public_html/var/cache/ (o public_html/cache/ en versiones antiguas).
Elimina todo el contenido de la carpeta cache (no la carpeta en sí, solo los archivos internos).
También borra la carpeta public_html/var/cache/prod/ si existe.
Recarga la tienda.

[WARNING] No borres la carpeta cache vacía, solo su contenido. Si lo haces, créala de nuevo con permisos 755.

Paso 9: Restaura una copia de seguridad

Si nada funciona, la solución más segura es restaurar una copia de seguridad de tu tienda. En cPanel, puedes hacerlo desde "Copias de seguridad" (Backup).

¿Cómo?

En cPanel, ve a "Copias de seguridad".
Descarga una copia reciente de los archivos y la base de datos.
Restaura los archivos usando el "Restaurar un archivo de copia de seguridad".
Restaura la base de datos desde phpMyAdmin (importa el archivo SQL).

[INFO] Si no tienes copia, contacta a tu proveedor de hosting. Muchos hacen backups automáticos diarios.

FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop

¿El error 500 puede deberse a un ataque?

Sí, a veces un ataque de fuerza bruta o un archivo malicioso puede causarlo. Revisa los logs en busca de actividad sospechosa.

¿Cómo evito que vuelva a aparecer?

Mantén PrestaShop y los módulos actualizados.
No instales módulos de fuentes no confiables.
Haz copias de seguridad periódicas.
Usa un hosting con buen soporte técnico.

¿Puedo solucionarlo desde el móvil?

Sí, si tu cPanel tiene versión móvil o usas una app como "cPanel Mobile", puedes hacer cambios básicos, pero es más complejo.

¿Qué hago si no tengo acceso a cPanel?

Contacta a tu proveedor de hosting. Ellos pueden revisar los logs y restablecer archivos desde su lado.

[TIP] Si usas Syspanel (anteriormente HestiaCP), el acceso es por el puerto 2106 (ejemplo: tudominio.com:2106). Los pasos son similares, pero busca "Registro de errores" en el panel.

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

El error 500 en PrestaShop puede ser frustrante, pero siguiendo estos pasos en orden, lo más probable es que lo resuelvas. Empieza por lo más simple (renombrar .htaccess y revisar logs) y luego pasa a soluciones más avanzadas. Recuerda que siempre puedes contar con el soporte de tu hosting o con la comunidad de PrestaShop.

Si después de todo esto el error persiste, puede ser un problema de configuración del servidor (como mod_security o límites de recursos). En ese caso, contacta a tu proveedor de hosting y muéstrales los logs de error. ¡Ánimo, tu tienda volverá a funcionar!