Error 500 en PrestaShop | Cómo solucionarlo paso a paso

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

El error 500 prestashop, también conocido como "Error interno del servidor", es uno de los problemas más temidos por cualquier dueño de una tienda online. Pero no te preocupes: en la gran mayoría de los casos tiene una solución sencilla que puedes aplicar tú mismo, sin necesidad de ser un experto en programación.

Este error significa, en términos simples, que el servidor donde está alojada tu tienda ha encontrado un problema inesperado y no puede completar la petición que le has hecho (por ejemplo, cargar una página, procesar un pago o mostrar el catálogo). Lo frustrante es que, a diferencia de otros errores, no te dice exactamente qué ha fallado. Es como si tu coche se parara en medio de la carretera sin encender el testigo de "avería": sabes que algo pasa, pero no sabes qué.

Las causas más comunes suelen ser:

Archivos con permisos incorrectos.
Un módulo o plugin recién instalado que da problemas.
Falta de memoria PHP asignada.
Un archivo .htaccess corrupto o mal configurado.
Problemas con la caché de PrestaShop.
Cambios recientes en la configuración del hosting o del servidor.

A lo largo de esta guía básica, te iré mostrando cómo solucionar error 500 en tu PrestaShop paso a paso, desde las soluciones más sencillas hasta las más avanzadas. Vamos a ello.

[INFO] Antes de empezar, te recomiendo que hagas una copia de seguridad de tu tienda (archivos y base de datos). Si algo sale mal durante el proceso, podrás restaurar todo sin perder ventas ni configuraciones.

Paso 1: Activa el modo depuración (la clave para entender el error)

El error 500 es como una caja cerrada: no sabes qué hay dentro. Para abrirla, PrestaShop tiene un modo depuración que muestra los detalles técnicos del error. Es la primera y más importante acción que debes hacer.

¿Cómo activar el modo depuración?

Accede a tu servidor mediante FTP o el administrador de archivos de tu hosting. Busca el archivo llamado config/defines.inc.php dentro de la carpeta raíz de tu PrestaShop.

Abre el archivo con un editor de texto (como Bloc de Notas o Sublime Text) y busca esta línea:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda el archivo y sube los cambios al servidor. Ahora, recarga tu tienda: en lugar del error 500 genérico, verás un mensaje mucho más descriptivo, con la ruta del archivo y la línea exacta donde está el problema. Apunta esos datos, te serán muy útiles.

[WARNING] No olvides volver a poner false cuando termines de arreglar el error. Dejar el modo depuración activo en una tienda en producción es un riesgo de seguridad grave.

Paso 2: Comprueba los permisos de archivos y carpetas

Una de las causas más frecuentes del error 500 en PrestaShop son los permisos incorrectos en los archivos o carpetas. Si tu servidor no puede leer o escribir en ciertos directorios, la tienda falla.

¿Qué permisos deben tener?

Las carpetas deben tener permisos 755.
Los archivos deben tener permisos 644.

Puedes cambiarlos desde tu cliente FTP (por ejemplo, FileZilla) o desde el panel de control de tu hosting. Selecciona todos los archivos y carpetas de la raíz de PrestaShop y ajusta los permisos en bloque.

¿Y si no sé usar FTP?

Muchos paneles de control (cPanel, Plesk, Syspanel) incluyen un administrador de archivos gráfico. En Syspanel, que es el panel que usamos en nuestros servidores, el puerto de acceso es el 2106. Una vez dentro, busca la carpeta public_html (o similar), selecciona todo y cambia los permisos desde la opción "Permisos".

[TIP] Si después de cambiar los permisos el error persiste, es posible que el problema no esté aquí. Sigue con el siguiente paso.

Paso 3: Revisa el archivo .htaccess

El archivo .htaccess es un archivo de configuración oculto que controla el comportamiento del servidor. Si se corrompe, PrestaShop puede dar error 500.

Cómo arreglarlo

Conéctate por FTP o al administrador de archivos.
Busca el archivo .htaccess en la raíz de tu tienda.
Renómbralo a algo como .htaccess_bak (esto lo desactiva).
Ve al panel de administración de PrestaShop y entra en Parámetros avanzados > Rendimiento.
Pulsa el botón "Guardar" (aunque no cambies nada). Esto regenerará un .htaccess nuevo y limpio.

Si no puedes acceder al panel de administración, prueba a crear un archivo .htaccess vacío y súbelo a la raíz. Luego intenta entrar de nuevo.

[INFO] Si tu tienda usa URLs amigables (SEO), es posible que necesites regenerar el .htaccess desde el panel de administración para que las URLs sigan funcionando correctamente.

Paso 4: Aumenta el límite de memoria PHP

PrestaShop es una plataforma exigente. Si tu tienda tiene muchos productos, módulos o tráfico, es posible que se quede sin memoria PHP y dé error 500.

¿Cómo aumentar la memoria?

Busca el archivo php.ini en la raíz de tu hosting. Si no existe, créalo con el siguiente contenido:

memory_limit = 256M
max_execution_time = 300
max_input_vars = 5000

Guarda el archivo y sube los cambios. Recarga tu tienda.

Si no puedes crear un php.ini, otra opción es añadir estas líneas al archivo .htaccess:

php_value memory_limit 256M
php_value max_execution_time 300

[TIP] Algunos servidores no permiten modificar estos valores desde .htaccess. En ese caso, contacta con tu proveedor de hosting y pídeles que aumenten el límite de memoria PHP a 256M como mínimo.

Paso 5: Desactiva módulos problemáticos

Otra causa muy común del error 500 prestashop es un módulo que acaba de instalar o actualizar y que no es compatible con tu versión de PrestaShop.

Cómo identificar al culpable

Accede a tu panel de administración (si puedes).
Ve a Módulos > Módulos y Servicios.
Desactiva todos los módulos personalizados (los que no son de PrestaShop).
Recarga tu tienda. Si el error desaparece, ve activando los módulos uno a uno hasta encontrar el que falla.

¿Y si no puedo entrar al panel?

Si el error te impide acceder al back-office, tendrás que desactivar los módulos manualmente. Conéctate por FTP y renombra la carpeta modules a modules_old. Esto desactivará todos los módulos a la vez. Luego, ve renombrando las carpetas de tus módulos a la normal (modules) y prueba a entrar de nuevo.

[WARNING] Esta solución es temporal. Una vez que identifiques el módulo problemático, deberías actualizarlo o buscar una alternativa compatible.

Paso 6: Limpia la caché de PrestaShop

A veces, la caché guarda datos corruptos o desactualizados que provocan el error 500. Limpiarla es una de las soluciones más rápidas y efectivas.

Cómo limpiar la caché

Conéctate por FTP o administrador de archivos.
Elimina el contenido de las carpetas var/cache/dev y var/cache/prod (en PrestaShop 1.7+). En versiones antiguas, busca las carpetas cache y smarty/cache.
No borres las carpetas en sí, solo su contenido.
Recarga tu tienda.

[TIP] Si no ves estas carpetas, asegúrate de tener activada la opción "Mostrar archivos ocultos" en tu cliente FTP.

Paso 7: Verifica los logs del servidor

Si después de todos los pasos anteriores sigues sin arreglar prestashop, es hora de mirar los registros del servidor. Ahí encontrarás el error exacto.

Dónde buscar

En cPanel: busca "Error Logs" o "Registros de errores".
En Syspanel: entra en la sección de logs de tu dominio. Recuerda que el puerto de acceso es el 2106.
Por FTP: busca una carpeta llamada logs o archivos con extensión .log en la raíz.

Los logs suelen mostrar la línea exacta del archivo PHP que está fallando. Con esa información, podrás buscar soluciones específicas en foros o contactar con soporte técnico.

[INFO] Si no entiendes los logs, no pasa nada. Copia las últimas líneas del error y pégalas en Google: es probable que otros usuarios hayan tenido el mismo problema y exista una solución documentada.

Paso 8: Restaura una copia de seguridad

Si has llegado hasta aquí y nada funciona, la solución más rápida es restaurar una copia de seguridad reciente de tu tienda. Esto te devolverá a un estado anterior donde todo funcionaba correctamente.

Cómo hacerlo

Accede a tu panel de control (cPanel, Plesk, Syspanel...).
Busca la sección de "Copias de seguridad" o "Backups".
Restaura la copia más reciente anterior al inicio del error.

[WARNING] Ten en cuenta que perderás todos los cambios realizados desde la copia (pedidos, productos, configuraciones). Es una solución de emergencia, pero muy efectiva.

Preguntas frecuentes sobre el error 500 en PrestaShop

¿El error 500 afecta a mi posicionamiento SEO?

Sí, aunque sea temporal. Si Google intenta rastrear tu web y recibe un error 500, puede reducir la frecuencia de rastreo o incluso degradar tu posicionamiento si el error se prolonga en el tiempo. Por eso es importante solucionarlo cuanto antes.

¿Puedo prevenir el error 500 en el futuro?

En muchos casos, sí. Mantén PrestaShop actualizado, usa módulos de fuentes confiables, haz copias de seguridad periódicas y revisa los límites de memoria PHP de tu hosting.

¿Necesito conocimientos de programación para arreglarlo?

No necesariamente. Los pasos que te he mostrado son básicos y no requieren tocar código. Solo necesitas acceso FTP o al panel de control de tu hosting.

¿Cuánto tiempo se tarda en solucionar?

Depende de la causa. Los pasos del 1 al 6 suelen resolver el problema en menos de 30 minutos. Si tienes que restaurar una copia de seguridad, puede llevar algo más de tiempo.

Resumen final: tu checklist para solucionar el error 500

Para que no se te olvide nada, aquí tienes la lista completa de acciones que puedes seguir en orden:

Activa el modo depuración para ver el error exacto.
Revisa los permisos de archivos (carpetas 755, archivos 644).
Regenera el .htaccess.
Aumenta el límite de memoria PHP a 256M.
Desactiva módulos problemáticos (uno a uno).
Limpia la caché de PrestaShop.
Consulta los logs del servidor.
Restaura una copia de seguridad como último recurso.

Con estos pasos, serás capaz de solucionar error 500 en PrestaShop en la gran mayoría de los casos. Y recuerda: si te sientes abrumado, siempre puedes contactar con tu proveedor de hosting. En nuestro caso, desde Syspanel (puerto 2106) ofrecemos soporte técnico para ayudarte con este tipo de incidencias.

Espero que esta guía te haya sido útil. ¡Tu tienda volverá a estar operativa en nada!