Solucionar error maintenance WordPress

Entendiendo el error maintenance WordPress

El famoso mensaje «Briefly unavailable for scheduled maintenance. Check back in a minute» es, en el fondo, un mecanismo de defensa. Cuando WordPress actualiza su núcleo, un tema o un plugin, genera un archivo temporal: .maintenance. Este archivo le dice al servidor: «ocupado, no molestar». Evita así que los usuarios entren en una web a medio hacer mientras se escriben nuevos archivos en la base de datos y el sistema.

El problema es real cuando el proceso se tira. Si la conexión se corta o el script supera el tiempo límite (timeout), WordPress no borra ese archivo. Resultado: tu web queda bloqueada indefinidamente en ese estado. Parece un desastre, pero suele ser tan simple como quitar un solo archivo. Aquí te explico cómo salir del paso.

Método 1: Eliminar el archivo .maintenance vía FTP

Es la solución más directa. No necesitas entrar al panel de administración (que está bloqueado) ni tocar configuraciones raras. Solo hay que quitar el candado.

Necesitarás un cliente FTP como FileZilla o el administrador de archivos de tu hosting (cPanel, Plesk, etc.). Sigue estos pasos:

1. Conéctate al servidor: Usa tus credenciales FTP y ve a la raíz de tu instalación. Suele ser public_html o www, aunque si tienes WordPress en un subdirectorio tendrás que bajar un nivel más.
2. Encuentra el archivo oculto: Busca .maintenance. Fíjate que empieza con un punto, lo que en Unix/Linux significa archivo oculto. Si no lo ves, activa la opción «Mostrar archivos ocultos» en tu cliente.
3. Bórralo: Clic derecho, eliminar. No hace falta abrirlo ni editarlo. Al borrarlo, le avisas a WordPress que el mantenimiento ha terminado.
4. Comprueba: Recarga la web. En el 99% de los casos, debería volver a la vida inmediatamente. WordPress detecta que falta el archivo y vuelve a servir el contenido normal.

Método 2: Forzar la desactivación del modo mantenimiento

A veces, borrar el archivo no basta. Puede haber conflictos de seguridad o una caché persistente que nos la juega. Si eso pasa, hay que tocar el archivo de configuración principal para obligar a WordPress a ignorar el estado de mantenimiento.

Vamos a editar wp-config.php. Es un archivo sensible. Haz copia de seguridad antes de tocar nada.

1. Localiza el archivo: En la raíz (donde ves /wp-content y /wp-admin), busca wp-config.php.
2. Descarga y edita: Bájalo a tu ordenador y ábrelo con un editor de texto plano (Notepad++, VS Code). Nada de Word, que nos meterá código basura.
3. Inserta el código: Busca la línea /* That's all, stop editing! Happy publishing. */. Justo antes, añade esto:

define('WP_AUTO_UPDATE_CORE', false);

Para desbloquear el sitio específicamente, añade también estas líneas de depuración desactivadas (aunque la clave es la siguiente):

define('WP_DEBUG', false);
define('WP_DEBUG_LOG', false);
define('WP_DEBUG_DISPLAY', false);

Pero lo que realmente nos suele salvar en este error es forzar al sistema a no buscar el mantenimiento con:

define('WP_REPAIRING', true);

En cualquier caso, la solución más común si lo anterior falla es simplemente añadir esta línea antes del comentario de «stop editing»:

define('WP_AUTO_UPDATE_CORE', false);

Método 3: Solución vía archivo functions.php (para usuarios avanzados)

¿No tienes acceso FTP o tienes problemas de permisos? Hay otra vía. Consiste en limpiar la opción de mantenimiento directamente desde la base de datos o mediante una función. Vamos con la opción de functions.php, que es menos agresiva.

El truco es meter un pequeño fragmento de código en el archivo functions.php de tu tema activo para limpiar esa opción automáticamente.

1. Accede a tus temas: Ve a /wp-content/themes/tu-tema-activo/.
2. Edita functions.php: Abre el archivo.
3. Añade el código: Pega esto al final del archivo:

// Forzar la finalización del modo de mantenimiento
delete_option( 'wp_maintenance' );

4. Guarda y comprueba: Recarga tu sitio. En cuanto funcione, vuelve al archivo y borra esas líneas. Es crucial. Si las dejas, el código se ejecutará en cada carga y eso ralentiza la web innecesariamente.

Prevenir futuros bloqueos de mantenimiento

Saber arreglarlo es bueno. Prevenirlo es mejor. La mayoría de estos errores vienen de cortes en la conexión mientras se actualiza.

• Backup a mano: Antes de una actualización grande, haz una copia de seguridad completa. Si algo salta mal, restauras y listo.
• Tiempos de PHP: Revisa tu max_execution_time en php.ini. Si es bajo (menos de 300 segundos), el proceso se cortará por timeout. Dále un poco más de margen.
• Paso a paso: No actualices 20 plugins de golpe. Hazlo de uno en uno. Así sabes exactamente cuál es el culpable si algo falla.
• Controla las automáticas: Deja que WordPress actualice solo versiones menores (seguridad). Las mayores, que cambian funcionalidades, hazlas a mano tú, presente para cualquier imprevisto.

Conclusión

Ver el mensaje de Briefly unavailable for scheduled maintenance pone los pelos de punta, más si la web es tu medio de vida. Pero, como ves, es un susto pasajero. Borrando el archivo .maintenance o ajustando el wp-config.php sueles tener el sitio arriba en minutos. Ten siempre tus datos FTP a mano y vigila la estabilidad de tu servidor. Si tras todo esto el problema sigue, puede que haya algo más profundo: un conflicto de servidor o corrupción en la base de datos.

En RedServicio (redservicio.net) sabemos que cada minuto de inactividad te cuesta dinero. Si no te ves capaz de hacer estos cambios o si el error se resiste, nuestro equipo está aquí. Somos especialistas en WordPress y administración de servidores. No dejes que un error técnico pare tu proyecto; cuéntanos qué pasa y recuperamos el control de tu infraestructura.