WordPress no funciona después de actualizar: síntoma, causa y vuelta a la versión anterior
Cuando WordPress no funciona después de actualizar, la causa suele ser un plugin, el tema o una versión de PHP demasiado antigua. Primero reconoce el síntoma: una pantalla blanca, un error crítico, un mensaje de mantenimiento atascado o un diseño roto. Después desactiva o devuelve a su versión anterior lo último que se actualizó. En una tienda, prueba después el carrito y un pedido.
Autor: El equipo de TellMyShop. Una guía para dueños de sitios WordPress y tiendas WooCommerce: la causa, el arreglo manual y el mismo trabajo en una conversación con el chat.
Última actualización: · 7 min de lectura
El síntoma apunta a la causa
Después de una actualización, un sitio puede romperse de varias maneras. Cada una apunta a una causa distinta y a un primer paso distinto.
| Lo que ves | Causa más común | Primer paso |
|---|---|---|
| «Ha habido un error crítico en esta web» o una pantalla blanca | la nueva versión del plugin no funciona con otro plugin o con la versión de PHP | desactiva el plugin actualizado: el correo del modo de recuperación o el gestor de archivos |
| Un mensaje de mantenimiento programado que no desaparece | la actualización se interrumpió a medias | borra el archivo .maintenance de la carpeta raíz del sitio |
| El sitio funciona, pero el diseño está roto | archivos de estilos antiguos en la caché | vacía la caché del plugin, del navegador y de la CDN |
| Todo funciona menos el carrito o el pago | una actualización de WooCommerce, de una pasarela de pago o del tema de la tienda | revisa los registros y las versiones; si hace falta, vuelve atrás ese plugin |
| El escritorio funciona pero el sitio no (o al revés) | un error en la parte del código que solo se carga ahí | los registros de errores señalan el archivo y el plugin |
Si ves un error crítico en todo el sitio, hay una guía de rescate aparte en el artículo sobre el error crítico de WordPress. Aquí nos centramos en qué hacer cuando sabes que la culpa es de una actualización, y en cómo volver a la versión anterior.
Martes después de actualizar: cómo averiguar qué cambió
Una situación típica: hay siete actualizaciones esperando en el escritorio, las marcas todas y haces clic en actualizar. Unos minutos después una amiga te escribe que no puede pagar en la tienda. Tienes que averiguar cuál de los siete plugins lo ha provocado.
La memoria falla, así que busca huellas. Los plugins con actualizaciones automáticas activadas también pueden haber cambiado por la noche, sin que hicieras clic en nada. Los mensajes de error contienen una ruta de archivo, y en ella el nombre de la carpeta del plugin. Los hostings suelen mostrar el registro de errores de PHP en su panel. Si tienes una tienda, WooCommerce registra los errores fatales en sus propios registros, en la sección de estado de la tienda.
Cuando las huellas no dicen nada, desactiva los plugins actualizados de uno en uno y revisa el sitio después de cada uno. Empieza por los que tocan el problema: para el carrito, WooCommerce y las pasarelas de pago; para el diseño, el tema y el maquetador.
Cómo volver atrás la actualización de un plugin paso a paso
Desactivar un plugin apaga el fuego. Pero a menudo necesitas ese plugin, así que quieres volver a la versión que funcionaba.
- Apunta qué versión tenías. El número de la versión antigua está en el correo de la actualización automática, en el registro de cambios del plugin o en la copia de seguridad.
- Un plugin del directorio de wordpress.org: instala WP Rollback. Bajo cada plugin del directorio aparece un enlace para elegir una versión anterior. La guía de WPBeginner sobre cómo volver a versiones anteriores de plugins muestra cómo se ve. WP Rollback no puede volver atrás plugins de pago de fuera del directorio.
- Un plugin de pago: descarga un archivo ZIP más antiguo desde tu cuenta con el autor del plugin y súbelo en lugar de la versión actual, o pide a quien cuida el sitio que lo haga.
- La copia de seguridad del hosting: si tienes una tienda, pide que restauren solo los archivos del plugin, sin la base de datos. Restaurar la base de datos borrará los pedidos hechos después de la copia.
- Desactiva las actualizaciones automáticas de ese plugin en la lista de plugins, para que la versión rota no vuelva mañana. Vuelve a activarlas cuando el autor publique una corrección.
- Revisa el sitio como un cliente: la página de inicio, una entrada y, en una tienda, un producto, el carrito y un pedido de prueba.
Hay una descripción de cómo encontrar el plugin culpable desactivándolos en la guía de cyber_Folks sobre conflictos de plugins (en polaco).
Lo que WordPress hace solo y lo que no
Desde la versión 6.6, después de una actualización automática de un plugin WordPress revisa la página de inicio. Cuando devuelve un error crítico, restaura la versión anterior y envía un correo al administrador. Encontrarás una descripción de esta función en el artículo de DreamHost sobre la reversión de actualizaciones automáticas.
Esta red tiene agujeros grandes. No cubre las actualizaciones hechas a mano ni los temas. Tampoco notará un error que solo rompe el carrito, el pago o el diseño, porque solo revisa la página de inicio. Así que, con una tienda, revisar el carrito después de actualizar sigue siendo cosa tuya.
Cómo ayuda el chat después de una actualización
Cuando solo se ha roto una parte del sitio y el escritorio responde, tu chat (Claude o ChatGPT) te ayuda a averiguar qué cambió. Con un error en todo el sitio, el plugin TellMyShop para WordPress y WooCommerce no arrancará, porque funciona dentro de WordPress, así que quedan los caminos descritos arriba.
Lee los registros de errores, agrupa los mensajes repetidos e indica de qué plugin o tema viene cada uno. Muestra la lista de plugins con versiones, actualizaciones automáticas y la versión de PHP requerida, además de la salud del sitio. Todo esto funciona en la versión gratuita TellMyShop Free.
Tú: Desde las actualizaciones de ayer el carrito no funciona. ¿Qué se ha roto?
Tu chat: Los registros tienen un error crítico nuevo, 12 veces desde ayer. Viene del plugin Example Cart Add-ons, versión 5.0, actualizado automáticamente. Los otros seis plugins actualizados no tienen errores.
Tu chat: Propongo desactivar este plugin y restaurar la versión anterior desde una copia de seguridad o desde tu cuenta con el autor. Vista previa:
Tú: Sí, desactívalo.
Tu chat: Desactivado. La página de inicio responde. Revisa el carrito con un pedido de prueba. Puedes deshacer el cambio desde el historial de cambios.
Estado de la tarjeta: esperando tu «sí»versión anterior: Example Cart Add-ons: activo
versión nueva: Example Cart Add-ons: inactivo
Desactivar, activar y actualizar plugins funciona en TellMyShop Pro después de activar el interruptor Plugins en el panel. El interruptor dura 24 horas y requiere una copia de la base de datos hecha el mismo día. En una actualización, la vista previa muestra la versión actual y la nueva, parte del registro de cambios y avisos: un cambio de versión mayor, una actualización de WooCommerce o de una pasarela de pago. Actualiza como mucho 5 plugins a la vez y revisa la página de inicio después de cada uno.
Hay dos límites: el chat no devolverá automáticamente un plugin a su versión anterior, y el plugin TellMyShop no hace copias de seguridad de todo el sitio. La versión anterior la restaura la copia de seguridad del hosting o la instalación de una versión más antigua. La desactivación de un plugin hecha por el chat la deshaces desde el historial de cambios.
Antes de volver a hacer clic en Actualizar
Estos hábitos ahorran nervios y no necesitan un desarrollador:
- Actualiza unos pocos plugins cada vez, no todos a la vez. Es más fácil detectar al culpable.
- Antes de actualizar, comprueba que tu hosting tiene una copia de seguridad reciente, y que sabes restaurarla.
- Haz los cambios de versión mayor (por ejemplo de 4.x a 5.0) y las actualizaciones de WooCommerce cuando tengas tiempo para revisar la tienda.
- Después de actualizar, haz un pedido de prueba o pide al chat un repaso de la mañana con los errores nuevos de los registros.
Puedes leer cómo lee el chat los registros y la salud del sitio en la página TellMyShop para WordPress y WooCommerce. Puedes comparar las licencias en precios, y encontrar más guías en el blog.
Preguntas y respuestas
¿Cómo vuelvo atrás la actualización de un plugin de WordPress?
Para los plugins del directorio de wordpress.org, lo más sencillo es el plugin WP Rollback, que instala una versión anterior elegida. Un plugin de pago se devuelve a una versión anterior subiendo un archivo ZIP más antiguo de su autor. Cuando el escritorio no funciona, primero desactiva el plugin desde el gestor de archivos del hosting y después vuelve a la versión anterior.
El sitio muestra un mensaje de mantenimiento que no desaparece. ¿Qué hago?
Significa que la actualización se interrumpió a medias. WordPress dejó un archivo .maintenance en la carpeta raíz del sitio. Bórralo en el gestor de archivos del hosting, recarga el sitio y repite la actualización del plugin que no terminó.
¿WordPress deshace solo las actualizaciones fallidas?
En parte. Desde la versión 6.6, WordPress deshace una actualización automática de un plugin cuando la página de inicio devuelve un error crítico justo después. No cubre las actualizaciones que haces a mano, los temas ni los errores que rompen el aspecto, el carrito u otras páginas.
El sitio se ve roto después de una actualización, pero funciona. ¿Por dónde empiezo?
Vacía la caché de tu plugin de caché y del navegador, y si usas un servicio tipo CDN, también ahí. Tras actualizar un tema o un maquetador, a menudo se quedan en la caché archivos de estilos antiguos. Si no ayuda, mira qué plugin o tema se actualizó más recientemente.
¿El chat deshace la actualización de un plugin?
No de forma automática. El chat señala en los registros y en la lista de plugins qué causó el problema, y en TellMyShop Pro, después de activar el interruptor Plugins, puede desactivar ese plugin. La versión anterior la restaura la copia de seguridad del hosting o la instalación de una versión más antigua.
WordPress es una marca de la WordPress Foundation. WooCommerce es una marca de Automattic Inc. Claude es una marca de Anthropic PBC. ChatGPT y OpenAI son marcas de OpenAI. TellMyShop no está afiliado a estas empresas.