Solucionar error 500 en PrestaShop | Pasos fáciles

¡Tranquilo, que el temido error 500 en PrestaShop es más común de lo que parece y, en la mayoría de los casos, tiene solución. Como técnico de soporte, he visto este fallo cientos de veces y puedo asegurarte que rara vez es el fin del mundo. Esta guía está diseñada para que, paso a paso, puedas solucionar el error PrestaShop sin necesidad de ser un experto en programación. Vamos a desglosar las causas más frecuentes y, lo más importante, cómo arreglarlas.

¿Qué es exactamente el error 500 en PrestaShop?

El error 500, también conocido como "Error Interno del Servidor", es la forma que tiene tu servidor de decir: "Algo ha ido mal, pero no sé explicarte exactamente qué". Es un mensaje genérico de PrestaShop fallo servidor. A diferencia de un error 404 (página no encontrada), aquí el problema está en la configuración del servidor, en un módulo defectuoso, en un archivo corrupto o en un límite de memoria excedido.

Lo primero que debes saber es que no te asustes. No has perdido tus datos ni tu tienda. Solo necesitas seguir una serie de pasos lógicos para identificar y reparar la causa raíz.

Paso 1: Lo primero, activa el modo debug de PrestaShop

Cuando ves un error 500, PrestaShop te muestra una página en blanco o un mensaje muy escueto. Para obtener información real del error, necesitas activar el modo debug. Esto hará que el sistema te muestre el error concreto (por ejemplo, un archivo PHP concreto que falla).

Cómo activar el modo debug (método manual)

Accede a tu servidor mediante FTP o el administrador de archivos de tu hosting.
Localiza el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop.
Descarga una copia de seguridad de este archivo por si acaso.
Ábrelo con un editor de texto plano (como Notepad++ o Sublime Text).
Busca la línea que dice: define('_PS_MODE_DEV_', false);
Cámbiala por: define('_PS_MODE_DEV_', true);
Guarda el archivo y súbelo de nuevo al servidor (sobrescribiendo el original).

[WARNING] Al activar el modo debug, tu tienda será visible para todos los visitantes, mostrando errores técnicos. Es recomendable hacerlo solo durante unos minutos para diagnosticar el problema y luego volver a ponerlo en false.

Una vez hecho esto, recarga la página que daba el error 500. Ahora verás un mensaje mucho más descriptivo, como por ejemplo: Fatal error: Allowed memory size of 134217728 bytes exhausted. Ese mensaje es la clave para saber qué hacer.

Paso 2: Aumentar el límite de memoria PHP (el culpable más frecuente)

El error más común asociado a un error 500 PrestaShop es que el script se queda sin memoria. PrestaShop, sobre todo con muchos módulos o una gran base de datos, necesita bastante memoria PHP. Si tu hosting tiene un límite bajo (por ejemplo, 128M), es muy probable que te aparezca este fallo.

Cómo aumentar la memoria PHP

Hay tres formas de hacerlo, y te recomiendo probarlas en este orden:

Desde el archivo .htaccess (el más rápido):
- Localiza el archivo .htaccess en la raíz de tu PrestaShop. Si no lo ves, asegúrate de que tu cliente FTP muestre archivos ocultos.
- Ábrelo y añade esta línea al principio del archivo:
  php_value memory_limit 256M
- Si ya tienes una línea similar, cámbiala a 256M o incluso 512M.
- Guarda y sube el archivo.
Desde el archivo php.ini (si tu hosting lo permite):
- Crea un archivo llamado php.ini en la raíz de tu PrestaShop.
- Dentro, escribe: memory_limit = 256M
- Guarda y súbelo.
Desde el panel de control de tu hosting (Syspanel):
- Si tu hosting usa Syspanel (antes conocido como HestiaCP), accede a través del puerto 2106 (ejemplo: https://tudominio.com:2106).
- Busca la sección de "PHP" o "Configuración de PHP".
- Localiza la opción memory_limit y cámbiala a 256M o 512M.
- Guarda los cambios y espera unos segundos.

[TIP] Si después de aumentar la memoria el error persiste, prueba con 512M. Si sigue fallando, el problema no es la memoria.

Paso 3: Deshabilitar módulos problemáticos

Otra causa muy común es un módulo que se ha actualizado mal, que es incompatible con tu versión de PrestaShop o que simplemente tiene un bug. Para solucionarlo, vamos a deshabilitar los módulos de uno en uno.

Cómo deshabilitar módulos manualmente (sin acceso al panel de admin)

Si el error 500 te impide acceder al back office, puedes deshabilitar módulos desde la base de datos o renombrando sus carpetas. Te explico el método más seguro:

Accede a tu servidor por FTP.
Ve a la carpeta /modules.
Verás una lista de carpetas, una por cada módulo instalado.
Renombra la carpeta del módulo que sospechas que puede estar causando el problema. Por ejemplo, si tienes un módulo de "megamenu", renómbralo a megamenu_BACKUP.
Recarga tu tienda. Si el error desaparece, ¡has encontrado al culpable!
Si no sabes qué módulo es, renombra todos los módulos de uno en uno (o en grupos) hasta que el error desaparezca.

[WARNING] No borres las carpetas de los módulos, solo renómbralas. Así podrás restaurarlos fácilmente después. Si renombras la carpeta de un módulo esencial (como el de pago o el de theme), tu tienda puede funcionar de forma extraña, pero no se romperá.

Paso 4: Verificar los permisos de archivos y carpetas

A veces, después de una actualización o una migración, los permisos de los archivos se desconfiguran. PrestaShop necesita permisos específicos para leer y escribir.

Permisos correctos

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)
Archivos de configuración (como config/defines.inc.php): 644 o 444 (solo lectura).

Puedes cambiar los permisos desde tu cliente FTP. Selecciona toda la carpeta de PrestaShop, haz clic derecho y elige "Cambiar permisos" (o "CHMOD"). Aplica 755 a carpetas y 644 a archivos de forma recursiva.

[INFO] Algunos hostings no permiten cambiar permisos de forma masiva desde FTP. En ese caso, usa el administrador de archivos de tu panel de control (como Syspanel o cPanel).

Paso 5: Revisar el archivo .htaccess

El archivo .htaccess es el "director de tráfico" de tu tienda. Si está corrupto, puede generar un error 500. Lo bueno es que PrestaShop puede regenerarlo automáticamente.

Cómo regenerar el .htaccess

Localiza el archivo .htaccess en la raíz de tu PrestaShop.
Renómbralo a .htaccess_old (esto lo desactiva).
Ahora, intenta acceder a tu tienda. Si el error 500 desaparece, el problema era el .htaccess.
Para regenerarlo, accede a tu back office de PrestaShop (si puedes) o, si no, desde la base de datos (es un poco más técnico, pero te explico lo básico).
En el back office, ve a Configuración de la tienda > Tráfico y SEO. Allí, en la sección "URL amigables", desactiva y vuelve a activar la opción "URL amigables". Esto forzará a PrestaShop a crear un nuevo .htaccess.

Si no puedes acceder al back office, puedes crear un archivo .htaccess básico desde un editor de texto con este contenido mínimo:

# START PRESTASHOP
<IfModule mod_rewrite.c>
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>
# END PRESTASHOP

Súbelo a la raíz y comprueba si la tienda funciona. Esto no es una solución definitiva, pero te permitirá acceder al back office para regenerar el archivo correcto.

Paso 6: Verificar la integridad de los archivos de PrestaShop

A veces, durante una actualización fallida o un ataque, algún archivo core de PrestaShop se corrompe. Puedes comparar tus archivos con los originales de tu versión.

Cómo hacerlo

Descarga la misma versión de PrestaShop que tienes instalada desde el sitio oficial.
Descomprime el archivo en tu ordenador.
Compara los archivos de las carpetas /classes, /controllers, /override y /config con los de tu servidor. Puedes usar herramientas como WinMerge (Windows) o Meld (Linux/Mac).
Si encuentras diferencias en archivos que no son de módulos ni de temas, es probable que estén corruptos. Reemplázalos por los originales.

[WARNING] No reemplaces archivos de la carpeta /override ni de /themes, ya que contienen personalizaciones. Céntrate en los archivos core.

Paso 7: Contactar con el soporte de tu hosting

Si después de todos estos pasos el error 500 PrestaShop sigue apareciendo, el problema puede estar en la configuración del servidor a nivel más profundo. Cuestiones como:

Versión de PHP incorrecta: PrestaShop 1.6 funciona mejor con PHP 5.6 o 7.0, mientras que PrestaShop 1.7 y 8 necesitan PHP 7.1 o superior (recomendado 7.4 o 8.0).
Módulos del servidor desactivados: Como mod_rewrite (necesario para URLs amigables) o la extensión mysqli.
Límites del servidor: Como el max_execution_time o el upload_max_filesize.

En este caso, contacta con el soporte de tu hosting. Diles que has seguido esta guía y que el error persiste. Ellos podrán revisar los logs del servidor (archivos de error) para darte una respuesta más precisa.

[INFO] Si tu hosting usa Syspanel (puerto 2106), puedes revisar los logs de error desde el panel. Busca la sección "Logs" o "Registros". Allí suele haber un archivo llamado error.log o php_error.log que te dará pistas adicionales.

Preguntas Frecuentes (FAQ) sobre el error 500 en PrestaShop

¿El error 500 borra mis datos?

No. El error 500 es un problema de ejecución del servidor, no de pérdida de datos. Tus productos, clientes y pedidos están a salvo en la base de datos. Una vez solucionado el error, todo vuelve a la normalidad.

¿Puedo solucionar el error 500 sin acceso al back office?

Sí, como has visto en esta guía, la mayoría de las soluciones (modo debug, aumentar memoria, deshabilitar módulos, revisar .htaccess) se hacen desde FTP o el panel de control. No necesitas entrar al administrador de PrestaShop.

¿Qué hago si después de activar el modo debug veo un error de "Class not found"?

Eso indica que un archivo PHP esencial está corrupto o falta. Lo más probable es que tengas que reemplazar los archivos core de PrestaShop (como se explica en el Paso 6). Si el error menciona un módulo concreto, deshabilítalo.

¿El error 500 puede deberse a un tema (theme) defectuoso?

Sí, totalmente. Un tema mal codificado o incompatible puede provocar un error 500. Para probarlo, cambia temporalmente al tema predeterminado de PrestaShop (por ejemplo, "classic" en PrestaShop 1.7). Puedes hacerlo renombrando la carpeta de tu tema en /themes y forzando el uso del tema por defecto desde la base de datos (es más técnico, pero factible).

¿Cada cuánto debo revisar los límites de memoria de mi hosting?

Es recomendable hacerlo después de cada actualización importante de PrestaShop o de instalar módulos pesados. Si notas que tu tienda va lenta o da errores esporádicos, revisa el límite de memoria.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia y el método son tus mejores aliados. Si sigues estos pasos, en la mayoría de los casos podrás solucionar el error PrestaShop por ti mismo. ¡Mucho ánimo y a seguir vendiendo!