Corregir 'Briefly unavailable for scheduled maintenance' en WordPress (Fácil)

¿Acabas de intentar entrar en tu WordPress y te has encontrado con el mensaje "Briefly unavailable for scheduled maintenance. Check back in a minute"? No te preocupes, no has roto nada. Es uno de los sustos más comunes en el mundo WordPress, pero también uno de los más fáciles de arreglar.

Este aviso es, en realidad, un mecanismo de protección. WordPress lo activa automáticamente cuando está actualizando el núcleo, un plugin o un tema. Durante esos segundos, tu web se pone en "modo mantenimiento" para evitar que los visitantes vean un sitio a medio instalar. El problema surge cuando el proceso se interrumpe (por ejemplo, por un corte de conexión) y el "modo mantenimiento" se queda activado para siempre.

En esta guía completa, te voy a explicar paso a paso, y sin necesidad de ser un experto, cómo desactivar ese modo y recuperar tu web en menos de 5 minutos. Vamos a ello.

¿Qué es el archivo .maintenance y por qué causa este error?

Para entender cómo arreglarlo, primero tienes que saber qué está pasando. Cuando WordPress entra en ese estado, crea un archivo temporal llamado .maintenance en la carpeta raíz de tu instalación (la misma donde están las carpetas wp-admin, wp-content y wp-includes).

Este archivo es un simple "interruptor". Si existe, WordPress muestra el mensaje de mantenimiento. Si no existe, tu web funciona con normalidad. Por lo tanto, la solución principal es eliminar ese archivo.

Pero, ¡ojo! A veces ese archivo no es el culpable. El error también puede deberse a que el proceso de actualización se quedó "colgado" en la base de datos. Por eso, te voy a dar varias soluciones, desde la más sencilla hasta la más técnica.

Solución 1: La vía rápida (Eliminar el archivo .maintenance por FTP)

Esta es la solución más común y la que resolverá el problema en el 90% de los casos. Solo necesitas acceso al panel de control de tu hosting (cPanel, Syspanel, etc.) o un cliente FTP como FileZilla.

Paso 1: Conecta a tu servidor

Accede a tu panel de control. Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que la URL de acceso suele ser https://tu-dominio.com:2106. Introduce tus credenciales y entra.

Si prefieres usar FTP, abre FileZilla y conéctate con los datos que te proporcionó tu proveedor de hosting. Normalmente son: servidor (ej. ftp.tudominio.com), usuario y contraseña.

Paso 2: Localiza la carpeta public_html

Una vez dentro, busca la carpeta donde está instalado WordPress. En la mayoría de los casos, se llama public_html, htdocs o www. Si tienes varias webs, busca la que corresponda al dominio con el error.

Paso 3: Activa los archivos ocultos

El archivo .maintenance es un archivo oculto (empieza con un punto). En FileZilla, ve al menú Servidor > Forzar mostrar archivos ocultos. En Syspanel, busca la opción de "mostrar archivos ocultos" en el gestor de archivos.

Paso 4: Elimina el archivo

Busca el archivo .maintenance en esa carpeta raíz. Haz clic derecho sobre él y selecciona Eliminar o Borrar. No te preocupes, es un archivo temporal y no perderás nada importante.

Paso 5: Verifica tu web

Ahora, recarga tu página en el navegador (usa Ctrl+F5 para limpiar la caché). El mensaje de error debería haber desaparecido.

[TIP] Si no encuentras el archivo .maintenance, es posible que tu hosting lo haya ocultado en una subcarpeta. Prueba a buscarlo en la raíz exacta, no dentro de wp-content. Si aun así no lo ves, pasa a la siguiente solución.

Solución 2: Usar el Panel de Control (Syspanel o cPanel)

Si no te sientes cómodo con FTP, puedes hacerlo desde el gestor de archivos de tu panel de control. Es igual de fácil.

Paso 1: Accede al gestor de archivos

Entra en tu panel de control. Si usas Syspanel, accede por el puerto 2106 (ej. https://tu-dominio.com:2106). Dentro, busca la sección de Archivos o Gestor de Archivos.

Si usas cPanel, busca el icono de Administrador de archivos.

Paso 2: Navega a la raíz de WordPress

Ve a la carpeta public_html (o la que corresponda). Es importante que estés en el mismo nivel donde están las carpetas wp-admin, wp-content y wp-includes.

Paso 3: Configura para ver archivos ocultos

En la parte superior del gestor de archivos, suele haber un botón de Configuración o Ajustes. Asegúrate de que la casilla Mostrar archivos ocultos (dotfiles) esté marcada.

Paso 4: Borra el archivo

Ahora ya deberías ver el archivo .maintenance. Selecciónalo y haz clic en Eliminar o Borrar. Confirma la acción y listo.

[WARNING] Asegúrate de eliminar SOLO el archivo .maintenance. No borres ni renombres otros archivos como wp-config.php o la carpeta wp-content, o podrías dañar tu web de forma grave.

Solución 3: Si el error persiste (Actualización interrumpida en la base de datos)

A veces, eliminar el archivo no es suficiente. El error puede deberse a que la actualización de un plugin o tema se quedó a medias y la base de datos está esperando una orden. En este caso, el mensaje de mantenimiento puede reaparecer o tu web puede mostrar otros errores.

Solución 3.1: Reanudar la actualización desde el panel de administración

A veces, simplemente con eliminar el archivo, puedes acceder a tu panel wp-admin. Intenta entrar. Si lo consigues, WordPress te pedirá que completes la actualización. Sigue los pasos y todo se arreglará solo.

Solución 3.2: Desactivar plugins conflictivos

Si el error ocurre justo después de actualizar un plugin, ese plugin puede ser el culpable.

Accede por FTP o al gestor de archivos de tu panel.
Entra en la carpeta wp-content.
Dentro, busca la carpeta plugins.
No borres nada. Simplemente, cambia el nombre de la carpeta del plugin sospechoso. Por ejemplo, si el plugin se llama mi-plugin, renómbralo a mi-plugin-desactivado.
WordPress desactivará ese plugin automáticamente. Recarga tu web y mira si el error desaparece.

Si no sabes qué plugin es, renombra la carpeta plugins entera a plugins-old. Esto desactivará todos los plugins. Si tu web vuelve a funcionar, sabrás que el problema era un plugin. Luego, ve activándolos uno a uno desde el panel de administración (renombrándolos de nuevo a su nombre original) hasta encontrar al culpable.

Solución 3.3: Reinstalar el núcleo de WordPress

Si el error es del núcleo de WordPress, puedes forzar una reinstalación.

Ve a wp-admin/update-core.php (si puedes acceder).
Haz clic en Reinstalar ahora.
Si no puedes acceder al panel, descarga WordPress desde wordpress.org, descomprímelo y sube las carpetas wp-admin y wp-includes por FTP, sobrescribiendo las existentes. No subas la carpeta wp-content ni el archivo wp-config.php, o perderás tus contenidos y configuración.

Solución 4: La "última bala" (Aumentar el límite de memoria PHP)

En ocasiones, el error aparece porque el servidor se queda sin memoria durante la actualización. Aunque no es la causa más común, merece la pena probar si nada de lo anterior funciona.

Accede a tu carpeta raíz de WordPress.
Busca el archivo wp-config.php.
Ábrelo con un editor de texto (como Bloc de notas o Sublime Text).
Justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */, añade esta línea:

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

Guarda el archivo y vuelve a subirlo al servidor (si lo editaste localmente).

Esto le da a WordPress más memoria para trabajar.

Errores comunes y preguntas frecuentes (FAQ)

¿Por qué aparece este error si no estoy actualizando nada?

Puede que una actualización automática se haya disparado en segundo plano y se haya interrumpido. O que un plugin esté forzando el modo mantenimiento. También puede ser que un atacante haya creado el archivo .maintenance a propósito, aunque es poco probable.

¿Perderé mis datos si elimino el archivo .maintenance?

No. El archivo .maintenance es solo un marcador temporal. Eliminarlo no borra ni una entrada, ni una página, ni una configuración. Tus contenidos están a salvo en la base de datos y en la carpeta wp-content.

¿Puedo evitar que esto vuelva a pasar?

Sí. Las causas más comunes son las actualizaciones interrumpidas por una mala conexión a internet o por un límite de tiempo del servidor. Para evitarlo:

Actualiza siempre desde un lugar con buena conexión.
Haz copias de seguridad antes de actualizar. Puedes usar plugins como UpdraftPlus o hacerlo desde tu panel de control.
Mantén tus plugins y temas actualizados. A veces, una versión antigua es incompatible con una nueva de WordPress y causa estos fallos.

¿Qué es el "modo mantenimiento" de WordPress?

Es un estado en el que WordPress bloquea el acceso público a tu web para mostrar un mensaje temporal. Se activa automáticamente durante las actualizaciones y se desactiva al terminar. El archivo .maintenance es el que controla este estado. En inglés se le conoce como wordpress maintenance mode.

¿Y si después de todo esto sigo viendo el error?

Si has probado todas las soluciones y el error persiste, es probable que el problema esté en un nivel más profundo del servidor (por ejemplo, en la configuración de PHP o en un firewall). En ese caso, contacta con tu proveedor de hosting. Ellos tienen acceso a los logs del servidor y podrán ver exactamente qué está fallando. Diles que has eliminado el archivo .maintenance y que el error continúa.

[INFO] Recuerda que si tu hosting usa Syspanel, el acceso es por el puerto 2106. Si no sabes cómo entrar, consulta la documentación de tu proveedor o el correo de bienvenida que te enviaron al contratar el servicio.

Conclusión: Respira, es un problema menor

El error "Briefly unavailable for scheduled maintenance" es un dolor de cabeza momentáneo, pero no es una sentencia de muerte para tu web. En la mayoría de los casos, la solución es tan simple como borrar un archivo. Con esta guía, ya tienes todas las herramientas para hacerlo por ti mismo, sin depender de un técnico y en cuestión de minutos.

Resumen rápido de los pasos a seguir:

Conéctate a tu hosting (FTP o panel de control).
Busca la carpeta raíz de WordPress (normalmente public_html).
Muestra los archivos ocultos.
Elimina el archivo .maintenance.
Recarga tu web.

Si el problema persiste, repite los pasos pero desactivando los plugins o reinstalando el núcleo. Y si nada funciona, ya sabes, contacta con tu hosting. Pero te aseguro que con un poco de paciencia, tu web volverá a estar en línea en un abrir y cerrar de ojos.