¿Cómo solucionar el error "Temporalmente no disponible debido a mantenimiento" en WordPress?

El error "Temporalmente no disponible por mantenimiento" es uno de los problemas más molestos que puede sufrir un propietario de sitio web en WordPress. Al parecer, cuando WordPress entra en modo de mantenimiento durante una actualización, bloquea el acceso a todos los visitantes, incluido el tuyo. Esta guía te explica las posibles causas y soluciones.

Aunque nunca antes hayas modificado un archivo de servidor, puedes solucionar este error. Los pasos son sencillos y la mayoría te llevarán menos de cinco minutos.

TL;DR: Soluciones rápidas para el error del modo de mantenimiento de WordPress

• WordPress crea un .maintenance al inicio de cada actualización y lo elimina una vez finalizada. Si la actualización falla, el archivo permanece y mantiene el sitio bloqueado.

• En la mayoría de los casos, eliminar ese archivo de su servidor es la solución más rápida.

• Deshabilitar los complementos y cambiar a un tema predeterminado ayuda cuando la causa principal es un conflicto de compatibilidad.

• Elegir una agencia de mantenimiento y soporte de WordPress fiable, y realizar copias de seguridad adecuadas, evita que esto se convierta en un problema recurrente.

¿Qué significa “Temporalmente no disponible debido a mantenimiento” en WordPress?

WordPress entra automáticamente en modo de mantenimiento durante una actualización. Crea un archivo oculto llamado .maintenance en la carpeta raíz de tu sitio. Este archivo muestra el mensaje: «No disponible temporalmente por mantenimiento programado. Vuelve a intentarlo en un minuto».

En condiciones normales, WordPress elimina este archivo en cuanto finaliza la actualización. El sitio vuelve a estar en línea y nadie nota la breve interrupción. El problema surge cuando la actualización se interrumpe. El archivo permanece en el servidor y la pantalla de mantenimiento nunca desaparece.

Cuanto más tiempo persista esta situación, mayor será el daño a la confianza del usuario. Un sitio web que deja de funcionar sin explicación pierde rápidamente la confianza de sus visitantes.

Diferencia entre el modo de mantenimiento y un error 503 de servicio no disponible

Estos dos errores parecen similares, pero tienen orígenes y soluciones diferentes.

• El modo de mantenimiento de WordPress lo activa el propio CMS. El .maintenance es la causa. WordPress pone tu sitio en este estado intencionadamente durante una actualización. Es una situación controlada y recuperable.

• error 503 (Servicio no disponible) es una respuesta HTTP a nivel de servidor. Significa que el servidor no puede procesar las solicitudes, a menudo debido a una sobrecarga, una configuración incorrecta o errores de Cloudflare entre el servidor de origen y la CDN. Un error 503 requiere un diagnóstico a nivel de servidor y no está relacionado con el proceso de actualización.

Si ve el mensaje "Temporalmente no disponible por mantenimiento", busque primero el .maintenance . Si ve una página de error 503 sin formato, el problema se encuentra en el servidor o en la red.

¿Por qué este error puede impedirle acceder al panel de administración de WordPress?

Cuando se activa el modo de mantenimiento, WordPress lo aplica a todas las URL del sitio, incluida /wp-admin. El sistema no puede distinguirte de un visitante normal. Cada solicitud devuelve la pantalla de mantenimiento.

Esto significa que no puedes iniciar sesión y solucionar el problema desde WordPress. Debes acceder al servidor directamente mediante FTP, SFTP o el panel de control de tu hosting.

Antes de realizar cambios, revisa los registros de errores de WordPress para comprender qué provocó la actualización fallida. Estos registros suelen revelar un tiempo de espera de PHP, un límite de memoria o un error de un plugin que causó la interrupción.

¿Por qué aparece el error "Temporalmente no disponible debido a mantenimiento"?

Diversas condiciones pueden provocar que una actualización se detenga a mitad de camino, dejando a WordPress atascado en modo de mantenimiento.

Actualizaciones de plugins o temas de WordPress interrumpidas

Una actualización puede detenerse a mitad de proceso por diversas razones. Un servidor lento, un problema de red o un plugin que exceda el tiempo de ejecución de PHP pueden interrumpir el proceso. Cuando esto sucede, WordPress no ejecuta el paso de limpieza que elimina el .maintenance archivo

El exceso de plugins en WordPress es un factor que contribuye con frecuencia a este problema. Un sitio con 30 o 40 plugins tiene muchas más probabilidades de sufrir conflictos de actualización y errores de tiempo de espera que uno con una selección reducida y cuidadosamente elegida.

Falló el proceso de actualización del núcleo de WordPress

Los fallos en la actualización del núcleo son más graves que los fallos en los plugins. WordPress reemplaza sus propios archivos principales durante este proceso. Si se interrumpe a mitad de camino, algunos archivos pueden reemplazarse parcialmente. Esto deja la instalación en un estado inestable.

Omitir las copias de seguridad antes de las actualizaciones es uno de los errores más comunes en el desarrollo de WordPress. Sin una copia de seguridad, recuperarse de una actualización fallida del núcleo requiere reconstruir la instalación manualmente.

Archivo .maintenance dañado o bloqueado

En ocasiones, la actualización se completa correctamente, pero el proceso de limpieza falla. WordPress no elimina el .maintenance y la pantalla de mantenimiento permanece activa aunque el sitio esté completamente actualizado.

El archivo se encuentra en el directorio raíz de WordPress, la misma carpeta que contiene wp-config.php y wp-login.php. Es un archivo oculto que comienza con un punto, por lo que muchos gestores de archivos no lo muestran por defecto.

Este escenario es el más común y el más fácil de solucionar. Basta con borrar el archivo.

Problemas de tiempo de espera del servidor o límite de memoria PHP bajo

Cada actualización de WordPress consume memoria del servidor y CPU. Si su servidor impone un límite bajo de memoria PHP o un tiempo máximo de ejecución corto, la actualización podría caducar antes de finalizar.

Si tu sitio de WordPress es lento o se queda sin recursos con frecuencia, es mucho más probable que fallen las actualizaciones. Aumentar el límite de memoria de PHP a al menos 256 MB y establecer un tiempo de ejecución más prolongado reduce significativamente este riesgo.

Conflictos de compatibilidad de plugins o temas

Actualizar un plugin puede romper la compatibilidad con otro. Si WordPress detecta un error grave durante el proceso de actualización, puede detenerse y dejar activado el modo de mantenimiento.

Mantener actualizados tus plugins y los temas de WordPress más rápidos reduce la posibilidad de incompatibilidades. Siempre lee el registro de cambios antes de actualizar un plugin importante. Los cambios incompatibles suelen estar documentados allí.

Actualizar varios complementos simultáneamente

WordPress permite seleccionar todos los plugins obsoletos y actualizarlos a la vez. Si bien esto parece eficiente, multiplica el riesgo. Cada actualización de un plugin inicia su propio ciclo de mantenimiento breve. La superposición de ciclos puede provocar conflictos de sincronización y mantener el modo de mantenimiento activo.

Actualiza los plugins uno por uno. Esto lleva unos minutos adicionales, pero reduce drásticamente la posibilidad de que la actualización se quede bloqueada.

Entorno de alojamiento lento o limitaciones de recursos

Un servidor que no pueda asignar suficiente CPU, RAM o tiempo de ejecución tendrá dificultades para completar las actualizaciones de forma fiable. Esto es especialmente cierto en entornos de alojamiento compartido.

Actualizar a un proveedor de alojamiento de WordPress resuelve muchos problemas recurrentes en modo de mantenimiento. Los servicios de alojamiento administrado de WordPress se encargan de la configuración del servidor específicamente para las cargas de trabajo de WordPress y aplican límites de recursos que permiten actualizaciones fiables.

El navegador se cerró o se desconectó Internet durante las actualizaciones

Si cierras la pestaña del navegador o pierdes la conexión a internet durante una actualización, el proceso PHP que se ejecuta en el servidor puede continuar durante un tiempo antes de que se agote el tiempo de espera. La actualización falla a mitad de camino.

Permanezca en la página mientras se realizan las actualizaciones. Espere a que WordPress muestre el mensaje "Mantenimiento completado" antes de cerrar la pestaña del navegador o abandonar la página.

¿Cómo solucionar el error "Temporalmente no disponible debido a mantenimiento" en WordPress?

Siga estos pasos en orden. Comience con la solución más sencilla y continúe con las demás si el problema persiste.

Si no te sientes cómodo trabajando directamente con los archivos del servidor, de WordPress los servicios profesionales de corrección de errores pueden resolver esto rápidamente sin riesgo de empeorar las cosas.

Elimine el archivo .maintenance del directorio raíz de WordPress

Esta es la solución más directa y resuelve la mayoría de los casos.

• Inicie sesión en su panel de control de alojamiento (cPanel o similar) y abra el Administrador de archivos. También puede conectarse mediante FTP o SFTP.

• Navegue hasta la carpeta raíz de su instalación de WordPress, la que contiene wp-config.php.

• Habilita la opción para mostrar archivos ocultos. El .maintenance comienza con un punto y está oculto por defecto.

• Localiza el .maintenance .

• Elimínalo.

• Actualiza tu sitio web en el navegador.

Su sitio web debería volver a la normalidad de inmediato.

Borrar la caché de WordPress y del navegador después de desactivar el modo de mantenimiento

Tras eliminar el .maintenance , es posible que su navegador o un complemento de almacenamiento en caché siga mostrando una versión almacenada en caché de la pantalla de mantenimiento.

Primero, borra la caché de tu navegador. Luego, inicia sesión en WordPress y borra la caché de tu plugin. WP Rocket, FastPixely LiteSpeed ​​Cache ofrecen una opción para borrar la caché con un solo clic en el panel de control de WordPress. Este paso garantiza que todos los visitantes vean el sitio web en vivo en lugar de una página de error almacenada en caché.

Desactiva manualmente todos los plugins de WordPress

Si el sitio web sigue sin funcionar después de eliminar el .maintenance , es posible que aún exista un conflicto de plugins.

• Conéctese a su servidor mediante FTP o SFTP.
• Navegue a wp-content/plugins/.
• Cambie el nombre de toda la de complementos , por ejemplo, cámbiele el nombre a plugins_disabled.
• Carga tu sitio web.

Si el sitio ahora funciona, vuelva a cambiar el nombre de la carpeta a plugins. Luego, reactive cada plugin individualmente y pruebe después de cada activación. El plugin que causa el problema es el que genera el conflicto.

Cambiar a un tema predeterminado de WordPress

Un tema dañado o incompatible puede impedir que WordPress complete el proceso de recuperación.

• Conéctese a su servidor a través de FTP.
• Navegue a wp-content/themes/.
• Cambia el nombre de la carpeta de tu tema activo a algo como mytheme_backup.
• WordPress recurre al tema predeterminado más reciente que puede encontrar.

Si tu sitio web carga con el tema predeterminado, el problema reside en tu tema personalizado de WordPress . Ponte en contacto con el desarrollador del tema o vuelve a una versión anterior de los archivos del tema.

Aumentar el límite de memoria PHP en WordPress

Un límite de memoria PHP bajo provoca tiempos de espera de actualización. Añada la siguiente línea a su wp-config.php , justo antes de la línea que dice /* ¡Eso es todo, deje de editar! */:

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

También puedes contactar con tu proveedor de hosting y solicitar que aumente el límite de memoria del servidor. Algunos planes de hosting para pequeñas empresas tienen por defecto 64 MB o 128 MB, lo cual suele ser insuficiente para actualizaciones fiables de WordPress. Solicita un mínimo de 256 MB.

Completa manualmente las actualizaciones fallidas de WordPress

Si la actualización principal falló, es posible que deba ejecutarla manualmente de nuevo.

• Descarga la última versión de WordPress desde wordpress.org.

• Extrae el archivo ZIP en tu ordenador.

• Sube todos los archivos extraídos a tu servidor mediante FTP, sobrescribiendo los existentes.

• Omite la wp-content para proteger tus temas, plugins y archivos subidos.

• Abra yoursite.com/wp-admin/upgrade.php en su navegador para iniciar el paso de actualización de la base de datos.

Los equipos que se encargan del mantenimiento de WordPress realizan habitualmente actualizaciones manuales del núcleo y pueden completar este proceso de forma segura si necesita ayuda.

Compruebe los permisos de archivo y la configuración de alojamiento

Los permisos de archivo incorrectos pueden impedir que WordPress elimine automáticamente el .maintenance después de futuras actualizaciones.

Los permisos estándar de WordPress son:

• Carpetas: 755
• Archivos: 644

Comprueba estos parámetros en el administrador de archivos de tu hosting o mediante FTP. Además, solicita a tu proveedor de hosting que verifique que los max_execution_time y upload_max_filesize estén configurados correctamente para las actualizaciones de WordPress.

Si los problemas de configuración del servidor impiden que se completen las actualizaciones, en reparación de WordPress pueden auditar el entorno de su servidor y corregir la configuración.

Utilice WP CLI para desactivar el modo de mantenimiento

Si tienes acceso SSH a tu servidor, WP CLI ofrece la solución más rápida.

Ejecute este comando para desactivar directamente el modo de mantenimiento:

wp maintenance-mode desactivar

O bien, elimine el archivo manualmente a través de la línea de comandos:

rm /ruta/a/tu/archivo/wordpress/.maintenance

WP CLI evita por completo el navegador. Es ideal para entornos de servidor donde los administradores de archivos no están disponibles o no son prácticos.

Restaure la copia de seguridad del sitio web si el error persiste

Si todas las demás soluciones han fallado, restaurar una copia de seguridad reciente devuelve el sitio a un estado de funcionamiento conocido. Esto siempre es más rápido que depurar una instalación con graves problemas.

Utiliza la herramienta de restauración de copias de seguridad integrada de tu proveedor de alojamiento o un complemento de copia de seguridad como UpdraftPlus para restaurar el sitio. Tras la restauración, consulta una lista de verificación para la reconstrucción del sitio web y confirma que todos los componentes, la base de datos, los archivos multimedia, los temas y los complementos estén intactos.

Por eso, realizar copias de seguridad diarias automatizadas es fundamental. Una copia de seguridad es la mejor herramienta de recuperación.

¿Cómo eliminar el archivo .maintenance en WordPress?

Existen tres métodos para eliminar el .maintenance . Elija el que corresponda a su nivel de acceso.

Uso del administrador de archivos de cPanel:

• Inicia sesión en el panel de control de tu alojamiento web y abre el Administrador de archivos.
• Navegue hasta el directorio raíz de su sitio WordPress.
• Haz clic en Configuración (arriba a la derecha) y habilita la opción Mostrar archivos ocultos.
• Encuentra el .maintenance archivo
• Haz clic con el botón derecho y selecciona Eliminar.
• Recarga tu sitio web.

Uso de FTP con FileZilla:

• Abre FileZilla y conéctate a tu servidor usando tus credenciales FTP.
• Navegue hasta la carpeta raíz de WordPress en el servidor remoto.
• Ve a Servidor → Forzar mostrar archivos ocultos en el menú.
• Busque el .maintenance en la lista de archivos.
• Haz clic con el botón derecho y selecciona Eliminar.

Usando WP CLI:

Si tienes acceso SSH, ejecuta:

rm /ruta/a/wordpress/.maintenance

El .maintenance siempre comienza con un punto. La mayoría de los exploradores de archivos ocultan los archivos ocultos por defecto; active siempre la opción "Mostrar archivos ocultos" antes de buscarlos. Esta misma navegación de archivos ocultos se utiliza para solucionar problemas de carga del creador de páginas que requieren acceso FTP directo a los archivos.

¿Cómo solucionar los conflictos entre plugins y temas que provocan el error de modo de mantenimiento?

Los conflictos entre plugins, o entre un plugin y un tema, son algunas de las causas más comunes de un estado de mantenimiento bloqueado. El enfoque es el mismo en ambos casos: aislar e identificar el componente conflictivo.

Aislar un conflicto de complementos:

• cambia el nombre de toda de plugins mediante FTP.
• Acceda a su sitio. Si carga, cambie el nombre de la carpeta a plugins.
• Reactive cada complemento individualmente.
• Ejecuta una pequeña actualización después de cada activación y observa si aparece algún error.
• El plugin que activa la pantalla de mantenimiento es el que está causando el conflicto.

Aislar un conflicto temático:

• Cambia el nombre de la carpeta de tu tema activo mediante FTP.
• WordPress recurrirá al tema predeterminado instalado.
• Vuelve a ejecutar la actualización.
• Si la actualización se completa correctamente, el problema reside en el tema activo.

Si editaste recientemente los archivos de tu tema con el editor de temas de WordPress, deshaz los cambios y vuelve a probar. El código personalizado añadido directamente a los archivos del tema puede introducir errores de sintaxis que impiden la actualización.

Siempre prueba las actualizaciones en un entorno de prueba antes de aplicarlas a tu entorno de producción. Un entorno de prueba es la forma más fiable de detectar conflictos sin que los visitantes sufran interrupciones en el servicio.

¿Cómo evitar en el futuro el error "Temporalmente no disponible debido a mantenimiento"?

Unos pocos hábitos constantes eliminan la mayoría de los errores relacionados con las actualizaciones antes de que se produzcan.

• Realiza auditorías periódicas de tu sitio web. Una auditoría exhaustiva de WordPress permite identificar plugins obsoletos, componentes incompatibles y problemas de configuración del servidor antes de que causen inconvenientes durante las actualizaciones. Realizar auditorías trimestrales es una buena práctica para la mayoría de los sitios.

• Actualiza un elemento a la vez. Evita seleccionar todos los plugins y realizar una actualización masiva. Actualiza primero el núcleo, luego los temas y, por último, los plugins, de forma individual y secuencial. Esto limita la cantidad de procesos simultáneos que se ejecutan en tu servidor.

• Utilice un entorno de prueba. Aplique cada actualización primero a un sitio de prueba. Una copia de prueba reproduce su sitio web en producción sin poner en riesgo a los usuarios reales. Solo implemente las actualizaciones en producción después de confirmar que funcionan correctamente en el entorno de prueba.

• Realiza copias de seguridad automáticas y actualizadas. Configura tu plugin de copias de seguridad o tu plataforma de alojamiento para que ejecute copias de seguridad automáticas diarias. Almacena copias fuera del servidor, ya sea en la nube o en una ubicación remota. Una copia de seguridad de ayer es mucho mejor que ninguna.

• Supervisa los límites de memoria y ejecución de PHP. Revisa esta configuración en tu panel de control de hosting después de cualquier migración de servidor o cambio de plan. Los límites bajos suelen estar asociados a planes de hosting económicos o básicos y son fáciles de pasar por alto.

• Elige una infraestructura diseñada para WordPress. Proteger tu sitio WordPress comienza con el entorno de servidor adecuado. Un servicio de alojamiento WordPress administrado configura los límites de memoria y tiempo de ejecución, y gestiona las actualizaciones específicamente para dar soporte a WordPress, reduciendo significativamente los fallos de actualización.

Errores comunes en el modo de mantenimiento de WordPress que debes evitar

Incluso los desarrolladores con años de experiencia en WordPress cometen estos errores. Evitarlos reduce considerablemente los errores en el modo de mantenimiento.

• Omitir las copias de seguridad antes de las actualizaciones. Este es el hábito más peligroso. Si una actualización principal falla sin una copia de seguridad, restaurar el sitio requiere reconstruirlo desde cero. Siempre haga una copia de seguridad primero, sin excepciones.

• Actualizar sitios web en producción sin un entorno de prueba. Realizar actualizaciones en tu sitio web de producción expone a los visitantes reales a tiempos de inactividad. Utiliza un sitio de prueba para cada actualización importante.

• Ignorar los registros de cambios de los complementos. Las entradas de los registros de cambios documentan cambios incompatibles, funciones obsoletas y conflictos conocidos. Una lectura de dos minutos antes de actualizar puede ahorrar horas de resolución de problemas.

• Instalar demasiados complementos. Cada complemento adicional aumenta la frecuencia de las actualizaciones y la probabilidad de conflictos. Revisa tus complementos al menos dos veces al año. Elimina todo lo que ya no uses.

• Usar plugins y temas pirateados o no autorizados. El software pirateado carece de mecanismos de actualización legítimos, suele contener malware y puede dañar tu sitio web durante los procesos de mantenimiento rutinarios. El ahorro no compensa el riesgo.

• No comprobar la memoria PHP antes de realizar actualizaciones importantes. Ejecutar una actualización del núcleo de WordPress con solo 64 MB de memoria PHP disponible puede provocar un error de tiempo de espera. Compruebe el límite en wp-config.php o en su panel de control de hosting antes de cualquier actualización importante.

• Cerrar el navegador durante una actualización. La actualización se ejecuta en el servidor, pero si abandonas el sitio o pierdes la conexión antes de que finalice el proceso, se pueden interrumpir los pasos finales de limpieza. Espera siempre el mensaje de confirmación.

Conclusión

El error "Temporalmente no disponible por mantenimiento" en WordPress es alarmante, pero rara vez catastrófico. En la gran mayoría de los casos, .maintenance basta con eliminar el archivo

Comprender la causa del error (actualizaciones fallidas, tiempos de espera del servidor, conflictos de plugins o poca memoria) te permitirá evitar que se repita. Realiza copias de seguridad, actualiza un plugin a la vez y utiliza un entorno de prueba antes de modificar tu sitio web en producción.

Si el error persiste o su sitio web sufre daños más graves debido a una actualización fallida, trabajar con un consultor de seguridad de WordPress o un equipo de mantenimiento profesional le proporcionará una configuración limpia y estable que gestionará las futuras actualizaciones sin incidentes.

Preguntas frecuentes sobre el error "Temporalmente no disponible debido a mantenimiento"