Error de memoria agotada en WordPress

Qué significa este error y cómo reconocerlo

• Un error fatal incluye un texto similar a Allowed memory size of 134217728 bytes exhausted (tried to allocate ... bytes).
• Puede fallar todo el sitio, o el problema puede limitarse al escritorio, a la pantalla de un plugin, a una importación, una migración o una acción masiva.
• El error puede comenzar después de instalar o actualizar un plugin o tema, iniciar una operación grande con datos o trasladar el sitio a un hosting con un límite de memoria de PHP inferior.
• La página de inicio puede cargar con normalidad mientras falla una importación, una pantalla de un maquetador visual, la sincronización de productos u otra tarea que consuma mucha memoria.
• Aumentar la memoria puede parecer que soluciona las páginas normales, mientras la operación original sigue fallando.

Causas principales, ordenadas por probabilidad

1. El memory_limit de PHP es demasiado bajo para el sitio o la solicitud. El núcleo de WordPress, el tema activo, los plugins, la solicitud actual y los datos procesados pueden superar un valor de hosting predeterminado y restrictivo.
2. Un plugin o tema utiliza mucha memoria. Los maquetadores visuales, las herramientas de importación/exportación, el software de copias de seguridad, las herramientas de caché y las suites completas de SEO o marketing pueden utilizar bastante más memoria durante determinadas tareas.
3. Una operación grande procesa demasiados datos a la vez. Las importaciones de medios, la sincronización de productos, las migraciones y las tareas de buscar y reemplazar pueden superar el límite aunque las cargas normales de páginas funcionen.
4. El conjunto de plugins activos tiene un consumo base elevado. Varios consumidores moderados pueden superar juntos el límite.
5. Las capas de configuración no coinciden. wp-config.php, el panel de hosting, php.ini, .user.ini y los ajustes aplicables de .htaccess pueden producir valores efectivos diferentes para las solicitudes web.
6. Un componente tiene una ruta de procesamiento ineficiente o una fuga de memoria. Esto es más probable cuando una acción específica falla con una carga de trabajo moderada o después de usos repetidos, y no únicamente durante una operación previsiblemente grande.

Cómo solucionarlo

1. Identifica la solicitud que falla

Copia el mensaje de error fatal completo, si está disponible. Registra si el fallo afecta a todas las páginas, solo al escritorio, a la pantalla de un plugin o a una operación concreta, como una importación o una edición masiva. Esta distinción ayuda a separar un límite generalmente bajo de un problema específico de la carga de trabajo.

2. Solicita más memoria desde WordPress

Antes de editar archivos, crea una copia de seguridad o confirma que puedes restaurar la configuración actual. Mediante SFTP o el gestor de archivos del hosting, abre wp-config.php y añade esta línea encima de /* That's all, stop editing! */:

define('WP_MEMORY_LIMIT', '256M');

Esto solicita que WordPress utilice 256 MB cuando el servidor lo permita. Si la constante ya existe, edita esa definición en lugar de añadir una segunda. Algunas tareas administrativas pueden utilizar un ajuste de memoria de administración independiente, por lo que un fallo limitado al escritorio puede requerir una investigación adicional.

3. Comprueba el límite de PHP utilizado por el sitio

WP_MEMORY_LIMIT no puede elevar PHP por encima del memory_limit establecido por el propio servidor. Comprueba el panel de control del hosting o el php.ini utilizado por la versión de PHP que sirve el sitio. En un VPS, cambiar la configuración de PHP correspondiente puede requerir reiniciar PHP-FPM o el servicio de PHP aplicable; hazlo únicamente si tienes el acceso y la autorización necesarios.

Algunas configuraciones de Apache que utilizan mod_php permiten un ajuste como:

php_value memory_limit 256M

en .htaccess. Esto no se aplica a PHP-FPM y puede provocar un error de configuración del servidor cuando la directiva no está permitida. Utiliza el panel de hosting o consulta al proveedor antes de añadirla. Un ajuste de PHP desde la línea de comandos puede ser diferente de la configuración utilizada por las solicitudes web.

4. Repite la acción exacta que falla

Reintenta la importación, edición masiva, operación del plugin o solicitud de página que produjo el error. Cargar únicamente la página de inicio no es suficiente, porque una página normal puede utilizar mucha menos memoria que la tarea fallida. Si la tarea funciona, supervisa su ejecución y evita aumentar más el límite, a menos que la misma operación siga necesitando más memoria.

5. Reduce el uso máximo de memoria de la operación

En importaciones, migraciones, sincronizaciones o ediciones masivas, reduce el tamaño del lote de la herramienta o divide el trabajo en grupos más pequeños. Esto suele ser más seguro que asignar un límite muy alto a todas las solicitudes de PHP. Ejecutar trabajos grandes en un periodo de menor actividad puede reducir el riesgo operativo, pero no disminuye el requisito máximo de memoria de la solicitud.

6. Aísla el plugin o tema probable

Si 256M o 512M siguen siendo insuficientes, o el problema comenzó después de un cambio, prueba el componente asociado a la pantalla o tarea que falla. Utiliza una copia de staging cuando sea posible. En un sitio activo, crea primero una copia de seguridad y desactiva los plugins uno por uno. Si no puedes acceder al escritorio, utiliza SFTP o el gestor de archivos para cambiar temporalmente el nombre del directorio del plugin sospechoso e impedir que WordPress lo cargue.

Da prioridad al componente modificado recientemente y al plugin relacionado con el fallo, seguidos de los maquetadores visuales, las herramientas de importación/exportación, las herramientas de copias de seguridad, las herramientas de caché y las suites completas de gran tamaño. Si fallan las páginas públicas, prueba también con un tema predeterminado. Vuelve a activar los componentes que no sean responsables después de cada prueba para saber qué configuración se ha probado.

7. Compara los valores efectivos de configuración

Si cambiar WP_MEMORY_LIMIT no tiene ningún efecto visible, compara la solicitud de WordPress con el valor de PHP utilizado por las solicitudes web. Revisa el panel de hosting, php.ini, .user.ini y los ajustes aplicables de .htaccess, junto con cualquier límite máximo impuesto por el proveedor. Pregunta al proveedor qué configuración de PHP se aplica si no puedes verificarlo por tu cuenta.

8. Confirma la solución permanente

Vuelve a ejecutar la operación original que fallaba y, después, comprueba páginas públicas y administrativas importantes. Si el sitio solo funciona después de establecer un límite muy alto, considéralo una pista de diagnóstico y sigue investigando el plugin, tema, consulta o tamaño de lote responsable en lugar de considerar que el problema está resuelto de forma permanente.

Prevención y cómo verificar la solución

• Utiliza un valor de memoria de WordPress planificado y compatible con el hosting en lugar de esperar a que falle una tarea en producción.
• Elimina los plugins que no utilices y revisa periódicamente el conjunto de plugins activos, ya que el consumo base es acumulativo.
• Mantén los lotes de importaciones, migraciones, sincronizaciones y ediciones masivas dentro de la memoria de PHP disponible.
• Prueba las operaciones grandes en staging o con un conjunto de datos limitado antes de procesar todo el sitio.
• Después de cambiar plugins o configuraciones, repite la operación que falló anteriormente y verifica las páginas públicas y administrativas.
• Registra qué configuración de PHP se aplica a las solicitudes web para realizar futuros cambios de memoria en el lugar correcto.

Preguntas frecuentes