Errores de WordPress

Acerca de esta categoría de errores

# Errores de WordPress

Los fallos de WordPress pueden aparecer como una página en blanco, un 500 Internal Server Error, un mensaje explícito de la base de datos o un aviso de agotamiento de memoria de PHP. Estos síntomas no indican necesariamente el mismo problema. Empieza por registrar exactamente lo que ven los visitantes, lo que informa el escritorio de WordPress y qué cambió antes del fallo.

Usa las guías de esta categoría para relacionar el síntoma visible con la parte más probable del stack de WordPress. Un fallo que aparece inmediatamente después de actualizar un plugin requiere una primera comprobación diferente a la de un mensaje de conexión con la base de datos o un error Allowed memory size ... exhausted. Evita cambiar varios componentes a la vez: las pruebas controladas facilitan identificar la causa y evitan reintroducirla.

Patrones habituales de errores de WordPress

Error 500 después de actualizar un plugin

Un 500 Internal Server Error que comienza inmediatamente después de actualizar un plugin convierte a ese plugin en el principal sospechoso. La actualización puede revelar un problema de compatibilidad con PHP o un conflicto con el tema activo, otro plugin o el entorno de hosting.

La confirmación más útil consiste en desactivar o revertir el plugin actualizado mediante un método de recuperación disponible y, después, probar la solicitud afectada. Si el sitio se recupera, revisa los detalles del error de PHP y prueba la versión del plugin con la combinación de tema y plugins existente. No des por hecho que todas las respuestas 500 las causa el proveedor de hosting.

Consulta [Error 500 de WordPress después de actualizar un plugin](/wordpress-500-error-after-plugin-update) para obtener un diagnóstico específico.

Pantalla blanca de la muerte de WordPress

La pantalla blanca de la muerte es una respuesta completamente en blanco sin ningún error útil visible. Suele producirse cuando un error fatal de PHP está oculto para los visitantes. La página en blanco por sí sola no permite identificar si el problema está en un plugin, un tema, una operación de PHP, el límite de memoria o un archivo dañado de WordPress.

El siguiente paso es localizar el error subyacente mediante la depuración de WordPress o el entorno de hosting, manteniendo la visualización de errores alejada de los visitantes siempre que sea posible. Cuando el mensaje identifique un componente u operación, desactiva, restaura o corrige esa causa específica y vuelve a probar. Una página en blanco no debe tratarse automáticamente como un fallo de la base de datos.

Consulta [Pantalla blanca de la muerte de WordPress](/wordpress-white-screen-of-death) para conocer la secuencia de diagnóstico.

Error al establecer una conexión con la base de datos

El mensaje Error Establishing a Database Connection significa que WordPress no pudo conectarse a su base de datos MySQL o MariaDB. Comprueba los valores del nombre de la base de datos, el nombre de usuario, la contraseña y el host en wp-config.php, y registra los valores originales antes de realizar cualquier cambio.

Si la configuración parece correcta, determina si el servicio de base de datos es accesible desde el entorno de hosting y si el usuario de la base de datos todavía tiene el acceso necesario. Las tablas dañadas son otra posibilidad, pero la reparación de la base de datos debe realizarse después de comprobar la conexión y la configuración. Protege cualquier copia de seguridad disponible antes de realizar cambios de reparación.

Consulta [WordPress: Error al establecer una conexión con la base de datos](/wordpress-error-establishing-a-database-connection) para ver un desglose paso a paso.

Errores de memoria agotada en WordPress

Un error como Allowed memory size of X bytes exhausted significa que un proceso de PHP utilizó más memoria de la permitida por el memory_limit configurado. Aumentar el límite disponible puede permitir que la solicitud termine, pero no explica por qué aumentó el uso de memoria.

Comprueba si el error comenzó durante un cambio de plugin o tema, una importación, una copia de seguridad, una tarea multimedia u otra operación que consuma muchos recursos. Revisa la configuración de memoria disponible para el sitio y usa los detalles del error para identificar la solicitud o el componente implicado. Si la misma operación agota la memoria repetidamente, investiga la operación costosa en lugar de aumentar el límite indefinidamente.

Consulta [Error de memoria agotada de WordPress](/wordpress-memory-exhausted-error) para conocer la solución inmediata y el diagnóstico a largo plazo.

Proceso práctico para diagnosticar errores de WordPress

1. Registra el síntoma exacto. Anota el mensaje, el estado HTTP, la URL o tarea afectada, si la página está en blanco y si el escritorio sigue disponible.
2. Determina cuándo comenzó. Busca una actualización reciente de un plugin o tema, un cambio de WordPress o PHP, una modificación de configuración, una migración, una importación, una copia de seguridad o un evento del hosting.
3. Distingue entre síntomas de PHP, de la aplicación y de la base de datos. Un mensaje de error fatal de PHP, una página en blanco y una respuesta 500 indican un punto de partida diferente al de un error directo de conexión con la base de datos.
4. Comprueba los registros o la salida de depuración. El nombre del componente, el archivo PHP, la operación y el mensaje de error completo son más útiles que un fallo genérico del navegador.
5. Prueba una causa probable cada vez. Desactiva o revierte el componente más relacionado con el momento en que comenzó el problema y, después, repite la solicitud fallida.
6. Comprueba las funciones públicas y administrativas. Que la página de inicio funcione no demuestra que el inicio de sesión, la publicación, los formularios, las importaciones u otras solicitudes afectadas estén funcionando correctamente.
7. Documenta el cambio que funcionó. Registra qué revertiste o ajustaste antes de intentar otra actualización o modificación de configuración.

Qué debes evitar

• No desactives todos los plugins y cambies el tema simultáneamente si necesitas aislar la causa.
• No supongas que una respuesta 500 significa que el servidor de hosting no está disponible; el código de WordPress puede provocarla.
• No aumentes repetidamente la memoria de PHP sin identificar la operación que la está consumiendo.
• No sobrescribas la configuración de la base de datos sin conservar los valores originales y tener en cuenta cualquier copia de seguridad disponible.
• No expongas errores detallados de PHP a los visitantes durante más tiempo del necesario.
• No consideres que actualizar el navegador es un diagnóstico. Los registros, las pruebas controladas y el mensaje de error exacto proporcionan evidencias más sólidas.

Empieza por la guía cuyo síntoma coincida más con lo que ven los visitantes o administradores. El objetivo no es solo restaurar la página, sino distinguir entre una actualización defectuosa, un error fatal de PHP oculto, un problema de acceso a la base de datos y un límite de recursos para poder abordar el fallo subyacente de forma segura.