Error 500 de WordPress después de actualizar un plugin

Qué significa este error y cómo reconocerlo

• El sitio funcionaba antes de actualizar un plugin; después, el frontend, el escritorio de WordPress o ambos comenzaron a devolver errores HTTP 500.
• El fallo puede producirse después de una actualización manual o automática del plugin.
• El sitio público puede cargar mientras /wp-admin/ falla, o solo pueden fallar las páginas y solicitudes que utilizan el plugin actualizado.
• El navegador puede mostrar un mensaje genérico de “500 Internal Server Error”, una página en blanco o un mensaje de error crítico de WordPress en lugar de la causa subyacente.
• Cambiar el nombre del directorio del plugin actualizado recientemente puede hacer que el sitio vuelva a cargar.
• El registro de depuración del servidor o de WordPress puede contener un error fatal de PHP, un error de sintaxis, un error de archivo inexistente o un mensaje que mencione el plugin actualizado.

Causas principales, ordenadas por probabilidad

1. Incompatibilidad de PHP: La nueva versión del plugin puede requerir una función o versión de PHP que el servidor no proporciona.
2. Conflicto entre el plugin, el tema o WordPress: La actualización puede interactuar incorrectamente con otra extensión, el tema activo o la versión instalada del núcleo de WordPress. Las declaraciones duplicadas de funciones o clases son indicios frecuentes.
3. Actualización incompleta o dañada: Un tiempo de espera agotado, una conexión interrumpida o una transferencia de archivos fallida pueden dejar archivos del plugin ausentes o dañados.
4. Regresión del plugin: La nueva versión puede contener un defecto que afecte a la configuración de este sitio incluso cuando se cumplen los requisitos indicados de PHP y WordPress.
5. Un problema de hosting independiente o más amplio: Si desactivar el plugin actualizado no cambia nada, la respuesta 500 puede estar relacionada con otro cambio reciente, la configuración de PHP, los permisos, los límites de recursos o un fallo del servidor.

Cómo solucionarlo

1. Confirma el momento y el alcance

Identifica el plugin que se actualizó inmediatamente antes de que apareciera el error. Si se actualizaron varios plugins a la vez, anótalos todos. Comprueba el sitio público, /wp-admin/ y cualquier función específica del plugin que esté fallando. Evita actualizaciones no relacionadas hasta haber probado la causa sospechada.

2. Desactiva el plugin actualizado sin usar el escritorio

Antes de cambiar archivos, asegúrate de tener acceso autorizado al sitio mediante SFTP o el administrador de archivos del hosting y, cuando sea posible, una copia de seguridad reciente. Abre wp-content/plugins/ y cambia el nombre del directorio del plugin sospechoso añadiendo un sufijo como -disabled.

Vuelve a cargar el frontend y /wp-admin/:

• Si el sitio se recupera, mantén el plugin desactivado mientras revisas los registros y eliges una reversión o una solución de compatibilidad.
• Si nada cambia, restaura el nombre original del directorio y prueba el siguiente plugin actualizado al mismo tiempo.
• Si el error continúa después de desactivar todos los plugins actualizados recientemente, revisa los registros del servidor y de PHP y analiza otros cambios recientes del hosting o de la configuración.

Cambiar el nombre de un directorio modifica qué plugins carga WordPress, por lo que no debes usarlo como sustituto de identificar y corregir el problema subyacente.

3. Captura el error subyacente de PHP

Una respuesta 500 solo es el síntoma visible. Si tienes autorización para editar wp-config.php, activa temporalmente el registro por encima de la línea que indica que la edición ha terminado:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Con el plugin sospechoso aún desactivado, conserva el registro actual si es necesario. Vuelve a activar el plugin solo cuando estés listo para reproducir el fallo; después, reprodúcelo una vez y revisa wp-content/debug.log y el registro de errores de PHP o del servidor del panel de hosting. Busca el nombre del plugin, un mensaje relacionado con la versión de PHP, un archivo inexistente, un error de sintaxis, Cannot redeclare function o Cannot declare class.

La depuración puede registrar detalles sensibles de la implementación y debe ser temporal. Desactiva estos ajustes después de realizar las pruebas, especialmente en un sitio público de producción, y elimina o protege los datos expuestos en los registros según los procedimientos de tu hosting.

4. Relaciona el mensaje del registro con la causa probable

• Una función de PHP no compatible o una versión de PHP requerida apunta a un problema de compatibilidad con PHP.
• Un mensaje que mencione dos extensiones o un tema junto con Cannot redeclare function o Cannot declare class apunta a un conflicto de compatibilidad.
• Un archivo inexistente, un error de sintaxis o un error dentro del directorio del plugin actualizado recientemente sugiere una actualización incompleta o dañada.
• Un error que mencione el núcleo de WordPress u otra extensión puede indicar que la actualización puso de manifiesto un problema de compatibilidad más amplio.
• Si el registro no menciona el plugin ni un componente relacionado, comprueba los errores del nivel de hosting antes de asumir que la actualización es responsable.

5. Revierte a la última versión conocida como funcional

Si necesitas restaurar el sitio rápidamente, conserva una copia de los archivos actuales del plugin y utiliza una copia de seguridad verificada o un paquete anterior de la fuente de distribución oficial del plugin. Súbelo o restáuralo mediante SFTP o el administrador de archivos del hosting y, después, prueba el sitio antes de volver a activar el plugin.

No sobrescribas la única copia de una copia de seguridad funcional. Mantén desactivadas las actualizaciones automáticas de este plugin o somételas a revisión hasta entender la causa y disponer de una versión compatible.

6. Comprueba los requisitos de PHP y WordPress

Compara las versiones mínimas indicadas de PHP y WordPress para la versión actualizada del plugin con las versiones reales del sitio. Cuando el escritorio esté disponible, la información de PHP suele aparecer en Herramientas → Salud del sitio → Información; el panel de control del hosting también puede mostrar la versión activa de PHP.

Si PHP o WordPress están por debajo de los requisitos del plugin, crea una copia de seguridad y confirma la compatibilidad con el tema, otros plugins y el entorno de hosting antes de actualizar. Si el hosting controla PHP, pregunta al proveedor cuál es la ruta de actualización compatible. No cambies la versión de PHP de producción a ciegas, ya que puede afectar al resto del sitio.

7. Escala un conflicto o una regresión confirmados

Mantén desactivada la actualización incompatible o restaura la última versión conocida como funcional mientras informas del error fatal exacto, las versiones del plugin, la versión de PHP, la versión de WordPress y los pasos para reproducirlo a los desarrolladores correspondientes del plugin o del tema. Evita editar permanentemente los archivos del plugin: una actualización futura puede sobrescribir esos cambios y dejar el sitio sin soporte.

Prevención y cómo verificar la solución

• Crea y verifica una copia de seguridad tanto de la base de datos como de los archivos del sitio antes de actualizar plugins.
• Actualiza los plugins individualmente cuando sea práctico, para poder relacionar un fallo con un cambio específico.
• Prueba los cambios importantes de plugins, WordPress y PHP en una copia de staging antes de aplicarlos en producción.
• Mantén PHP y WordPress dentro de los rangos compatibles indicados por los plugins y el tema.
• Después de cada actualización, prueba el sitio público, /wp-admin/, el inicio de sesión, los formularios y las funciones proporcionadas por el plugin actualizado.
• Revisa las actualizaciones automáticas de los plugins críticos para el negocio o de aquellos con antecedentes de problemas de compatibilidad.
• Conserva documentada la última versión del plugin conocida como funcional y un método de recuperación disponible.
• Desactiva los ajustes temporales de visualización y registro de depuración después de solucionar el problema, y protege o elimina los registros que contengan detalles internos de errores.

Preguntas frecuentes