Cómo arreglar error 500 en PrestaShop | Troubleshooting

Si estás leyendo esto, probablemente te has topado con el temido error 500 en PrestaShop. Esa pantalla en blanco o el mensaje genérico de "Error interno del servidor" puede ser frustrante, especialmente si no eres un experto en sistemas. Pero no te preocupes: como técnico de soporte, te guiaré paso a paso para que puedas solucionar error 500 en tu tienda, incluso si eres un SysAdmin novato o un usuario con poca experiencia técnica.

Vamos a desglosar las causas más comunes y, lo más importante, cómo resolverlas. Recuerda que este artículo está pensado para que sigas las instrucciones sin necesidad de ser un gurú de la programación. ¡Empecemos!

¿Qué es un error 500 en PrestaShop?

El error 500 prestashop, también conocido como "Error interno del servidor", es una respuesta genérica que da el servidor web cuando algo falla en la configuración, el código o los permisos de los archivos. No te dice exactamente qué está mal, pero sí te indica que algo impide que PrestaShop funcione correctamente.

Las causas más habituales suelen ser:

Archivos de configuración corruptos (como settings.inc.php).
Módulos incompatibles o mal instalados.
Problemas de permisos en carpetas y archivos.
Límite de memoria de PHP excedido.
Errores en el archivo .htaccess (en servidores Apache).
Conflictos con la versión de PHP o extensiones faltantes.

No entres en pánico. La mayoría de estos problemas se pueden resolver con unos pocos pasos. Vamos a verlos en orden, de lo más simple a lo más avanzado.

Paso 1: Activar el modo debug de PrestaShop

Antes de tocar nada, necesitas que PrestaShop te muestre el error real. Por defecto, el sistema oculta los detalles por seguridad, pero tú puedes activar el modo debug para ver exactamente qué está fallando.

¿Cómo activar el modo debug?

Accede a tu servidor mediante FTP o al panel de control de tu hosting (por ejemplo, Syspanel en el puerto 2106). Busca el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop.

Dentro de ese archivo, busca esta línea:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda los cambios y recarga tu tienda. Ahora, en lugar de la pantalla en blanco, verás un mensaje de error detallado con el nombre del archivo y la línea donde falla. Anota ese mensaje, porque te dará pistas clave.

[TIP] Si no encuentras el archivo defines.inc.php, puede que tu PrestaShop esté en una versión antigua. En ese caso, busca config/config.inc.php y añade al final: define('_PS_MODE_DEV_', true);.

Paso 2: Revisar los logs del servidor

Si el modo debug no te da suficiente información, o si no puedes acceder a los archivos de PrestaShop, los logs del servidor son tu mejor aliado. Estos archivos registran todos los errores que ocurren en el sistema.

¿Dónde están los logs?

Si usas un hosting compartido, normalmente los logs están en una carpeta llamada logs o error_log dentro de tu cuenta. Pregunta a tu proveedor si no los encuentras.
Si tienes acceso a Syspanel (puerto 2106), puedes ir a la sección de "Logs del sistema" o "Registros de errores" para ver los mensajes recientes.
También puedes revisar el archivo error.log en la raíz de tu servidor (a veces está en /var/log/apache2/ o /var/log/nginx/).

Busca entradas que contengan "PHP Fatal error" o "PrestaShop". Allí verás detalles como "Allowed memory size exhausted" (límite de memoria) o "Call to undefined function" (función no encontrada).

Paso 3: Comprobar los permisos de archivos y carpetas

Los permisos incorrectos son una de las causas más frecuentes del error 500 prestashop. PrestaShop necesita que ciertas carpetas sean escribibles para funcionar (por ejemplo, para guardar caché, imágenes o módulos).

Permisos recomendados

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)

Puedes cambiarlos desde tu cliente FTP (FileZilla, por ejemplo) o desde el panel de control. En Syspanel, usa el "Administrador de archivos" para seleccionar la carpeta raíz de PrestaShop y ajustar los permisos de forma recursiva (aplica a todas las subcarpetas y archivos).

[WARNING] No pongas permisos 777 en ninguna carpeta, ya que es un riesgo de seguridad. 755 es suficiente para que PrestaShop funcione.

Si después de cambiar permisos el error persiste, pasa al siguiente paso.

Paso 4: Verificar el archivo .htaccess

El archivo .htaccess (en servidores Apache) controla las reglas de reescritura de URL y otras configuraciones. Si está corrupto o mal generado, puede provocar un error 500.

¿Cómo solucionarlo?

Conéctate por FTP y localiza el archivo .htaccess en la raíz de tu tienda.
Haz una copia de seguridad (por ejemplo, renómbralo a .htaccess.bak).
Crea un archivo nuevo vacío llamado .htaccess (sin contenido).
Ve al panel de administración de PrestaShop (si aún puedes acceder) y regenera el .htaccess desde: Parámetros de la tienda > Tráfico y SEO > URL amigables. Marca la opción "Regenerar el archivo .htaccess" y guarda.

Si no puedes acceder al panel, prueba a subir un .htaccess básico con solo estas líneas:

<IfModule mod_rewrite.c>
RewriteEngine On
</IfModule>

Esto desactivará las URL amigables temporalmente, pero puede que la tienda cargue. Luego, desde el panel, regenera el archivo correctamente.

Paso 5: Aumentar el límite de memoria de PHP

El error "Allowed memory size of X bytes exhausted" es muy común en tiendas con muchos productos o módulos pesados. Para solucionar error 500 por falta de memoria, necesitas aumentar el límite.

¿Cómo hacerlo?

Si tienes acceso a Syspanel (puerto 2106), busca la sección "PHP Settings" o "Configuración de PHP". Allí podrás cambiar el valor de memory_limit a por lo menos 256M o 512M.
Si no, edita el archivo php.ini de tu servidor (si está disponible) o añade esta línea al archivo config/defines.inc.php de PrestaShop (justo antes de la línea que modificamos antes):

ini_set('memory_limit', '512M');

También puedes probar a añadirla en el archivo .htaccess:

php_value memory_limit 512M

[INFO] No todos los servidores permiten modificar estos valores desde .htaccess. Si no funciona, contacta a tu proveedor de hosting.

Paso 6: Deshabilitar módulos problemáticos

Los módulos de terceros son otra fuente común de error 500 prestashop. Si instalaste un módulo justo antes de que apareciera el error, es probable que sea el culpable.

¿Cómo deshabilitar módulos sin acceso al panel?

Conéctate por FTP a tu servidor.
Ve a la carpeta modules de tu instalación de PrestaShop.
Localiza la carpeta del módulo sospechoso (por ejemplo, modules/nombredelmodulo).
Renombra la carpeta añadiendo algo como _old al final (ejemplo: nombredelmodulo_old). Esto desactivará el módulo.
Recarga la tienda. Si el error desaparece, ya sabes qué módulo causaba el problema. Puedes eliminarlo o reinstalarlo desde el panel.

Si no sabes cuál es el módulo problemático, desactiva todos renombrando sus carpetas (una por una) o, si te atreves, mueve todos los módulos a una carpeta temporal y luego ve activándolos de uno en uno.

Paso 7: Revisar la versión de PHP y extensiones

PrestaShop requiere una versión específica de PHP (generalmente 7.4, 8.0 o 8.1, según la versión de tu tienda). Si tu servidor tiene una versión incompatible, obtendrás errores.

¿Cómo verificarlo?

En Syspanel (puerto 2106), busca "PHP Version" o "Selector de PHP". Asegúrate de que la versión activa sea compatible con tu PrestaShop. Por ejemplo, PrestaShop 1.7 funciona mejor con PHP 7.4, mientras que la 8.x necesita PHP 8.0 o superior.
También necesitas extensiones como mysqli, gd, curl, mbstring, json y openssl. En el panel de control, suele haber una lista de extensiones activas. Si falta alguna, actívala.

Si no puedes cambiar la versión de PHP, contacta a tu proveedor de hosting.

Paso 8: Restaurar archivos de PrestaShop desde una copia de seguridad

Si después de todos los pasos anteriores el error 500 prestashop persiste, puede que algún archivo del núcleo de PrestaShop esté dañado (por ejemplo, por una actualización fallida o un ataque). En ese caso, la solución más segura es restaurar los archivos originales.

¿Cómo hacerlo?

Descarga la misma versión de PrestaShop que tienes instalada desde el sitio oficial (prestashop.com).
Descomprime el archivo en tu ordenador.
Sube por FTP solo las carpetas admin, classes, controllers, core, js, src, vendor y themes (no subas la carpeta modules ni override para no perder personalizaciones). Sobrescribe los archivos existentes.
Recarga la tienda.

[WARNING] Este paso puede deshacer modificaciones que hayas hecho en el núcleo de PrestaShop. Si tienes personalizaciones, haz una copia de seguridad de tus archivos override antes de sobrescribir.

Preguntas frecuentes (FAQ)

¿Por qué veo un error 500 solo en el back office y no en la tienda?

Esto suele deberse a un módulo de administración conflictivo o a un problema de permisos en la carpeta admin. Revisa los logs y desactiva módulos recién instalados.

¿El error 500 puede ser por un tema (theme) personalizado?

Sí, especialmente si el tema usa funciones obsoletas o archivos corruptos. Prueba a cambiar temporalmente al tema predeterminado (por ejemplo, classic) renombrando la carpeta del tema actual en themes.

¿Cómo evito futuros errores 500?

Mantén PrestaShop, módulos y temas actualizados.
Haz copias de seguridad periódicas (archivos y base de datos).
Usa un hosting con soporte técnico rápido y adecuado para PrestaShop.
No instales módulos de fuentes no confiables.

¿Qué hago si no puedo acceder ni por FTP ni por el panel de control?

Contacta a tu proveedor de hosting. Ellos tienen acceso directo al servidor y pueden revisar los logs y restaurar archivos desde su parte. Si usas Syspanel (puerto 2106), puedes solicitar asistencia a través del sistema de tickets.

Resumen final

El error 500 prestashop no es el fin del mundo. Siguiendo esta guía, paso a paso, podrás identificar la causa y solucionar error 500 en la mayoría de los casos. Recuerda:

Activa el modo debug para ver el error real.
Revisa los logs del servidor.
Ajusta permisos de archivos (755/644).
Verifica y regenera el .htaccess.
Aumenta el límite de memoria de PHP.
Desactiva módulos sospechosos.
Comprueba la versión de PHP y extensiones.
Restaura archivos del núcleo si es necesario.

Si después de todo esto el problema continúa, no dudes en pedir ayuda a un profesional o al soporte de tu hosting. ¡Ánimo, que tu tienda volverá a funcionar en poco tiempo!