Reparar WordPress cuando se queda en modo depuración
Reparar WordPress cuando sigue en depuración: desactiva WP_DEBUG y localiza el error real con pasos seguros y claros.
Si necesitas reparar wordpress porque el sitio se ha quedado en modo depuración, lo habitual es que WP_DEBUG, WP_DEBUG_DISPLAY o WP_DEBUG_LOG sigan activos, o que el error que los dejó al descubierto continúe ahí. En la práctica, esto puede traducirse en avisos en pantalla, wordpress pantalla blanca, errores fatales, backend inaccesible o un archivo debug.log wordpress creciendo sin parar.
Qué significa que WordPress se quede en modo depuración
Respuesta rápida: cuando WordPress se queda en modo depuración, conviene revisar wp-config.php, desactivar la visualización pública de errores, comprobar el registro de debug y localizar el componente que provoca el fallo antes de darlo por resuelto.
WordPress no entra en depuración por sí solo: normalmente alguien ha activado constantes de depuración para diagnosticar una incidencia. El problema aparece cuando esos ajustes siguen visibles en producción o cuando los errores php wordpress persisten aunque ya no quieras mostrarlos. Por eso conviene diferenciar entre ocultar errores al visitante y solucionar el origen real.
- Avisos o warnings en la parte superior de la web.
- Pantalla blanca o error fatal tras actualizar.
- Acceso al administrador interrumpido.
- Registro de errores creciendo de forma continua.
Cómo comprobar si WP_DEBUG sigue activo
El primer paso es abrir el archivo wp-config.php, preferiblemente con copia de seguridad previa si vas a editarlo. Busca las constantes de depuración habituales y revisa si aparecen con valor true o false.
- WP_DEBUG: activa el modo de depuración.
- WP_DEBUG_DISPLAY: muestra errores en pantalla.
- WP_DEBUG_LOG: guarda errores en un archivo de log.
Si el sitio sigue mostrando mensajes, puede ocurrir que WP_DEBUG_DISPLAY continúe activo o que el problema no dependa solo de esas constantes. Según el hosting y la configuración de PHP, también conviene revisar si existen ajustes adicionales del servidor que muestren errores, especialmente si necesitas reparar WordPress sin acceso FTP.
Cómo desactivar el modo depuración en wp-config.php sin agravar el error
Para desactivar modo depuracion sin empeorar la incidencia, edita solo las líneas necesarias y evita duplicar constantes. Lo prudente es dejar de mostrar errores al público y, si necesitas investigar, mantener el registro de forma temporal.
- Abre wp-config.php.
- Comprueba si WP_DEBUG está en true y cámbialo a false cuando ya no estés depurando.
- Deja WP_DEBUG_DISPLAY en false para no mostrar avisos al visitante.
- Si necesitas seguir investigando, WP_DEBUG_LOG puede mantenerse activo temporalmente para registrar errores sin enseñarlos en pantalla.
- Guarda cambios y vuelve a probar el frontal y el administrador.
Si tras ello sigue apareciendo una wordpress pantalla blanca o un error fatal, no asumas que el problema está resuelto: simplemente puede haberse ocultado el síntoma visible.
Cómo revisar debug.log y detectar el origen del fallo
Cuando el log está activo, WordPress suele escribir el registro en wp-content/debug.log. Ese archivo no repara nada por sí mismo, pero ayuda a identificar el componente que falla: un plugin concreto, una función obsoleta, un error de PHP o un archivo cargado fuera de tiempo.
Al revisar el log, fíjate en estos datos:
- Tipo de error: warning, notice, deprecated o fatal error.
- Archivo y línea donde se produce.
- Momento en que aparece: al entrar al admin, al cargar una página o tras una actualización.
- Repetición constante del mismo mensaje.
Los avisos menores no siempre tumban la web, pero un error fatal sí puede bloquearla. Si el archivo crece demasiado rápido, conviene detener la depuración cuando ya hayas recogido la información necesaria.
Qué hacer si el problema viene de un plugin, tema o archivo dañado
Aquí suele estar el trabajo real para reparar wordpress. Si el log apunta a un plugin o a un tema, aísla el fallo de forma ordenada.
- Desactiva temporalmente los plugins y comprueba si el error desaparece.
- Reactívalos uno a uno para localizar el conflicto de plugin.
- Si sospechas del tema, cambia temporalmente a uno por defecto para descartar incompatibilidades.
- Revisa si el problema empezó tras actualizar WordPress, un plugin o el tema.
- Si el error apunta al núcleo, conviene comprobar la integridad de los archivos y valorar una reinstalación limpia del core sin tocar el contenido.
Una pantalla blanca o errores fatales también pueden estar relacionados con versión de PHP, memoria disponible, funciones incompatibles o archivos dañados. Por eso es mejor verificar cada hipótesis antes de modificar más cosas a ciegas.
Cuándo conviene restaurar copia, revisar PHP o pedir ayuda técnica
Si el sitio sigue fallando después de desactivar la visualización de errores y revisar el log, el siguiente paso razonable puede ser restaurar una copia reciente, siempre que sepas que estaba sana. También conviene revisar la compatibilidad entre WordPress, plugins, tema y la versión de PHP disponible en tu hosting.
Pide ayuda técnica cuando:
- No puedes acceder al administrador ni por FTP o gestor de archivos.
- El log muestra errores críticos repetidos que no identificas con seguridad.
- El fallo afecta a producción y no tienes entorno de pruebas.
- Sospechas de corrupción de archivos o cambios incompletos tras una actualización.
Como buena práctica, depura en un entorno de pruebas cuando sea posible y no dejes wp_debug activo en producción más tiempo del necesario.
En resumen: si WordPress parece haberse quedado en depuración, revisa wp-config.php, corta la visualización pública, consulta el log y localiza la causa antes de cerrar la incidencia. El error más frecuente es ocultar los mensajes sin resolver el problema real. Si el fallo persiste, el siguiente paso sensato es restaurar una copia válida o contar con soporte técnico para solucionar errores wordpress sin asumir más riesgos.
Fuente oficial recomendada: WordPress Developer Resources – Debugging in WordPress
¿Necesitas orientación personalizada?
Te ayudamos a entender tus opciones y el siguiente paso.
