«Es necesaria una actualización de la base de datos» y no sale de esa pantalla

Después de actualizar WordPress, a veces aparece una pantalla que dice «Es necesaria una actualización de la base de datos». Pulsas el botón, dice que todo salió bien, pulsas Continuar… y vuelves a la misma pantalla. Una y otra vez.

Por qué aparece esa pantalla

Cada versión de WordPress tiene un número interno de base de datos. WordPress guarda en la opción db_version el número de la última actualización aplicada. Si los archivos de WordPress dicen un número y la base de datos otro, te pide actualizar.

El bucle ocurre cuando la actualización se aplica, pero WordPress sigue leyendo el número antiguo, o cuando no se puede guardar el número nuevo.

Solución 1: vaciar la caché de objetos

Es la causa más común. Si tu sitio usa una caché de objetos persistente (Redis o Memcached), WordPress puede estar leyendo la versión antigua guardada en esa caché, aunque la base de datos ya esté actualizada.

• Desde el escritorio no puedes entrar, así que usa el panel de tu hosting (muchos tienen un botón para vaciar Redis) o WP-CLI:

wp cache flush

• Si no tienes acceso a nada de eso, renombra temporalmente el archivo wp-content/object-cache.php (por ejemplo, a object-cache.php.off), entra al escritorio y vuelve a dejarlo como estaba.

Solución 2: actualizar desde WP-CLI

Si tienes SSH, este comando hace la actualización sin pasar por el navegador y muestra cualquier error:

wp core update-db
wp cache flush

Solución 3: comprobar la versión

Para ver si la base de datos quedó con el número correcto:

# El número que tiene la base de datos
wp option get db_version

# El número que esperan los archivos de WordPress
wp eval 'global $wp_db_version; echo $wp_db_version . PHP_EOL;'

Si los dos números coinciden y aun así te pide actualizar, el problema está en la caché (solución 1). Si no coinciden después de actualizar, la actualización no se está guardando (solución 4).

Solución 4: el usuario de la base de datos no tiene permisos

Algunas actualizaciones modifican la estructura de las tablas. Si el usuario de MySQL que usa WordPress no tiene permiso para ALTER o CREATE, la actualización falla en silencio.

Qué hacer: en cPanel, ve a Bases de datos MySQL, busca el usuario de la base de datos de tu sitio y en Privilegios marca TODOS LOS PRIVILEGIOS. Luego repite la actualización.

Solución 5: archivos de WordPress incompletos

Si la actualización del núcleo se interrumpió, puede que tengas archivos de una versión y otros de otra. Reinstala los archivos del núcleo sin tocar tu contenido:

wp core download --force --skip-content
wp core update-db

Si nada funciona, no fuerces el número cambiando db_version a mano en la base de datos. Esconderías el aviso, pero las tablas podrían quedar sin los cambios que necesita la versión nueva. Mejor restaura el respaldo previo a la actualización y vuelve a actualizar.

En WooCommerce y otros plugins

WooCommerce y algunos plugins grandes tienen su propia actualización de base de datos, con un aviso parecido en el escritorio. Si ese aviso se repite:

• Revisa WooCommerce → Estado → Acciones programadas: la actualización se ejecuta en segundo plano y, si WP-Cron no funciona, nunca termina.
• Con WP-CLI puedes ejecutarla directamente: wp wc update.

¿Sigues en el bucle después de probar todo? Cuéntanos en el foro qué números te devuelven los dos comandos de la solución 3.