Actualizar WordPress: Solución a errores de actualización

¡Hola! Soy tu técnico de soporte de confianza. Sé que ver un error en WordPress puede ser frustrante, sobre todo cuando intentas actualizar el núcleo, un plugin o un tema y todo se detiene en seco. No te preocupes, hoy vamos a arreglarlo juntos.

En esta guía extensa y práctica, vamos a desglosar los tres grandes villanos de las actualizaciones: el famoso modo de mantenimiento, los problemas de conexión por FTP y los molestos errores de permisos de archivos. Al final, tendrás un plan de acción claro para resolver cualquier error actualización wordpress que se te cruce.

Vamos a ello, paso a paso y sin tecnicismos raros.

¿Por qué falla la actualización de WordPress? El diagnóstico inicial

Antes de lanzarnos a tocar archivos, es clave entender qué está pasando. Cuando intentas actualizar wordpress falla, normalmente es por una de estas tres razones:

El modo de mantenimiento: WordPress crea un archivo temporal llamado .maintenance para avisar al sistema que está en obras. Si ese archivo se queda atascado, tu web se queda en modo "mantenimiento" para siempre.
Permisos de archivos incorrectos: Son las reglas que deciden quién puede leer, escribir o ejecutar los archivos de tu servidor. Si están mal configurados, WordPress no puede sobrescribir los archivos antiguos con los nuevos.
Fallo de conexión FTP/SFTP: A veces, el propio WordPress (o el panel de control) intenta conectarse a tu servidor para hacer la actualización, pero la configuración de conexión no es la correcta o el servidor lo bloquea.

Vamos a atacar cada uno de estos puntos con soluciones concretas y fáciles de aplicar.

Solución 1: Desbloquear el Modo de Mantenimiento (El archivo `.maintenance`)

Este es el error más común y el más fácil de solucionar. Es como si WordPress hubiera cerrado la puerta de la tienda y se hubiera olvidado la llave dentro.

¿Cómo sé si estoy atascado en mantenimiento?

Es sencillo. Si intentas entrar a tu web y solo ves un mensaje que dice "Briefly unavailable for scheduled maintenance. Check back in a minute." (No disponible brevemente por mantenimiento programado), estás atascado.

Paso 1: Accede a tu hosting mediante FTP o el Administrador de Archivos

Para esto necesitas un cliente FTP (como FileZilla) o, mejor aún, el Administrador de Archivos de tu panel de control.

Si usas cPanel, busca la sección "Archivos" y haz clic en "Administrador de Archivos".
Si tu hosting usa Syspanel (antes conocido como HestiaCP), recuerda que el acceso es a través del puerto 2106 (ej: https://tudominio.com:2106). Dentro de Syspanel, busca el apartado de "Administrador de Archivos".

Paso 2: Localiza y elimina el archivo `.maintenance`

Una vez dentro del administrador de archivos, navega hasta la carpeta raíz de tu WordPress (normalmente se llama public_html, htdocs o el nombre de tu dominio).

Busca el archivo llamado .maintenance. Es un archivo oculto, así que asegúrate de tener activada la opción de "Mostrar archivos ocultos" en tu visor de archivos.
Haz clic derecho sobre él y selecciona Eliminar.

Paso 3: Recarga tu web

¡Listo! Recarga tu sitio web. Debería volver a la normalidad al instante.

[TIP] Si no encuentras el archivo .maintenance, créalo tú mismo. Crea un archivo de texto vacío llamado .maintenance en la raíz y luego bórralo. Esto fuerza a WordPress a resetear el estado de mantenimiento.

Solución 2: Corregir los Permisos de Archivos y Carpetas

Si el problema persiste, es muy probable que los permisos estén mal. Piénsalo como las cerraduras de tu casa: si las llaves no coinciden con las cerraduras, no puedes abrir la puerta.

Cuando actualizar wordpress falla por permisos, el error suele ser algo como "Could not create directory" (No se pudo crear el directorio) o "Unable to write to file" (No se pudo escribir en el archivo).

¿Cuáles son los permisos correctos?

La regla de oro es la siguiente:

Carpetas (Directorios): Deben tener permiso 755.
Archivos: Deben tener permiso 644.

Esto significa que el propietario puede leer y escribir (y ejecutar en el caso de carpetas), mientras que el grupo y el resto del mundo solo pueden leer.

Paso 1: Cambiar permisos de forma masiva

No es práctico cambiar archivo por archivo. La mayoría de los clientes FTP y administradores de archivos permiten cambiar permisos de forma masiva.

Con FileZilla: Selecciona todos los archivos y carpetas (Ctrl+A). Haz clic derecho y selecciona "Permisos de archivo...". Marca la casilla de "Recurse into subdirectories" (Recursivo en subdirectorios) y selecciona "Apply to files only" (Aplicar solo a archivos). Pon el valor 644.
Con el Administrador de Archivos (cPanel/Syspanel): Selecciona todo, haz clic en "Permisos" o "Change Permissions". Aplica el valor 644 para archivos y 755 para carpetas por separado.

Paso 2: Cambiar permisos de las carpetas

Repite el proceso, pero esta vez selecciona "Apply to directories only" (Aplicar solo a directorios) con el valor 755.

[WARNING] ¡CUIDADO! No pongas permisos 777 (lectura, escritura y ejecución para todos). Aunque a veces "funciona", es un agujero de seguridad enorme que permite que cualquiera pueda modificar tu web. Es como dejar la puerta de tu casa abierta de par en par.

Paso 3: El propietario de los archivos (Opcional pero importante)

A veces los permisos están bien, pero el propietario de los archivos es incorrecto. Normalmente, el usuario del FTP debe ser el mismo que el usuario del servidor web (a menudo www-data o tu nombre de usuario de cPanel).

En cPanel, ve a "Administrador de Archivos", selecciona todos los archivos y haz clic en "Cambiar propietario". Asegúrate de que el propietario sea tu usuario de cPanel.
En Syspanel, es un poco más complejo. Si los permisos están bien y el propietario parece extraño, lo mejor es contactar con tu proveedor de hosting para que lo ajuste, ya que a veces requiere acceso SSH.

Solución 3: Configurar o Desactivar la Conexión FTP

WordPress tiene dos formas principales de actualizar: usando el sistema de archivos directo del servidor o usando FTP/SFTP. A veces, la configuración de FTP está mal guardada en el archivo wp-config.php.

Paso 1: Forzar el método de conexión directa

La forma más limpia de evitar problemas de FTP es decirle a WordPress que use el sistema de archivos del servidor directamente. Esto se hace añadiendo una línea de código al archivo wp-config.php.

Accede a tu administrador de archivos y busca el archivo wp-config.php en la raíz de tu WordPress.
Ábrelo con el editor de texto (clic derecho -> Editar o "Edit").
Busca la línea que dice /* That's all, stop editing! Happy publishing. */ (Eso es todo, ¡deja de editar! Feliz publicación).
Justo antes de esa línea, pega esto:

define('FS_METHOD', 'direct');

Guarda el archivo y súbelo de nuevo (si lo editaste localmente).

Este pequeño cambio le dice a WordPress: "Oye, no te compliques con FTP, escribe directamente en el servidor". Esto resuelve el 90% de los errores de conexión.

[INFO] Si tu hosting no permite el método directo por razones de seguridad, verás un error. En ese caso, tendrás que asegurarte de que tu cliente FTP esté configurado con las credenciales correctas en wp-config.php (las constantes FTP_HOST, FTP_USER, FTP_PASS, etc.). Pero te recomiendo probar primero con el método directo.

Paso 2: Verificar la configuración FTP/SFTP en wp-config.php

Si no puedes usar el método directo, verifica que estas líneas existan y sean correctas en tu wp-config.php:

define('FTP_HOST', 'ftp.tudominio.com');
define('FTP_USER', 'tu_usuario_ftp');
define('FTP_PASS', 'tu_contraseña_ftp');

IMPORTANTE: Si tu hosting usa SFTP (puerto 22), a veces necesitas especificar el puerto:

define('FTP_HOST', 'ftp.tudominio.com:22');

Solución 4: Actualización Manual Completa (El Plan B Definitivo)

Si nada de lo anterior funciona, siempre puedes hacer la actualización "a mano". Es más seguro y te da control total. No es tan difícil como parece.

Paso 1: Descarga la última versión de WordPress

Ve a es.wordpress.org y descarga el archivo .zip de la última versión.

Paso 2: Descomprime el archivo en tu ordenador

Verás una carpeta llamada wordpress con todo el contenido.

Paso 3: Reemplaza los archivos (¡Cuidado con wp-content!)

Esta es la parte delicada. NO borres la carpeta wp-content. Ahí están tus plugins, temas y subidas.

Sube todos los archivos de la carpeta wordpress que acabas de descomprimir a la raíz de tu hosting, excepto la carpeta wp-content.
Cuando te pregunte si quieres sobrescribir los archivos existentes, haz clic en Sí / Reemplazar.
No subas la carpeta wp-content que viene en el paquete de descarga, porque sobrescribiría tus datos.

Paso 4: Actualiza la base de datos

Una vez subidos todos los archivos, visita tudominio.com/wp-admin. WordPress detectará los nuevos archivos y te pedirá que actualices la base de datos. Haz clic en "Actualizar la base de datos de WordPress" o "Actualizar" y listo.

[TIP] Este método manual también es perfecto si tu hosting no te deja subir archivos grandes o si el tiempo de ejecución de PHP es demasiado corto para actualizaciones automáticas.

Preguntas Frecuentes (FAQ) sobre Errores de Actualización

Aquí te dejo las dudas más comunes que me llegan al soporte, resueltas de forma rápida.

¿Qué hago si veo "Error: Se ha establecido una conexión con el servidor, pero no se ha recibido ninguna respuesta"?

Esto suele ser un problema de memoria PHP. Aumenta el límite de memoria en wp-config.php añadiendo esta línea:

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

¿Puedo actualizar WordPress desde cPanel o Syspanel?

No directamente. WordPress no se actualiza desde el panel de control del hosting. Se actualiza desde el escritorio de WordPress (/wp-admin) o manualmente por FTP. Lo que sí puedes hacer desde el panel es gestionar los archivos y permisos como hemos visto.

¿Debo borrar los plugins antes de actualizar?

No es necesario, pero si tienes un plugin que no está actualizado, puede dar conflictos. Una buena práctica es desactivar todos los plugins antes de una actualización importante y reactivarlos uno a uno después. Esto aísla el problema si actualizar wordpress falla por un plugin incompatible.

¿Por qué es tan importante actualizar WordPress?

Las actualizaciones no solo traen funciones nuevas, sino parches de seguridad críticos. Un WordPress desactualizado es la principal causa de hackeos. Así que, aunque a veces de pereza, es vital mantenerlo al día.

Resumen y Consejos Finales

Hemos recorrido un largo camino. Para que no te pierdas, aquí tienes tu checklist de emergencia:

Reinicia el modo mantenimiento: Busca y elimina el archivo .maintenance en la raíz.
Ajusta los permisos: Asegúrate de que las carpetas tengan 755 y los archivos 644.
Fuerza el método directo: Añade define('FS_METHOD', 'direct'); a tu wp-config.php.
Si todo falla, hazlo manual: Descarga WordPress, sube los archivos (excepto wp-content) y actualiza la base de datos.

[WARNING] Haz una copia de seguridad SIEMPRE antes de actualizar. Puedes usar un plugin como UpdraftPlus o hacer una copia manual de los archivos y la base de datos desde tu panel de control. Esto te salvará la vida si algo sale mal.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave. Si después de intentar todo esto el error actualización wordpress persiste, no dudes en contactar con tu proveedor de hosting, ya que puede haber una restricción a nivel de servidor que solo ellos pueden ajustar.

¡Nos vemos en el siguiente tutorial!