Actualizar los plugins de WordPress es una tarea rutinaria pero que puede salir mal de muchas formas distintas. Desde errores de permisos que impiden la descarga hasta incompatibilidades que rompen tu sitio después de la actualización, los problemas con las actualizaciones de plugins son una de las consultas más frecuentes en soporte técnico de WordPress.
Ignorar las actualizaciones por miedo a que algo se rompa no es una opción viable: los plugins desactualizados son el vector de ataque más explotado en WordPress. Por eso es fundamental saber cómo manejar los errores que pueden surgir durante el proceso de actualización.
En esta guía cubrimos los errores más comunes al actualizar plugins, desde los que impiden completar la actualización hasta los que causan problemas después de que la actualización se ha aplicado.
La actualización falla y no se completa
Cuando una actualización se interrumpe a mitad de proceso, WordPress puede quedar en un estado inconsistente. El error más visible es que el sitio se queda en modo mantenimiento mostrando el mensaje "Briefly unavailable for scheduled maintenance". Esto ocurre porque WordPress crea el archivo .maintenance antes de iniciar la actualización y no pudo eliminarlo al no completarse.
Otro error frecuente es "Installation failed: Could not create directory", que indica que WordPress no tiene permisos de escritura en la carpeta wp-content/plugins. También puedes encontrar errores de timeout si tu servidor es lento y la descarga del plugin excede el tiempo máximo de ejecución de PHP.
- Eliminar el archivo .maintenance de la raíz si el sitio está atascado en mantenimiento
- Verificar permisos de escritura en wp-content/plugins (755 para carpetas)
- Aumentar el tiempo de ejecución PHP si la descarga del plugin agota el timeout
- Comprobar espacio en disco disponible en el servidor
- Verificar que la conexión con wordpress.org no está bloqueada por el firewall
- Intentar la actualización por FTP subiendo los archivos manualmente
Incompatibilidades después de actualizar
A veces la actualización se completa correctamente pero el sitio empieza a mostrar errores o funcionalidades que dejan de operar. Esto suele deberse a incompatibilidades entre la nueva versión del plugin y otros componentes de tu sitio: otros plugins, el tema activo o la versión de PHP o WordPress que utilizas.
Los errores de PHP son los más informativos: si activas WP_DEBUG, verás mensajes que indican exactamente qué función, clase o archivo está causando el conflicto. Un error típico es "Fatal error: Call to undefined function..." que indica que el plugin actualizado espera una función que ya no existe o que ha cambiado de nombre en otro plugin.
Si la incompatibilidad es con la versión de PHP, verás errores como "Parse error: syntax error" cuando el plugin usa características de PHP que tu servidor no soporta. En estos casos, la solución puede ser actualizar la versión de PHP del servidor o revertir el plugin a la versión anterior mientras el desarrollador publica una corrección.
Cómo revertir una actualización problemática
Si una actualización ha causado problemas, la forma más rápida de solucionarlo es volver a la versión anterior del plugin. El plugin WP Rollback permite hacer esto directamente desde el panel de WordPress, mostrando todas las versiones disponibles del plugin en el repositorio oficial.
Si no puedes acceder al panel de administración, descarga la versión anterior del plugin desde wordpress.org (en la pestaña "Advanced" de la página del plugin encontrarás un desplegable con todas las versiones anteriores). Conecta por FTP, elimina la carpeta del plugin actual en wp-content/plugins y sube la versión anterior descomprimida.
Si tenías un backup reciente, restaurarlo puede ser la opción más rápida y segura, especialmente si la actualización afectó a la base de datos. Algunos plugins realizan cambios en las tablas de la base de datos durante la actualización que no se revierten automáticamente al instalar una versión anterior.
Diagnosticar conflictos entre plugins
Los conflictos entre plugins ocurren cuando dos o más plugins intentan modificar la misma funcionalidad de WordPress o utilizan librerías JavaScript incompatibles. Estos conflictos pueden no ser evidentes hasta que uno de los plugins se actualiza y cambia su comportamiento.
El método de diagnóstico más fiable es el "aislamiento progresivo": desactiva todos los plugins excepto el que sospechas que causa el conflicto, y reactívalos uno a uno probando el sitio después de cada activación. Cuando el problema reaparezca, habrás identificado la combinación conflictiva.
El plugin Health Check & Troubleshooting incluye un modo de resolución de problemas que permite desactivar plugins y cambiar temas solo para tu sesión, sin afectar a los visitantes del sitio. Es la herramienta ideal para diagnosticar conflictos en un sitio en producción sin causar tiempo de inactividad.
Buenas prácticas para actualizar plugins sin problemas
La prevención es siempre mejor que la curación. Establece un proceso de actualización que minimice los riesgos: realiza un backup antes de cada ronda de actualizaciones, actualiza un plugin a la vez (no todos de golpe), y verifica el funcionamiento del sitio después de cada actualización.
Lee el changelog de cada actualización antes de aplicarla. Los desarrolladores documentan los cambios importantes, las incompatibilidades conocidas y los requisitos mínimos. Si una actualización incluye cambios importantes (major version), presta especial atención y considera probarla en staging primero.
Programa las actualizaciones en horarios de bajo tráfico y cuando tengas disponibilidad para solucionar problemas si surgen. Actualizar a las 6 de la tarde del viernes antes de un fin de semana largo no es la mejor idea. Los martes o miércoles por la mañana suelen ser los mejores momentos para realizar mantenimiento.
Puntos clave
- Si la actualización se interrumpe, elimina el archivo .maintenance y verifica los permisos de escritura.
- Activa WP_DEBUG para ver los errores específicos que causa una actualización incompatible.
- El plugin WP Rollback permite revertir rápidamente un plugin a una versión anterior desde el panel.
- Usa el Health Check & Troubleshooting para diagnosticar conflictos sin afectar a los visitantes.
- Actualiza siempre un plugin a la vez y verifica el sitio después de cada actualización.
- Lee el changelog antes de actualizar y prueba las actualizaciones mayores en un entorno de staging.
¿Las actualizaciones de plugins te dan problemas?
Nuestro servicio de mantenimiento gestiona todas las actualizaciones de plugins de forma segura, con testing previo en staging, backup automático y rollback inmediato si algo falla.
Solicitar presupuesto