Cómo Solucionar el Error 'Exceeded Memory Limit' en Magento 2 Paso a Paso

Introducción al Error de Límite de Memoria en Magento 2

Magento 2 es una plataforma de comercio electrónico robusta y exigente en cuanto a recursos de servidor. Uno de los problemas más frecuentes a los que se enfrentan los desarrolladores y administradores de tiendas online es el error crítico relacionado con el agotamiento de la memoria RAM asignada a PHP, comúnmente conocido como Allowed memory size exhausted.

Este fallo suele interrumpir tareas pesadas del sistema como la compilación de código, la actualización de la base de datos, la ejecución de comandos CLI o la indexación masiva de productos.

Causas Principales del Error 'Exceeded Memory Limit'

Para solucionar este problema de raíz, es importante comprender qué lo provoca:

• Configuración insuficiente del parámetro memory_limit en el archivo php.ini.
• Módulos o extensiones de terceros mal optimizados que generan fugas de memoria (memory leaks).
• Procesos pesados ejecutados mediante la consola (CLI) que superan el límite predeterminado para la web.
• Versiones de PHP desactualizadas que gestionan la memoria de forma menos eficiente.

Método 1: Aumentar el memory_limit en el archivo php.ini

La solución más directa consiste en incrementar la asignación de memoria para PHP en el servidor.

1. Accede a tu servidor mediante SSH o utiliza el panel de control de tu hosting (cPanel, Plesk, etc.).
2. Localiza el archivo php.ini correspondiente a la versión de PHP que utiliza tu tienda Magento. Si ejecutas comandos por CLI, asegúrate de modificar el archivo php.ini de la línea de comandos.
3. Busca la línea que define el límite de memoria y cámbiala a un valor óptimo para Magento 2 (se recomienda un mínimo de 2G o 4G): memory_limit = 2G
4. Guarda los cambios y reinicia tu servidor web (Apache o Nginx) y el servicio PHP-FPM para aplicar la nueva configuración: sudo systemctl restart php8.1-fpm

Método 2: Modificar el límite de memoria en el archivo .htaccess

Si utilizas un servidor web Apache y no tienes acceso directo al archivo php.ini principal, puedes intentar sobrescribir el límite a través del archivo de configuración local.

1. Conéctate a la raíz de tu instalación de Magento 2 mediante FTP o un gestor de archivos.
2. Busca el archivo oculto .htaccess (asegúrate de que tu cliente FTP muestre los archivos ocultos).
3. Añade la siguiente directiva al final del archivo: php_value memory_limit 2G
4. Guarda el archivo y recarga tu tienda para verificar que el error haya desaparecido.

Método 3: Ajustar el límite de memoria directamente en la ejecución CLI

Si el error ocurre exclusivamente al ejecutar comandos de consola (como bin/magento setup:upgrade o bin/magento indexer:reindex), puedes forzar un mayor límite de memoria directamente en la llamada de PHP sin alterar la configuración global.

1. Abre tu terminal SSH y navega hasta el directorio raíz de Magento.
2. Ejecuta el comando añadiendo el parámetro -d memory_limit seguido del valor deseado: php -d memory_limit=4G bin/magento setup:di:compile
3. Este método es altamente seguro ya que solo otorga recursos adicionales al proceso específico que lo necesita, evitando sobrecargar el servidor en peticiones web cotidianas.