Errores actualización WordPress: Soluciones rápidas

Introducción: Por qué fallan las actualizaciones de WordPress

Actualizar WordPress, sus temas y plugins es esencial para mantener la seguridad y el rendimiento de tu sitio. Sin embargo, es uno de los momentos más tempranos en los que pueden surgir problemas. Un error actualización WordPress puede dejarte con una pantalla blanca WordPress o con funcionalidades rotas. No te preocupes: la mayoría de estos fallos tienen solución y, con esta guía, podrás resolverlos paso a paso.

Si estás usando Syspanel (antes conocido como HestiaCP, accesible por el puerto 2106), también te daremos indicaciones específicas para gestionar archivos y bases de datos desde allí. Al final del artículo, encontrarás una sección de preguntas frecuentes (FAQ) que responde a las dudas más comunes sobre el WordPress update error.

1. Error de conexión a la base de datos durante la actualización

Uno de los errores comunes de actualización de WordPress es que, al intentar actualizar, aparece un mensaje como "Error al establecer conexión con la base de datos". Esto suele ocurrir porque los credenciales de la base de datos han cambiado o porque el servidor de base de datos está caído.

Causas principales:

Contraseña o usuario de la base de datos incorrectos en el archivo wp-config.php.
El servidor MySQL/MariaDB está detenido.
El nombre de la base de datos o el host son incorrectos.

Cómo solucionarlo:

Verifica el estado del servidor de base de datos desde Syspanel:
- Accede a Syspanel (puerto 2106) con tus credenciales.
- Ve a "Base de datos" y revisa que el servicio MySQL esté activo. Si está detenido, reinícialo desde el panel.
Revisa el archivo wp-config.php:
- Conéctate por FTP o desde el administrador de archivos de Syspanel.
- Abre el archivo wp-config.php en la raíz de tu instalación de WordPress.
- Busca las líneas:
```
define('DB_NAME', 'nombre_base');
define('DB_USER', 'usuario');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');
```
- Asegúrate de que coincidan exactamente con los datos que tienes en Syspanel (en "Base de datos" -> "Usuarios").
Prueba la conexión manualmente:
- Desde Syspanel, abre "phpMyAdmin" (en "Base de datos" -> "phpMyAdmin").
- Intenta iniciar sesión con el usuario y contraseña de tu base de datos. Si no puedes, restablece la contraseña desde Syspanel.

[TIP] Si cambiaste la contraseña de la base de datos, actualízala también en wp-config.php. Guarda los cambios y vuelve a intentar la actualización.

2. Pantalla blanca de la muerte (WSOD) durante la actualización

La pantalla blanca WordPress (WSOD) es uno de los errores de actualización de WordPress más temidos. Ocurre cuando un error fatal impide que WordPress cargue cualquier contenido. Puede ser por un plugin o tema incompatible, o por un error en el núcleo de WordPress.

Causas principales:

Un plugin o tema no es compatible con la nueva versión de WordPress.
Se agotó la memoria PHP disponible.
Un archivo del núcleo se corrompió durante la actualización.

Cómo solucionarlo:

Desactiva todos los plugins:
- Accede a tu servidor por FTP o desde el administrador de archivos de Syspanel.
- Ve a la carpeta wp-content/plugins y renombra la carpeta plugins a plugins_old. Esto desactivará todos los plugins.
- Vuelve a cargar tu sitio. Si funciona, el problema es de algún plugin. Ve renombrando carpetas de plugins una por una para identificar al culpable.
Cambia al tema por defecto:
- En la misma carpeta wp-content/themes, renombra la carpeta de tu tema activo (por ejemplo, mi-tema a mi-tema_old). WordPress automáticamente usará un tema por defecto como Twenty Twenty-Four.
- Si el sitio vuelve a funcionar, el problema es del tema. Actualiza el tema o contacta con su desarrollador.
Aumenta el límite de memoria PHP:
- Edita el archivo wp-config.php y añade esta línea antes de /* That's all, stop editing! */:
```
define('WP_MEMORY_LIMIT', '256M');
```
- Guarda y recarga el sitio.
Habilita el modo de depuración (debug):
- En wp-config.php, añade o modifica estas líneas:
```
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
```
- Esto creará un archivo debug.log en wp-content. Revísalo para ver el error exacto.

[WARNING] La pantalla blanca también puede deberse a un error de PHP 500. Si después de estos pasos no se soluciona, revisa los logs de error del servidor desde Syspanel (en "Logs" -> "Error log").

3. Error de "Actualización fallida" o "No se pudo descargar el archivo"

Este WordPress update error aparece cuando WordPress no puede descargar los archivos de actualización desde los servidores oficiales. Puede ser por problemas de permisos, firewall o conectividad.

Causas principales:

Los permisos de archivos y carpetas son incorrectos (por ejemplo, 777 en lugar de 755).
El servidor no puede conectar con api.wordpress.org (bloqueo de firewall o DNS).
El tiempo de ejecución de PHP es demasiado corto.

Cómo solucionarlo:

Corrige los permisos de archivos:
- Desde Syspanel, ve a "Archivos" y selecciona la raíz de tu sitio.
- Haz clic en "Permisos" y asegúrate de que:
  - Carpetas: 755
  - Archivos: 644
  - wp-config.php: 600 o 644
- También puedes ejecutar este comando por SSH (si tienes acceso):
```
find /ruta/a/tu/sitio -type d -exec chmod 755 {} \;
find /ruta/a/tu/sitio -type f -exec chmod 644 {} \;
```
Verifica la conectividad con WordPress.org:
- Desde un terminal o la consola de Syspanel, ejecuta:
```
ping api.wordpress.org
```
- Si no responde, puede que tu servidor tenga restricciones de firewall. Contacta con tu proveedor de hosting.
Aumenta el tiempo de ejecución de PHP:
- En Syspanel, ve a "Configuración" -> "PHP" y aumenta el valor de max_execution_time a 300 segundos.
- También puedes añadir esta línea en wp-config.php:
```
set_time_limit(300);
```
Usa la actualización manual:
- Descarga la última versión de WordPress desde wordpress.org.
- Extrae el contenido y sube los archivos a tu servidor (excepto wp-content y wp-config.php) mediante FTP.
- Luego, ve a /wp-admin/upgrade.php para completar la actualización de la base de datos.

[INFO] Si el error persiste, desactiva temporalmente el firewall de tu servidor (como CSF o iptables) desde Syspanel o contacta a soporte.

4. Error de "El enlace de actualización ha expirado" o timeout

Otro error actualización WordPress común es que el proceso se interrumpe por timeout, especialmente en sitios grandes con muchos plugins.

Causas principales:

El límite de memoria PHP es insuficiente.
El tiempo máximo de ejecución es muy bajo.
Hay demasiados plugins o un plugin que consume muchos recursos.

Cómo solucionarlo:

Aumenta memoria y tiempo de ejecución como en el punto anterior (límite de memoria a 256M y tiempo a 300 segundos).
Desactiva plugins temporalmente antes de actualizar:
- Desde el panel de administración (si puedes acceder) ve a Plugins y desactiva todos excepto los esenciales.
- Si no puedes acceder, usa el método de renombrar la carpeta plugins (explicado en el punto 2).
Actualiza desde un entorno de staging:
- Crea un clon de tu sitio en un subdominio o carpeta temporal.
- Realiza la actualización allí y, si todo funciona, replica los cambios en el sitio principal.

[TIP] Si tu sitio es muy grande, considera usar un plugin de actualización por lotes o contratar un servicio de hosting administrado que maneje las actualizaciones automáticamente.

5. Error de "No se pudo conectar a WordPress.org" o problemas de SSL

Este WordPress update error suele aparecer cuando el servidor no puede verificar el certificado SSL de los servidores de WordPress.

Causas principales:

La versión de PHP es muy antigua y no soporta los protocolos de seguridad modernos.
El paquete cURL no está configurado correctamente.
El servidor tiene un firewall que bloquea conexiones HTTPS.

Cómo solucionarlo:

Actualiza PHP a una versión reciente:
- Desde Syspanel, ve a "Configuración" -> "PHP" y selecciona una versión como 8.1 o 8.2. Aplica los cambios.

Verifica la configuración de cURL:

En el mismo panel de PHP, asegúrate de que la extensión curl esté habilitada.

También puedes probar con un script simple:

<?php
$ch = curl_init('https://api.wordpress.org');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if (curl_error($ch)) {
    echo 'Error cURL: ' . curl_error($ch);
} else {
    echo 'Conexión exitosa';
}
curl_close($ch);
?>

Desactiva la verificación SSL temporalmente (no recomendado a largo plazo):
- En wp-config.php, añade:
```
define('WP_HTTP_BLOCK_EXTERNAL', false);
```
- Si el problema persiste, contacta a tu proveedor de hosting.

[WARNING] No desactives la verificación SSL en producción. Es mejor solucionar la causa raíz.

6. Error de "Actualización interrumpida" y sitio en modo mantenimiento

A veces, una actualización falla y deja el sitio en modo mantenimiento (aparece un mensaje "Breve mantenimiento programado"). Esto ocurre porque el archivo .maintenance no se eliminó correctamente.

Cómo solucionarlo:

Elimina el archivo .maintenance:
- Conéctate por FTP o desde el administrador de archivos de Syspanel.
- En la raíz de tu sitio, busca el archivo .maintenance (puede estar oculto). Bórralo.
- Si no lo ves, habilita la visualización de archivos ocultos en tu cliente FTP.
Reintenta la actualización:
- Ve a /wp-admin e intenta la actualización nuevamente. Si el problema persiste, repite los pasos de solución de pantalla blanca.

[TIP] Para evitar esto en el futuro, puedes crear un backup antes de cada actualización. En Syspanel, usa la función "Backup" para generar una copia completa.

7. Error de "No se pudo escribir en el directorio" o permisos insuficientes

Este error actualización WordPress suele deberse a que el usuario del servidor web no tiene permisos de escritura en las carpetas de WordPress.

Causas principales:

Los archivos pertenecen a un usuario diferente al del servidor web.
Los permisos son demasiado restrictivos (por ejemplo, 444 en lugar de 644).

Cómo solucionarlo:

Cambia el propietario de los archivos:
- Desde Syspanel, ve a "Archivos" y selecciona la raíz del sitio.
- Usa la opción "Propietario" para cambiar a www-data o el usuario de tu servidor web (pregunta a tu hosting si no sabes cuál es).
Establece permisos correctos (como en el punto 3, pero asegurando que el usuario del servidor web tenga escritura en wp-content):
- Carpetas: 755
- Archivos: 644
- wp-content: 755 (o 775 si necesitas que el grupo escriba)
Verifica la propiedad del grupo:
- En Syspanel, puedes asignar el grupo www-data a los archivos. Esto es común en servidores Apache.

[WARNING] Nunca uses permisos 777 en producción, ya que exponen tu sitio a ataques.

8. Error de "No se pudo actualizar la base de datos"

Después de actualizar los archivos de WordPress, a veces la base de datos no se actualiza correctamente, dejando el sitio con errores.

Causas principales:

La tabla wp_options está corrupta.
El usuario de la base de datos no tiene permisos para modificar tablas.
La versión de MySQL es muy antigua.

Cómo solucionarlo:

Ejecuta manualmente la actualización de la base de datos:
- Ve a http://tusitio.com/wp-admin/upgrade.php. Si no se ejecuta automáticamente, haz clic en "Actualizar base de datos".
Repara las tablas de la base de datos:
- Desde phpMyAdmin en Syspanel, selecciona tu base de datos.
- Marca todas las tablas y en el menú desplegable elige "Reparar tabla".
Verifica los permisos del usuario de la base de datos:
- En Syspanel, ve a "Base de datos" -> "Usuarios" y asegúrate de que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, etc.).
Actualiza MySQL/MariaDB:
- Si tu versión es anterior a la 5.6, pide a tu proveedor que la actualice. WordPress requiere MySQL 5.7+ o MariaDB 10.3+.

[INFO] Si después de reparar la base de datos sigues teniendo problemas, restaura una copia de seguridad anterior desde Syspanel.

9. Error de "El plugin/tema no es compatible con esta versión de WordPress"

Este WordPress update error aparece cuando intentas actualizar un plugin o tema que no ha sido probado con la nueva versión de WordPress.

Cómo solucionarlo:

Verifica la compatibilidad:
- Antes de actualizar, revisa la página del plugin en el repositorio oficial o el sitio del desarrollador.
- Si no hay actualización, busca alternativas o ponte en contacto con el desarrollador.
Actualiza manualmente:
- Descarga la última versión compatible desde el repositorio.
- Sube los archivos por FTP, reemplazando la carpeta del plugin/tema en wp-content/plugins o wp-content/themes.
Usa un plugin de compatibilidad (como "WP Rollback") para revertir a una versión anterior si la nueva falla.

[TIP] Siempre mantén un backup de tu sitio antes de actualizar cualquier plugin o tema.

10. Preguntas frecuentes (FAQ) sobre errores de actualización de WordPress

¿Por qué mi sitio se queda en blanco después de actualizar?

La pantalla blanca WordPress suele deberse a un plugin o tema incompatible. Sigue los pasos de la sección 2 para desactivarlos y aumentar la memoria PHP.

¿Cómo puedo evitar errores en futuras actualizaciones?

Haz siempre un backup completo antes de actualizar.
Actualiza en un entorno de staging primero.
Mantén todos los plugins, temas y WordPress actualizados.
Usa un hosting que ofrezca actualizaciones automáticas seguras.

¿Qué hago si no puedo acceder al panel de administración?

Usa FTP o el administrador de archivos de Syspanel para desactivar plugins renombrando la carpeta plugins. También puedes cambiar el tema activo desde la base de datos (tabla wp_options, campo template y stylesheet).

¿El error de actualización puede deberse a mi hosting?

Sí, especialmente si el servidor tiene límites bajos de memoria, tiempo de ejecución