En esta página: [esconder]
WordPress se recuperará automáticamente de este error exactamente después 10 minutos. La mayoría de los propietarios de sitios lo descubren por las malas., después de entrar en pánico durante los primeros nueve. La solución más rápida es manual.: elimine el archivo .maintenance en la carpeta raíz de su sitio. No es necesario esperar.
respuesta rapida: Encuentra el .archivo de mantenimiento en su carpeta raíz de WordPress y elimínelo. Usar FTP, su administrador de archivos de alojamiento, o un comando WP-CLI si tiene acceso a terminal. El sitio vuelve en cuanto desaparece el archivo.
Última revisión: abril 2026. Métodos verificados contra WordPress 6.8+ y probado en cPanel, Plesk, hPanel, y administrador directo.
¿Qué está pasando realmente? (Y por qué no es realmente un error)
WordPress suelta un archivo oculto llamado .mantenimiento en la carpeta raíz de su sitio cada vez que actualiza el núcleo, un complemento, o un tema. Ábrelo en un editor de texto y verás exactamente una línea de PHP.: <?php $actualizando = 1714208400;. Ese número es la marca de tiempo de Unix de cuando comenzó la actualización.. WordPress lo lee en cada carga de página para decidir si publicar su sitio o el mensaje de mantenimiento.. Mientras el archivo está activo, cada solicitud devuelve HTTP 503 (Servicio no disponible), Es por eso que el rastreador de Google y la mayoría de los monitores de tiempo de actividad manejan el error con elegancia sin marcar su sitio como inactivo..
En condiciones normales, el archivo dura entre cinco y quince segundos. WordPress lo escribe en el momento en que comienza una actualización y lo elimina cuando finalizan las segundas actualizaciones.. Probablemente nunca lo veas.
Aquí está la parte que la mayoría de las guías de reparación omiten: El núcleo de WordPress verifica esa marca de tiempo en cada carga de página y automáticamente omite el mensaje de mantenimiento si es más de 10 minutos de edad. El sitio se recupera por sí solo al cabo de 10 minutos., incluso si el archivo todavía existe. La verificación exacta se encuentra en wp_is_maintenance_mode() función, y la constante está codificada. Entonces, si llegó aquí a los pocos minutos de que apareciera el error, eliminar el archivo es el camino más rápido para volver a estar en línea. Si ha pasado una hora y todavía estás estancado, algo más está mal: una capa de almacenamiento en caché, Borde CDN, o el caché del navegador probablemente esté entregando la página de mantenimiento desde el almacenamiento. Bórrelos antes de comenzar a tocar archivos.
Pero las actualizaciones fallan. Mucho. La pestaña del navegador se cierra durante la actualización. El tiempo de espera del servidor en un host compartido lento. tu golpeas “Actualizar todo” con 14 complementos en cola, y uno de ellos arroja un error fatal de PHP. Se escribe el archivo .maintenance, la actualización se rompe, y nada nunca lo limpia. El sitio permanece fuera de línea (o parcialmente fuera de línea) hasta que elimines el archivo tú mismo.
Desencadenantes comunes en informes del mundo real
- Actualización masiva de varios complementos o temas a la vez en alojamiento compartido
- Cerrar el navegador o perder la conexión a Internet durante la actualización
- Un complemento con un error fatal de PHP que detiene la secuencia de actualización
- Tiempos de espera del servidor en hosts con límites de tiempo de ejecución estrictos (a menudo 30 segundos o menos)
- Quedarse sin espacio en disco o memoria PHP durante la actualización
- Las actualizaciones automáticas se activan mientras ya hay otra actualización en progreso
Si llegaste aquí desde uno de estos escenarios, la solución real tarda aproximadamente 60 segundos. Elija el método a continuación que coincida con el acceso que tiene.
Método 1: Eliminar el archivo .maintenance usando FTP
La mayoría de las correcciones ocurren aquí. FTP funciona en todos los hosts, ya sea que tenga acceso de shell, acceso al tablero, o ninguno. Solo necesita un cliente FTP y las credenciales que su anfitrión le envió por correo electrónico cuando se registró.
Lo que necesitarás
- Un cliente FTP (FileZilla, Cyberduck, o WinSCP todos funcionan)
- Sus credenciales FTP/SFTP de alojamiento (anfitrión, nombre de usuario, contraseña, Puerto)
- unos dos minutos (less if your FTP client is already open, which it should be for any WordPress site you actually run)
The steps
- Open your FTP client and connect to your site. Most modern hosts use SFTP on port 22, not classic FTP on port 21. Check your hosting welcome email if you’re not sure.
- Navigate to your WordPress root directory. This is the folder containing wp-config.php, wp-admin, wp-content, y wp-incluye. On most shared hosts it’s called public_html or www.
- Look for a file named .maintenance. Files starting with a dot are hidden by default. In FileZilla, hacer clic Servidor, then Force Showing Hidden Files. In Cyberduck, press Cmd+Shift+R (Mac) or Ctrl+Shift+R (Ventanas).
- Right-click the .maintenance file and select Eliminar.
- Refresh your site in a new browser tab. It should load normally.
Don’t see the file at all? Your site might have already cleared it but cached the maintenance page. Borre la memoria caché de su navegador y la salida almacenada de cualquier complemento de almacenamiento en caché, luego actualizar.
Método 2: Utilice su administrador de archivos de hosting
No hay cliente FTP instalado? La mayoría de los paneles de control de hosting te permiten eliminar archivos directamente desde el navegador.. La ruta exacta varía según el panel., así es como funciona en los cuatro más comunes.
cPanel
- Iniciar sesión en cPanel
- Abierto Administrador de archivos
- Haga clic en Configuración (arriba a la derecha), garrapata Mostrar archivos ocultos (archivos de puntos), luego guardar
- Navegar a public_html
- Haga clic derecho en .maintenance y elija Eliminar
Plesk
- Iniciar sesión en Plesk
- Hacer clic Archivos en la barra lateral izquierda
- Abrir httpdocs (o la raíz del documento para su dominio)
- Haga clic en el ícono de ajustes y habilite Mostrar archivos ocultos
- Seleccione .maintenance y haga clic en Eliminar
hPanel (Hostinger)
- Iniciar sesión en hPanel
- Abierto Administrador de archivos
- Toggle Mostrar archivos ocultos en la configuración
- Navegar a public_html
- Haga clic derecho en .maintenance y elija Eliminar
DirectAdmin
- Inicie sesión en DirectAdmin
- Abierto Administrador de archivos en Información del sistema & Archivos
- Habilite Mostrar archivos ocultos en la barra de herramientas
- Navegar a public_html
- Marque .maintenance y haga clic en Eliminar
El archivo en sí es idéntico en todos los paneles.. Mismo PHP de una línea, el mismo puñado de bytes. Simplemente lo estás buscando en cuatro interfaces diferentes.. Cualquiera que sea el panel que utilices, el resultado es el mismo: archivo desaparecido, sitio atrás.
Método 3: Un comando WP-CLI (Para desarrolladores)
Acceso SSH más WP-CLI instalado? Esta es la solución más rápida en la página.. SSH en, cambie a su directorio de WordPress, y correr:
Desactivar el modo de mantenimiento de wp
ya verás “Éxito: Modo de mantenimiento desactivado.” Ese es todo el procedimiento.. El archivo .maintenance se elimina y su sitio vuelve a estar en línea.
El comando wp Maintenance-mode incluido con WP-CLI 2.6, entonces cualquier instalación actual lo admite. Si obtienes un “comando no encontrado” mensaje, Su host probablemente no haya instalado WP-CLI globalmente. Método de uso 1 o 2 en lugar.
Kinsta, WP Engine, Cohete.net, y Pressable todos se envían con WP-CLI preinstalado y lo exponen a través de su terminal de tablero o panel de herramientas. No se requieren claves SSH. Otros proveedores en nuestro alojamiento de WordPress administrado EE. UU. el rodeo se comporta de la misma manera. Si estás pagando por WordPress administrado, esta solución de 30 segundos es la razón real.
Método 4: SSH sin WP-CLI
Obtuve acceso SSH pero no WP-CLI? Dos comandos lo manejan:
cd /ruta/a/tu/wordpress
rm .mantenimiento
Esa es toda la solución. La ruta se parece a /home/username/public_html en hosts estilo cPanel y /var/www/html o /var/www/yoursite.com en la mayoría de las configuraciones de VPS..
La mayoría de los hosts compartidos desactivan SSH de forma predeterminada. Si tu terminal regresa “Conexión rechazada” o “Permiso denegado,” su plan de hosting no incluye acceso shell. O solicitarlo al soporte (algunos hosts lo habilitan bajo demanda) o volver al método 1 o 2.
Si rm informa que el archivo no existe, correr ls -la y comprobar lo que realmente hay ahí. A veces el archivo aparece con un nombre ligeramente modificado. (como .mantenimiento.viejo) de un intento anterior medio exitoso. Delete whichever variant you find.
When the .maintenance File Keeps Coming Back
Here’s an annoying scenario: you delete the file, refrescar, the site loads, you celebrate, y 15 seconds later the error returns.
This means an automatic update is still running in the background, repeatedly creating the file. Or a stuck cron job is firing the same broken update every minute.
Three things to check:
- Disable WordPress auto-updates temporarily by adding this line to wp-config.php: definir(‘AUTOMATIC_UPDATER_DISABLED’, cierto);
- Check wp-content for a .maintenance file there too. It’s less common, but it does happen.
- Correr wp cron event list and look for anything firing every minute or every five minutes. Disable suspicious events with wp cron event delete.
Seeing PHP errors in the maintenance message itself, or in wp-content/debug.log? That’s a different problem. Una actualización del complemento probablemente rompió algo. Deberá desactivar el complemento infractor cambiando el nombre de su carpeta en wp-content/plugins, luego actualícelo manualmente a través del panel una vez que se cargue el sitio.
Cómo evitar que este error vuelva a ocurrir
La solución en sí es fácil. Evitar la situación en primer lugar es más útil..
Actualiza una cosa a la vez
WordPress te permite seleccionar 30 complementos y haga clic en Actualizar. No. Si alguno de ellos arroja un error fatal o realiza una consulta lenta a la base de datos, todo el lote falla y el archivo .maintenance permanece. Actualizar complementos uno por uno, actualizar entre cada, y rara vez volverás a ver este error.
Ejecute actualizaciones desde el escritorio, no móvil
Tiempo de espera de los navegadores móviles, cambiar de pestaña, y perder la conexión más a menudo. Si WordPress finaliza el proceso de actualización antes de que finalice, el archivo .maintenance permanece puesto. Utilice un navegador de escritorio en una conexión estable. consejo aburrido. Ahorra verdaderos dolores de cabeza.
Hacer una copia de seguridad antes de actualizar
No prevenir directamente el error, pero hace el siguiente 20 Minutos mucho más tranquilos cuando una actualización rompe algo.. UpdraftPlus, Bóveda de blogs, y BackWPup se ejecutan en niveles gratuitos. O utilice la copia de seguridad automática diaria de su proveedor de alojamiento, si la tiene.. Restaurar desde la última instantánea buena si la reparación lleva más tiempo que la reversión.
Elija hosting que maneje bien las actualizaciones
Los hosts baratos causan este error con más frecuencia que los hosts de WordPress administrados, y la razón es un número: tiempo_max_ejecución. Los planes de presupuesto compartido generalmente tienen por defecto 30 segundos. El nivel medio compartido se encuentra alrededor 60. Los hosts de WordPress administrados como Kinsta y WP Engine se entregan con 300. La diferencia importa cuando actualiza un complemento que ejecuta una migración de base de datos: 30 los segundos fallan regularmente a la mitad, 300 termina cómodamente. Si el error sigue apareciendo semana tras semana, el anfitrión es el problema, no WordPress. Nuestro comparación de alojamiento compartido marca los proveedores con límites PHP razonables.
Los sitios más grandes superan por completo los planes compartidos. UNA VPS de WordPress te brinda recursos dedicados, tu propio tiempo de espera de PHP, y suficiente memoria para actualizar 20 complementos sin romperse. El mismo sitio que falla una actualización una vez a la semana en un plan compartido de USD 3 al mes a menudo se actualiza sin problemas en un VPS de USD 15 al mes..
Utilice la preparación para actualizaciones riesgosas
Un sitio de prueba es un clon de su sitio en vivo donde prueba las actualizaciones antes de enviarlas a producción.. La mayoría de los hosts administrados incluyen la preparación con un solo clic en sus planes.. Pruebe la actualización del complemento allí primero. Si rompe la puesta en escena, sabes arreglarlo antes de arriesgar la producción. Muchos Constructor de WordPress con IA Las plataformas ahora también incluyen la puesta en escena en su nivel gratuito..
Preguntas frecuentes
¿Cuánto tiempo dura? “Brevemente no disponible para mantenimiento programado” en realidad dura?
En condiciones normales, 5 a 15 segundos. WordPress writes the .maintenance file when updates begin and removes it the moment they finish. After exactly 10 minutos, WordPress auto-bypasses the message even if the file is still there, since core treats anything older as a failed update. Still stuck past 10 minutos? It’s almost always a caching layer holding the old response. Clear cache first, then delete the file manually if needed.
Where is the .maintenance file located?
Always in your WordPress root directory, alongside wp-config.php and the wp-admin folder. On most shared hosts that’s public_html or www. On VPS setups it’s usually /var/www/html or /var/www/yoursite.com. The file is hidden because it starts with a dot, so enable “Mostrar archivos ocultos” in your FTP client or File Manager before you go looking.
Can I bypass the maintenance message without deleting the file?
tipo de. Agregar una cadena de consulta a su URL no ayudará, ya que la verificación de mantenimiento se ejecuta en el lado del servidor. Pero si tienes acceso de administrador, navegue directamente a /wp-admin/upgrade.php y ejecute la rutina de actualización. A veces eso completa la actualización bloqueada y elimina el archivo de forma natural.. Para la mayoría de las personas, eliminar el archivo directamente es más rápido y confiable.
¿Eliminar .maintenance dañará mi sitio??
No. El archivo solo existe durante las actualizaciones.. Eliminarlo evita que WordPress muestre la página de mantenimiento. Pero si la actualización real estuvo incompleta, su verdadero problema es el complemento o tema roto que activó el tiempo de espera. Verifique su sitio después de la eliminación. Si ve un error diferente, como una pantalla blanca o un error fatal de PHP, la actualización nunca terminó. Deberá deshacer el complemento infractor manualmente o actualizarlo nuevamente desde un estado limpio..
¿Por qué sucede esto en algunos sitios y nunca en otros??
Dos factores lo deciden: ¿Cuántos complementos actualizas a la vez?, y qué tan generoso es el tiempo de espera de PHP de su host. un sitio con 5 Los complementos en un host administrado con un tiempo de espera de 300 segundos casi nunca generan este error.. un sitio con 40 los complementos en un host compartido económico con un tiempo de espera de 30 segundos lo afectan constantemente. Si moviste hosts y el problema desapareció, fue el viejo anfitrión todo el tiempo.
¿Este error afecta al SEO??
Si dura menos 10 minutos, No. El rastreador de Google vuelve a intentar páginas que responden con HTTP 503 (que es lo que envía WordPress durante el mantenimiento), y unos minutos de inactividad no cambiarán las clasificaciones. Si el error se prolonga durante horas o días, es posible que vea una caída temporal en las páginas almacenadas en caché hasta que el rastreador regrese. Resuélvelo rápidamente y las clasificaciones se recuperarán en uno o dos días..
¿Existe algún complemento que evite este error automáticamente??
Complementos como WP Maintenance Mode y Maintenance te permiten controlar la pantalla de mantenimiento, pero no previenen el problema subyacente de archivos atascados. El error ocurre antes de que se pueda ejecutar cualquier complemento., ya que WordPress busca .maintenance en la parte superior de cada solicitud. La prevención tiene que ver con el flujo de trabajo de actualización y la calidad del host, no es un complemento que instales.
Pensamientos finales
“Brevemente no disponible para mantenimiento programado” es el mensaje de error más engañoso en WordPress. No hay programación. No hay mantenimiento. Hay un archivo PHP de una línea que debería haberse eliminado tres milisegundos después de finalizar la actualización., y un temporizador de 10 minutos que el núcleo usa para salir de todos modos. Una vez que entiendas eso, arreglarlo es un trabajo de 60 segundos.
Ocurrencia única? Elimina el archivo y continúa con tu día.. Verlo todos los martes después de las actualizaciones automáticas.? El problema está aguas arriba. El patrón es casi siempre una de tres cosas.: un único complemento que siempre se agota, un host con un límite de PHP de 30 segundos no aumentará, o un programa de actualización automática que se ejecuta mientras los usuarios todavía están en el sitio.
Para sitios donde el tiempo de actividad es el producto real, un servidor que gestiona las actualizaciones de forma segura recupera la diferencia de precio en unos meses. Una vez que esta solución haya quedado atrás, nuestro guía gratuita de migración de WordPress explica cómo mudarse a un host con tiempos de espera de PHP adecuados y WP-CLI preinstalado sin perder un solo visitante en el proceso.