Error 500 en PrestaShop cPanel: causas y soluciones

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí porque tu tienda PrestaShop muestra la temida pantalla blanca o un mensaje de Error 500 Internal Server Error, no te preocupes. Es uno de los problemas más comunes en servidores compartidos o VPS, y lo solucionaremos juntos paso a paso.

Este artículo está diseñado para que, incluso si no eres un experto en hosting, puedas identificar y solucionar error 500 PrestaShop en cPanel sin perder la calma. Vamos a revisar desde lo más básico hasta técnicas un poco más avanzadas, siempre con un lenguaje claro y sencillo.

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

El error 500 es un código de estado HTTP que indica que algo falló en el servidor, pero sin dar detalles específicos. En PrestaShop, suele deberse a:

Archivos .htaccess corruptos o mal configurados.
Problemas de permisos de archivos y carpetas.
Módulos o temas incompatibles tras una actualización.
Límites de memoria PHP excedidos.
Errores en el archivo de configuración config/defines.inc.php.
Problemas con la base de datos o con las versiones de PHP.

[INFO]: El error 500 no es un virus ni un hackeo directo. Es una señal de que el servidor no puede ejecutar correctamente el código de PrestaShop. No te asustes, tiene solución.

Paso 1: Lo primero que debes hacer (sin tocar nada técnico)

Antes de meternos en archivos y comandos, prueba esto:

Reinicia tu navegador y borra la caché. A veces el error es solo un fallo temporal.
Accede a tu panel de administración de PrestaShop (normalmente tudominio.com/adminXXXX). Si puedes entrar, el error está en la parte pública. Si no, el problema es más profundo.
Revisa si el error ocurre en todas las páginas o solo en una. Si es solo en una, puede ser un módulo o contenido específico.

Si no puedes acceder al admin, sigue los pasos siguientes.

Paso 2: Acceder a cPanel y activar el modo debug de PrestaShop

Para solucionar error 500 PrestaShop, necesitamos ver qué dice el error real. PrestaShop oculta los detalles por seguridad, pero podemos activar el modo debug.

¿Cómo activar el modo debug desde cPanel?

Entra a tu cPanel (normalmente tudominio.com/cpanel o tudominio.com:2083).
- Si usas Syspanel (antes conocido como HestiaCP), accede por tudominio.com:2106.
Ve a Administrador de archivos (File Manager).
Navega a la carpeta raíz de tu tienda (normalmente public_html o una subcarpeta).
Busca el archivo config/defines.inc.php. Ábrelo con el editor de texto.

Busca la línea que dice:

define('_PS_MODE_DEV_', false);

y cámbiala a:

define('_PS_MODE_DEV_', true);

Guarda los cambios y vuelve a cargar tu tienda. Ahora verás un mensaje de error detallado (por ejemplo: "Fatal error: Allowed memory size..."). Esa información es oro.

[WARNING]: No dejes el modo debug activado en un sitio en producción. Después de solucionar, vuelve a ponerlo en false.

Paso 3: Soluciones rápidas para errores comunes

3.1. Aumentar el límite de memoria PHP

Uno de los errores más frecuentes es por falta de memoria. Desde cPanel:

Ve a Seleccionar versión de PHP (o MultiPHP Manager).
Haz clic en Opciones (o Switch to PHP Options).
Busca memory_limit y cámbialo a 256M o 512M. También puedes aumentar max_execution_time a 300.
Guarda los cambios y prueba de nuevo.

[TIP]: Si tu hosting no permite cambiar estos valores, contacta a soporte. También puedes crear un archivo php.ini en la raíz con:
memory_limit = 256M
max_execution_time = 300

3.2. Regenerar el archivo .htaccess

Un .htaccess dañado es una causa común del error 500 PrestaShop cPanel. Para regenerarlo:

En el Administrador de archivos, renombra el archivo .htaccess (en la raíz) a .htaccess_old (esto lo desactiva).
Ve a tu back office de PrestaShop (si puedes acceder) y ve a Configuración de la tienda > Tráfico y SEO > URL amigables.
Sin cambiar nada, haz clic en Guardar. Esto regenerará el .htaccess automáticamente.
Si no puedes acceder al back office, crea un .htaccess nuevo desde cPanel con el siguiente contenido básico (ajusta la ruta a tu carpeta de PrestaShop):

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>

Guarda y prueba.

3.3. Restaurar permisos de archivos y carpetas

Los permisos incorrectos pueden provocar errores 500. Los valores seguros son:

Carpetas: 755
Archivos: 644
Configuración: 755 para config/, 644 para config/settings.inc.php

Desde cPanel, en el Administrador de archivos:

Selecciona toda la carpeta de tu tienda.
Haz clic en Permisos y marca 755 para directorios y 644 para archivos.
Si hay muchos archivos, puedes usar la función Cambiar permisos de forma recursiva.

[INFO]: No uses 777 en ningún archivo. Es un riesgo de seguridad.

Paso 4: Deshabilitar módulos problemáticos (sin acceso al admin)

A veces un módulo recién instalado o actualizado causa el error. Si no puedes entrar al back office, usa phpMyAdmin desde cPanel:

En cPanel, ve a phpMyAdmin.
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_module (el prefijo puede variar, por ejemplo ps_).
Haz clic en Examinar (Browse) para ver todos los módulos.
Identifica módulos sospechosos (recién instalados o de terceros). Anota su id_module.
Ve a la tabla ps_module_shop y elimina las filas con ese id_module.
También puedes desactivar todos los módulos no nativos ejecutando esta consulta SQL (ajusta el prefijo):
```
UPDATE ps_module SET active = 0 WHERE id_module > 1;
```
Esto desactivará todos excepto los esenciales. Luego puedes reactivarlos uno por uno desde el admin.

Paso 5: Verificar la versión de PHP y compatibilidad

PrestaShop 1.7 requiere PHP 7.1 o superior, pero no PHP 8.0+ en versiones antiguas. Desde cPanel:

Ve a Seleccionar versión de PHP.
Elige una versión compatible con tu PrestaShop (por ejemplo, 7.4 es muy estable).
Guarda y prueba.

[WARNING]: Cambiar de versión de PHP puede romper módulos antiguos. Siempre haz una copia de seguridad antes.

Paso 6: Revisar el log de errores del servidor

Si nada funciona, el log de errores de Apache te dará la pista definitiva. En cPanel:

Ve a Errores de Apache (o Raw Access Logs).
Busca la entrada más reciente con 500 o PHP Fatal error.
Copia el mensaje y búscalo en Google o compártelo con soporte.

Ejemplo de línea útil:

[Tue Jan 23 10:00:00 2025] [error] [client IP] PHP Fatal error:  Uncaught Error: Class 'Module' not found in /home/user/public_html/modules/mimodulo/mimodulo.php:10

Eso indica que un módulo específico está fallando.

Paso 7: Restaurar una copia de seguridad

Si después de todo el error persiste, restaura una copia de seguridad de cuando tu tienda funcionaba. Desde cPanel:

Ve a Copias de seguridad (Backup).
Descarga la copia más reciente de tu sitio web y base de datos.
Restaura los archivos y la base de datos.

[TIP]: Siempre ten copias de seguridad automáticas. Muchos hostings las ofrecen en cPanel.

Preguntas frecuentes (FAQ)

¿El error 500 puede deberse a un ataque?

No es lo más común, pero sí. Revisa si hay archivos extraños en modules/ o themes/. Un escaneo de seguridad desde cPanel (si tu hosting lo ofrece) ayuda.

¿Qué hago si no tengo acceso a cPanel?

Contacta a tu proveedor de hosting y pídeles que activen el modo debug o que revisen los logs. Sin acceso, las opciones son limitadas.

¿Puedo solucionar el error 500 desde el móvil?

Técnicamente sí, si tu hosting tiene una app móvil, pero es mucho más complicado. Usa un ordenador.

¿Cada cuánto debo limpiar la caché de PrestaShop?

Después de cada actualización o instalación de módulos. Desde el back office: Parámetros avanzados > Rendimiento > Limpiar caché.

Resumen final

Solucionar error 500 PrestaShop en cPanel es cuestión de paciencia y método. Sigue estos pasos en orden:

Activa el modo debug para ver el error real.
Aumenta la memoria PHP y verifica los permisos.
Regenera el .htaccess y desactiva módulos sospechosos.
Revisa la versión de PHP y los logs del servidor.
Si nada funciona, restaura una copia de seguridad.

[INFO]: Si después de todo el error sigue, es hora de contactar al soporte técnico de tu hosting. Diles el mensaje exacto del modo debug. Ellos tienen herramientas más avanzadas.

Espero que este artículo te haya sido de gran ayuda. Recuerda que la prevención es clave: mantén tu PrestaShop actualizado, haz copias de seguridad periódicas y no instales módulos de dudosa procedencia. ¡Tu tienda volverá a funcionar en poco tiempo!

Si te quedó alguna duda, déjala en los comentarios (si este artículo está en un blog) o consulta con tu hosting. ¡Mucho éxito con tu tienda online!