Arreglar error 500 en PrestaShop | Solución rápida

¿Qué significa el error 500 en PrestaShop?

El error 500 es uno de los más temidos por cualquier propietario de una tienda online. Cuando tu PrestaShop no carga y aparece un mensaje como "Internal Server Error" o una página en blanco, significa que el servidor ha encontrado un problema interno que le impide procesar la solicitud.

Lo primero que debes saber es que este error no indica que tu tienda esté rota para siempre. En la mayoría de los casos, es un problema de configuración, permisos o archivos corruptos que se puede solucionar siguiendo una serie de pasos lógicos. En este artículo te voy a guiar de forma clara y sencilla para que puedas resolverlo tanto si tu hosting usa Plesk como si usa cPanel.

¿Por qué aparece el error 500 en PrestaShop?

Antes de lanzarnos a solucionar el problema, es importante entender las causas más comunes. Esto te ayudará a identificar rápidamente por dónde empezar.

Causas más frecuentes

Permisos de archivos y carpetas incorrectos: PrestaShop necesita permisos específicos para leer y escribir archivos. Si se cambian por error, todo falla.
Archivo .htaccess corrupto o mal configurado: Este archivo controla las reglas de reescritura de URL. Si está dañado, la tienda no carga.
Límite de memoria PHP insuficiente: Si tu tienda crece y el límite de memoria es bajo, el servidor se satura y devuelve error 500.
Errores en el código de un módulo o plantilla: Un módulo mal actualizado o un tema incompatible pueden generar conflictos.
Versión de PHP incompatible: PrestaShop requiere una versión específica de PHP. Si tu hosting la cambia automáticamente, pueden aparecer errores.
Archivos corruptos o incompletos: Una subida de archivos por FTP interrumpida puede dejar la tienda en un estado inconsistente.
Espacio en disco agotado: Si el servidor no tiene espacio libre, no puede escribir archivos temporales y falla.

Paso 1: Activa el modo de depuración para ver el error real

El error 500 es genérico y no te dice exactamente qué falla. Por eso, lo primero que debes hacer es activar el modo de depuración de PrestaShop. Esto mostrará el error específico en pantalla.

Para PrestaShop 1.6 y 1.7

Accede a tu hosting por FTP o por el Administrador de archivos que ofrece Plesk o cPanel.
Busca la carpeta raíz de tu tienda (normalmente public_html o httpdocs).
Localiza el archivo llamado config/defines.inc.php.
Ábrelo con un editor de texto (puedes usar el bloc de notas o un editor avanzado).
Busca la línea que dice:
```
define('_PS_MODE_DEV_', false);
```
Cambia false por true.

Guarda el archivo y recarga tu tienda. Ahora verás un mensaje de error más detallado con la ruta del archivo problemático. Anota ese mensaje, te será muy útil en los siguientes pasos.

[WARNING] No dejes el modo depuración activado en una tienda en producción. Es un riesgo de seguridad. Desactívalo al terminar de solucionar el problema.

Paso 2: Revisa los permisos de archivos y carpetas

Los permisos incorrectos son la causa número uno del error 500 en PrestaShop. El sistema necesita que las carpetas tengan permisos específicos para que PHP pueda leer y escribir.

Permisos correctos para PrestaShop

Carpetas: 755
Archivos: 644
Carpeta config y cache: 755
Carpeta img y upload: 755
Archivos dentro de config: 644

Cómo cambiar permisos en cPanel

Entra en cPanel y busca la herramienta Administrador de archivos.
Navega hasta la carpeta raíz de tu tienda.
Selecciona todos los archivos y carpetas (Ctrl+A o Cmd+A).
Haz clic derecho y elige Cambiar permisos.
Marca las casillas para dar permisos 755 a carpetas y 644 a archivos.
Aplica los cambios.

[TIP] Si tienes muchos archivos, es más rápido usar un cliente FTP como FileZilla. Selecciona todo, clic derecho → Permisos de archivos → escribe 644 para archivos y 755 para carpetas, y marca Recurse into subdirectories.

Cómo cambiar permisos en Plesk

Accede a Plesk y ve a Administrador de archivos dentro de tu dominio.
Selecciona la carpeta raíz.
Usa el botón Cambiar permisos en la barra superior.
Aplica los valores 755 para carpetas y 644 para archivos.

Paso 3: Revisa el archivo .htaccess

El archivo .htaccess es fundamental para el correcto funcionamiento de PrestaShop. Si está dañado, tu tienda no cargará.

Regenerar el .htaccess desde el panel de administración

Si tienes acceso al panel de administración de PrestaShop (aunque la tienda no cargue, a veces el panel sí funciona):

Ve a Parámetros avanzados → Rendimiento.
Busca la sección Regenerar el archivo .htaccess.
Haz clic en el botón correspondiente.
Guarda los cambios.

Si no tienes acceso al panel

Entra por FTP o Administrador de archivos.
Renombra el archivo .htaccess a .htaccess_old (esto lo desactiva temporalmente).
Intenta cargar tu tienda.
Si carga, el problema era el .htaccess. Puedes intentar regenerarlo manualmente o contactar a tu soporte.

[WARNING] Si renombras el .htaccess, las URLs amigables dejarán de funcionar. Es una solución temporal para diagnosticar, no una solución definitiva.

Paso 4: Aumenta el límite de memoria PHP

PrestaShop necesita al menos 128 MB de memoria PHP para funcionar correctamente. Si tu tienda es grande o usas muchos módulos, es recomendable subirlo a 256 MB o incluso 512 MB.

Desde cPanel

Busca la herramienta Select PHP Version o MultiPHP INI Editor.
Selecciona tu dominio.
Busca el parámetro memory_limit y cámbialo a 256M o 512M.
Guarda los cambios.

Desde Plesk

Ve a Configuración de PHP dentro de tu dominio.
Busca la pestaña Opciones de PHP o Configuración avanzada.
Localiza memory_limit y cámbialo a 256M.
Aplica los cambios.

Si no tienes acceso a estas opciones

Puedes crear un archivo llamado php.ini en la raíz y añadir esta línea:

memory_limit = 256M

O modificar el archivo .htaccess añadiendo:

php_value memory_limit 256M

Paso 5: Verifica la versión de PHP

PrestaShop 1.7 requiere PHP 7.1 o superior (idealmente 7.4 u 8.0). PrestaShop 1.6 funciona mejor con PHP 5.6 o 7.0.

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

Busca Select PHP Version.
Elige la versión recomendada para tu PrestaShop.
Guarda y recarga tu tienda.

Cómo cambiar la versión de PHP en Plesk

Ve a Configuración de PHP en tu dominio.
En Versión de PHP, elige la recomendada.
Aplica los cambios.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso se realiza por el puerto 2106. Una vez dentro, busca la sección de Configuración de PHP para cambiar la versión.

Paso 6: Revisa los logs del servidor

Si los pasos anteriores no funcionan, es momento de mirar los registros de errores del servidor. Allí encontrarás el mensaje exacto que está generando el problema.

En cPanel

Ve a Métricas → Errores o Registros de errores.
Busca los errores más recientes que hagan referencia a tu dominio.
Anota los mensajes que mencionen rutas de archivos de PrestaShop.

En Plesk

Ve a Logs dentro de tu dominio.
Revisa el archivo de errores de PHP o del servidor web (Apache o Nginx).
Busca entradas con fecha y hora cercanas al momento en que aparece el error.

Paso 7: Desactiva módulos o temas problemáticos

Si el error apareció después de instalar un módulo o cambiar de tema, es muy probable que ese sea el culpable.

Cómo desactivar módulos desde el panel

Accede a tu panel de administración (si es posible).
Ve a Módulos → Gestor de módulos.
Ordena por módulos instalados recientemente.
Desactiva los que hayas instalado o actualizado recientemente.
Prueba a cargar tu tienda después de cada desactivación.

Si no tienes acceso al panel

Entra por FTP.
Renombra la carpeta del módulo sospechoso dentro de /modules. Por ejemplo, mimodulo → mimodulo_backup.
Recarga tu tienda.

Paso 8: Sube de nuevo los archivos de PrestaShop

Si todo lo demás falla, es posible que tengas archivos corruptos. Puedes descargar una copia limpia de PrestaShop desde su página oficial, subirla por FTP y reemplazar los archivos del núcleo.

Pasos recomendados

Descarga la misma versión de tu PrestaShop.
Descomprime el archivo en tu ordenador.
Sube por FTP solo las carpetas principales: classes, controllers, src, vendor, app (para 1.7).
No subas la carpeta config ni img para no sobrescribir tu configuración.

[WARNING] Haz una copia de seguridad completa antes de reemplazar archivos. Un error aquí puede empeorar la situación.

Paso 9: Comprueba el espacio en disco

Un disco lleno puede provocar errores 500. Verifica que tu hosting tenga espacio libre.

En cPanel: Métricas → Uso de disco.
En Plesk: Estadísticas en el panel principal.

Si está al 95% o más, elimina archivos temporales, logs antiguos o copias de seguridad que ya no necesites.

Preguntas frecuentes (FAQ)

¿El error 500 puede deberse a un ataque de hackers?

Sí, es posible. Si tu tienda fue comprometida, es probable que se hayan modificado archivos del núcleo. Revisa si hay archivos PHP extraños en la raíz o en modules que no reconozcas.

¿Cuánto tiempo se tarda en arreglar el error 500?

Depende de la causa. Si es un problema de permisos, puede resolverse en 10 minutos. Si es un módulo conflictivo, puede llevar una hora. Si hay que reinstalar archivos, puede tomar medio día.

¿Debo contactar a mi proveedor de hosting?

Si has intentado todo y el error persiste, contacta a tu soporte. Ellos tienen acceso a los logs del servidor y pueden identificar el problema más rápido. Menciona que ya has revisado permisos, .htaccess y versión de PHP.

¿Puedo prevenir el error 500 en el futuro?

Sí. Mantén PrestaShop actualizado, usa módulos de fuentes confiables, haz copias de seguridad periódicas y no cambies permisos sin necesidad.

Resumen final

El error 500 en PrestaShop es frustrante, pero casi siempre tiene solución. Sigue estos pasos en orden:

Activa el modo depuración para ver el error real.
Revisa los permisos de archivos y carpetas.
Regenera el .htaccess.
Aumenta el límite de memoria PHP.
Verifica la versión de PHP.
Consulta los logs del servidor.
Desactiva módulos o temas recientes.
Reemplaza archivos corruptos.
Comprueba el espacio en disco.

Con paciencia y método, tu tienda volverá a funcionar. Y recuerda: si tu hosting usa Syspanel (puerto 2106), no dudes en usar su administrador de archivos y configuraciones para aplicar estos cambios.

[TIP] Guarda este artículo en tus favoritos. Te será útil cada vez que aparezca un error 500, que es más común de lo que parece en PrestaShop.