Error 500 en PrestaShop: Cómo solucionarlo en cPanel

¡Hola! ¿Te has encontrado con la temida pantalla blanca o el mensaje "Error 500 – Internal Server Error" en tu tienda PrestaShop? No te preocupes, es uno de los errores más comunes en entornos de hosting, especialmente cuando usas cPanel. Este error significa que algo salió mal en el servidor, pero no te dice exactamente qué. En esta guía, paso a paso y con un lenguaje muy sencillo, vamos a solucionarlo juntos. Recuerda que trabajaremos desde cPanel, la herramienta de administración de tu hosting.

[INFO] Un error 500 es un problema del lado del servidor. No es culpa de tu conexión a internet ni de tu navegador. La causa suele ser un archivo de configuración dañado, un módulo incompatible, un tema defectuoso o un límite de recursos superado.

¿Qué causa el error 500 en PrestaShop?

Antes de empezar a solucionar, es útil saber qué lo provoca. Las causas más frecuentes son:

Archivo .htaccess corrupto: Es el archivo de configuración del servidor web. Si se daña, PrestaShop no puede cargar.
Módulo o tema conflictivo: Una actualización reciente o una mala instalación puede romper la compatibilidad.
Permisos de archivos incorrectos: Si los archivos tienen permisos demasiado restrictivos o demasiado abiertos, el servidor no puede leerlos.
Límite de memoria PHP agotado: Si tu tienda recibe mucho tráfico o tiene muchos módulos, puede superar el límite de memoria permitido.
Archivos de caché corruptos: La caché de PrestaShop puede dañarse y generar conflictos.
Actualización fallida de PrestaShop, PHP o algún módulo.

Vamos a atacar cada una de estas causas de forma ordenada.

Paso 1: Accede a cPanel y activa el modo debug de PrestaShop

Lo primero es entrar a tu cPanel. Normalmente se accede desde tudominio.com/cpanel o tudominio.com:2083. Una vez dentro, necesitamos que PrestaShop nos muestre el error real, no solo el mensaje genérico.

1.1. Localiza el archivo de configuración

En cPanel, usa el Administrador de Archivos (File Manager). Ve a la carpeta donde está instalado PrestaShop (normalmente public_html o una subcarpeta como tienda).

1.2. Edita el archivo defines.inc.php

Busca el archivo /config/defines.inc.php. Haz clic derecho y elige Editar. Busca esta línea:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda los cambios. Ahora, al recargar tu tienda, verás un mensaje de error mucho más descriptivo, como "Fatal error: Allowed memory size of...". Eso nos dará la pista exacta.

[WARNING] No olvides volver a poner false cuando termines de solucionar el error. Dejar el modo debug activado en producción puede exponer información sensible.

Paso 2: Soluciones rápidas desde cPanel

Si el modo debug no te muestra nada claro o prefieres ir directo a las soluciones más comunes, prueba estas opciones.

2.1. Restaura el archivo .htaccess

El archivo .htaccess se regenera automáticamente. Lo eliminaremos para que PrestaShop cree uno nuevo.

En el Administrador de Archivos, ve a la raíz de tu instalación de PrestaShop.
Busca el archivo .htaccess. Ojo: puede estar oculto. Activa la opción "Mostrar archivos ocultos" (Show Hidden Files) en la parte superior del Administrador de Archivos.
Haz clic derecho sobre .htaccess y selecciona Renombrar. Ponle htaccess_old.txt o algo similar. No lo borres por si acaso.
Ahora, ve a tu tienda. Si el error desaparece, el problema era ese. Para regenerarlo, accede 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 recreará el .htaccess.

2.2. Aumenta el límite de memoria PHP

Si el error decía algo de "memory size", necesitas aumentar el límite. En cPanel, busca la sección Software y haz clic en Seleccionar versión de PHP (o MultiPHP Manager). Luego, haz clic en Opciones o Switch to PHP Options.

Busca la línea memory_limit. El valor predeterminado suele ser 128M o 256M. Cámbialo a 512M o incluso 1024M si tu hosting lo permite. Guarda los cambios.

[TIP] También puedes modificar esto creando un archivo php.ini en la raíz de tu tienda con el contenido: memory_limit = 512M.

2.3. Limpia la caché de PrestaShop manualmente

Los archivos de caché pueden estar corruptos. Bórralos manualmente.

En el Administrador de Archivos, navega a la carpeta /var/cache/ dentro de tu instalación de PrestaShop.
Dentro encontrarás subcarpetas como dev, prod, cachefs. Selecciona todos los archivos y carpetas dentro de /var/cache/ y elimínalos (puedes dejarlos vacíos). No borres la carpeta cache en sí, solo su contenido.
Vuelve a cargar tu tienda. La caché se regenerará automáticamente.

Paso 3: Desactiva módulos y temas conflictivos (sin acceso al back office)

Si el error es tan grave que no puedes ni entrar al panel de administración, hay que desactivar todo desde los archivos.

3.1. Renombra la carpeta de módulos

En el Administrador de Archivos, ve a la raíz de tu PrestaShop.
Localiza la carpeta /modules/. Haz clic derecho y renómbrala a modules_old.
Crea una nueva carpeta vacía llamada modules.
Recarga tu tienda. Si el error desaparece, el problema es un módulo. Ahora, para recuperar la funcionalidad básica, puedes ir moviendo módulos de la carpeta modules_old a la nueva carpeta modules de uno en uno, hasta encontrar el culpable.

3.2. Cambia al tema predeterminado

Busca la carpeta /themes/. Dentro verás una carpeta con el nombre de tu tema (ej. clásico, warehouse, etc.).
Renombra esa carpeta a tu-tema-old.
Si el tema predeterminado de PrestaShop (normalmente llamado classic o default-bootstrap) no está, deberás descargar uno limpio y subirlo. Pero lo más común es que ya esté.
Recarga la tienda. Si funciona, el problema es tu tema. Puedes instalar una copia limpia o contactar al desarrollador.

Paso 4: Verifica los permisos de archivos

Los permisos incorrectos son una causa frecuente de error 500.

En el Administrador de Archivos, selecciona toda la carpeta de tu tienda (por ejemplo, public_html).
Haz clic en Permisos (Permissions) en la barra superior.
Marca la opción Recursivo (Recursive) para aplicar a todas las subcarpetas y archivos.
Establece los permisos estándar:
- Carpetas (directorios): 755
- Archivos: 644
Haz clic en Aceptar.

[WARNING] No uses permisos 777 a menos que sea absolutamente necesario y solo temporalmente. Es un riesgo de seguridad.

Paso 5: Revisa los logs del servidor en cPanel

Si nada de lo anterior funciona, los logs del servidor son tu mejor amigo. Te dirán exactamente qué está fallando.

En cPanel, busca la sección Métricas o Logs y haz clic en Error Log (Registro de errores).
Verás una lista de errores recientes. Busca líneas que contengan prestashop, php, fatal error o el nombre de un módulo.
Copia el mensaje de error exacto. Por ejemplo: PHP Fatal error: Uncaught Error: Call to undefined method.... Ese mensaje es oro para buscar una solución específica en Google o en foros de PrestaShop.

Preguntas frecuentes (FAQ)

P: ¿Puedo solucionar el error 500 sin acceso a cPanel?
R: Es muy difícil. Necesitas al menos acceso FTP o al administrador de archivos de cPanel. Si no tienes cPanel, contacta a tu proveedor de hosting.

P: ¿Y si uso Syspanel (HestiaCP) en lugar de cPanel?
R: No hay problema. Si usas Syspanel (HestiaCP), el acceso es por el puerto 2106 (ejemplo: tudominio.com:2106). Dentro, los pasos son similares: busca el Administrador de Archivos, las opciones de PHP y los logs de errores. La lógica es la misma.

P: Después de todo, sigo viendo el error 500. ¿Qué hago?
R: Si has seguido todos los pasos y nada funciona, puede ser un problema del servidor en sí (PHP mal configurado, falta de extensiones, etc.). Contacta al soporte de tu hosting y proporciónales el mensaje de error exacto que viste en los logs o en el modo debug.

P: ¿El error 500 puede dañar mi tienda?
R: No, el error 500 no daña los datos de tu tienda (productos, clientes, pedidos). Solo impide que se muestre la página. Tus datos están seguros en la base de datos.

P: ¿Debo restaurar una copia de seguridad?
R: Si has hecho cambios recientes (instalar un módulo, actualizar, modificar un archivo) y el error apareció justo después, restaurar una copia de seguridad de antes del cambio es la solución más rápida y segura.

Resumen y consejo final

Solucionar un error 500 en PrestaShop desde cPanel puede parecer abrumador, pero siguiendo estos pasos ordenados lo resolverás en la mayoría de los casos:

Activa el modo debug para ver el error real.
Prueba las soluciones rápidas: regenera .htaccess, aumenta la memoria PHP y limpia la caché.
Desactiva módulos y temas renombrando carpetas.
Revisa los permisos de archivos.
Consulta los logs del servidor para obtener la pista definitiva.

Recuerda siempre trabajar con calma, hacer una copia de seguridad antes de modificar archivos importantes y, si te sientes perdido, no dudes en pedir ayuda a tu hosting o a un desarrollador. ¡Tu tienda volverá a funcionar!