Solucionar Error 500 en PrestaShop | Guía Paso a Paso para SysAdmins

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

El error 500 prestashop (también conocido como "Internal Server Error") es uno de los problemas más temidos por cualquier administrador de tiendas online. Este mensaje aparece cuando el servidor encuentra una condición inesperada que le impide completar la petición del navegador. En la práctica, significa que algo se ha roto en la configuración, los archivos o la base de datos de tu tienda.

Si estás leyendo esto, probablemente estás viendo una pantalla en blanco o un mensaje de error genérico en lugar de tu catálogo de productos. No te preocupes: en la mayoría de los casos, solucionar error 500 prestashop es un proceso que puedes hacer tú mismo siguiendo una serie de pasos lógicos, sin necesidad de ser un experto en programación.

Síntomas comunes del error 500 en PrestaShop

Antes de empezar a arreglar nada, es importante que identifiques qué tipo de error 500 estás viendo. Algunos síntomas típicos incluyen:

Página en blanco total (o "pantalla blanca de la muerte").
Mensaje "Internal Server Error" genérico del servidor.
Error al intentar acceder al panel de administración.
Algunas páginas funcionan y otras no.
El error aparece después de instalar un módulo o modificar un tema.

Cada síntoma puede apuntar a una causa diferente, así que vamos a ir paso a paso.

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

El primer paso para arreglar error 500 en PrestaShop es hacer que la plataforma te muestre el error real en lugar de la pantalla genérica. PrestaShop tiene un modo de depuración que puedes activar desde el archivo config/defines.inc.php.

Cómo activar el modo debug

Accede a tu servidor mediante FTP o el administrador de archivos de tu hosting.
Localiza la carpeta config en la raíz de tu instalación de PrestaShop.
Abre el archivo defines.inc.php con un editor de texto plano (no uses Word ni editores con formato).
Busca la línea que dice define('_PS_MODE_DEV_', false); y cambia false por true.
Guarda el archivo y sube los cambios al servidor.

[WARNING] Haz esto solo temporalmente. Cuando termines de solucionar el problema, vuelve a poner false para evitar que los errores sean visibles para los visitantes.

Una vez activado el modo debug, recarga la página que daba el error. Ahora deberías ver un mensaje mucho más descriptivo, con la ruta exacta del archivo que está causando el problema. Anota ese mensaje, te será muy útil en los siguientes pasos.

Paso 2: Verifica los permisos de archivos y carpetas

Una causa muy común de los problemas prestashop relacionados con el error 500 son los permisos incorrectos en archivos y carpetas. Si los permisos son demasiado restrictivos, el servidor no puede leer o escribir los archivos necesarios.

Permisos recomendados para PrestaShop

Carpetas: 755
Archivos estáticos: 644
Archivos de configuración: 644
Carpeta cache, log y upload: 755

Puedes cambiar los permisos desde tu cliente FTP (FileZilla, por ejemplo) o desde el panel de control de tu hosting. Si usas Syspanel (el panel de gestión que se accede por el puerto 2106), puedes usar el administrador de archivos integrado.

Comando SSH (si tienes acceso)

Si tienes acceso SSH, puedes ejecutar este comando desde la raíz de tu instalación:

find . -type f -exec chmod 644 {} \;
find . -type d -exec chmod 755 {} \;

[TIP] No todos los hosting permiten SSH. Si no es tu caso, usa el administrador de archivos de Syspanel o un cliente FTP.

Paso 3: Limpia la caché de PrestaShop

Otra causa frecuente del error 500 prestashop es una caché corrupta o desactualizada. PrestaShop guarda archivos temporales y compilados que, si se dañan, pueden provocar errores internos.

Cómo limpiar la caché manualmente

Conecta por FTP a tu servidor.
Ve a la carpeta var/cache (en versiones modernas) o cache (en versiones antiguas).
Borra todo el contenido de la carpeta cache (no la carpeta en sí, solo su contenido).
Si existe una subcarpeta llamada dev o prod, bórrala también.
Relanza tu tienda y comprueba si el error ha desaparecido.

En PrestaShop 1.7 y versiones posteriores, también puedes limpiar la caché desde el panel de administración, pero si no puedes acceder a él, este método manual es la alternativa.

Paso 4: Revisa el archivo .htaccess

El archivo .htaccess es un archivo de configuración que controla el comportamiento del servidor Apache. Un .htaccess corrupto o con reglas incorrectas puede provocar un prestashop error 500 al intentar acceder a cualquier página.

Regenerar el .htaccess

Accede a la raíz de tu instalación de PrestaShop por FTP.
Renombra el archivo .htaccess a .htaccess_old (por si acaso).
Intenta acceder a tu tienda. Si el error desaparece, el problema era el .htaccess.
Para regenerarlo correctamente, entra al panel de administración (si puedes) y ve a Parámetros avanzados > Rendimiento y activa/desactiva la opción "Usar el archivo .htaccess para las URL amigables" y guarda.
Si no puedes acceder al panel, puedes subir un .htaccess básico de PrestaShop (puedes obtener uno de una instalación limpia de la misma versión).

[WARNING] Si tu tienda usa nginx en lugar de Apache, el problema no será el .htaccess, sino la configuración de nginx. En ese caso, contacta con tu proveedor de hosting.

Paso 5: Comprueba los módulos y el tema activo

A veces, un módulo mal configurado o un tema incompatible puede lanzar un error fatal que se traduce en error 500 prestashop. Si recuerdas haber instalado algo recientemente, este es el primer sospechoso.

Desactivar módulos problemáticos

Accede a tu servidor por FTP.
Ve a la carpeta modules.
Localiza el módulo que sospechas que causa el problema.
Renombra la carpeta del módulo (por ejemplo, de mi_modulo a mi_modulo_backup).
Recarga tu tienda. Si el error desaparece, ya sabes cuál es el culpable.

Cambiar temporalmente de tema

Si el problema viene del tema, puedes cambiarlo temporalmente:

Ve a la carpeta themes en la raíz.
Renombra la carpeta de tu tema actual a algo como mi_tema_backup.
Sube un tema por defecto de PrestaShop (puedes descargarlo de la web oficial).
Comprueba si la tienda funciona.

Paso 6: Revisa los logs del servidor

Los logs del servidor son una mina de información para solucionar error 500 prestashop. Contienen el registro exacto de lo que estaba haciendo el servidor cuando se produjo el error.

Dónde encontrar los logs

En Syspanel (puerto 2106), busca la sección de "Registros" o "Logs" del sitio web.
En hosting compartidos, suele haber una carpeta logs en la raíz de tu cuenta.
Si tienes acceso SSH, puedes ejecutar: tail -f /var/log/apache2/error.log (adapta la ruta según tu sistema).

Busca las líneas que contengan "PHP Fatal error" o "mod_security". Estas te indicarán el archivo y la línea exacta donde se produce el fallo.

Paso 7: Aumenta el límite de memoria PHP

PrestaShop es una plataforma exigente, y a veces el error 500 aparece porque el script agota la memoria PHP disponible. Esto es especialmente común en tiendas con muchos productos, módulos pesados o temas complejos.

Cómo aumentar la memoria PHP

Localiza el archivo php.ini en tu servidor (puedes crearlo en la raíz si no existe).
Añade o modifica la línea: memory_limit = 256M (o incluso 512M si tu hosting lo permite).
Guarda y sube el archivo.
Si tu hosting usa Syspanel, puedes cambiarlo desde la sección de PHP en la configuración del sitio.

[INFO] Si no puedes modificar php.ini, intenta crear un archivo .user.ini en la raíz con el mismo contenido, o añade esta línea al .htaccess: php_value memory_limit 256M.

Paso 8: Verifica la base de datos

Un error en la base de datos también puede manifestarse como un error 500 prestashop. Esto puede ocurrir por una tabla corrupta, una columna eliminada por error o un fallo durante una actualización.

Comprobar la integridad de la base de datos

Accede a phpMyAdmin desde tu panel de control (Syspanel también lo incluye).
Selecciona la base de datos de tu tienda.
En la pestaña "Exportar", haz una copia de seguridad completa.
Ve a la pestaña "SQL" y ejecuta: CHECK TABLE ps_connections; (cambia ps_ por tu prefijo real de tablas).
Si aparecen errores, ejecuta REPAIR TABLE ps_connections; (o la tabla que falle).

También puedes optimizar todas las tablas de una vez desde la pestaña "Operaciones" de phpMyAdmin.

Paso 9: Revisa la versión de PHP y las extensiones

PrestaShop requiere una versión específica de PHP y ciertas extensiones para funcionar correctamente. Si tu hosting ha actualizado PHP recientemente, es posible que tu tienda deje de funcionar.

Versiones recomendadas

PrestaShop 1.6: PHP 5.6 a 7.1
PrestaShop 1.7: PHP 7.1 a 7.4
PrestaShop 8.x: PHP 7.2 a 8.1

Extensiones obligatorias

cURL
GD Library
PDO
JSON
OpenSSL

En Syspanel (puerto 2106), puedes cambiar la versión de PHP desde la configuración del sitio web en solo unos clics.

Paso 10: Restaura desde una copia de seguridad

Si has probado todos los pasos anteriores y el prestashop error 500 persiste, puede que sea más rápido restaurar desde una copia de seguridad reciente.

Cómo restaurar

Haz una copia de seguridad actual de tu base de datos y archivos (por si acaso).
Sube la copia de seguridad completa de archivos a la raíz de tu hosting.
Importa la base de datos desde phpMyAdmin (o desde Syspanel).
Borra la carpeta var/cache después de la restauración.
Comprueba que la tienda funciona.

[WARNING] La restauración perderá los cambios realizados desde la fecha de la copia. Asegúrate de que es tu última opción.

Preguntas frecuentes sobre el error 500 en PrestaShop

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

Sí, aunque es menos común. Si tu tienda ha sido comprometida, los atacantes suelen modificar archivos clave como config/settings.inc.php o index.php. Revisa estos archivos en busca de código extraño y considera cambiar las contraseñas de tu hosting y base de datos.

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

Depende de la causa. Los problemas de permisos o caché se resuelven en minutos. Los problemas de módulos o base de datos pueden llevar más tiempo. En cualquier caso, siguiendo los pasos de esta guía, la mayoría de los usuarios lo resuelven en menos de una hora.

¿Debo contactar con mi proveedor de hosting?

Si después de todos estos pasos el error persiste, sí. Es posible que haya un problema a nivel de servidor (configuración de Apache, límites de recursos, etc.) que solo tu proveedor puede solucionar. Cuando contactes con ellos, incluye el mensaje de error exacto que obtienes con el modo debug activado.

¿El error 500 afecta al posicionamiento SEO?

Sí, si el error persiste durante mucho tiempo, los motores de búsqueda pueden penalizar tu tienda. Por eso es importante arreglar error 500 lo antes posible. Google entiende que si tu web da errores, no está ofreciendo una buena experiencia al usuario.

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

El error 500 prestashop puede parecer aterrador, pero en la gran mayoría de los casos es un problema solucionable con un poco de paciencia y método. Hemos visto los pasos más efectivos para solucionar error 500 prestashop: activar el modo debug, revisar permisos, limpiar caché, comprobar el .htaccess, revisar módulos, aumentar memoria PHP y verificar la base de datos.

Recuerda que los problemas prestashop no son exclusivos de tu tienda; son algo habitual en la comunidad de usuarios y siempre hay soluciones documentadas. Si sigues esta guía paso a paso, tendrás muchas posibilidades de que tu tienda vuelva a funcionar sin necesidad de llamar a un desarrollador.

Y si necesitas ayuda adicional, no dudes en consultar los foros oficiales de PrestaShop o contactar con tu proveedor de hosting. Todos hemos pasado por esto alguna vez, y siempre hay alguien dispuesto a echar una mano.

[TIP] Guarda esta guía en tus favoritos. Te será útil la próxima vez que aparezca el error 500, porque créeme, en algún momento volverá a aparecer. Pero ahora ya sabes cómo enfrentarte a él.