Qué es WP_DEBUG
WP_DEBUG es una opción de configuración de WordPress que, al activarla, muestra en pantalla o guarda en un archivo los errores técnicos que ocurren en tu web, para poder localizar la causa exacta de un fallo. También se conoce como «modo depuración de WordPress» o «modo debug».
Es como encender la luz de un cuarto oscuro para ver exactamente qué cable se ha desconectado, en lugar de quedarte a oscuras intentando adivinarlo a tientas. Por defecto, WordPress oculta los avisos técnicos y errores menores para que el visitante no vea mensajes confusos; WP_DEBUG es una línea que se añade al archivo de configuración de WordPress (wp-config.php) y que, al activarse, hace que esos avisos se muestren o se guarden en un archivo de registro, con información útil como el nombre del plugin o la línea de código donde ha ocurrido el problema.
Cómo funciona
- Alguien añade o cambia una línea en el archivo de configuración de WordPress para activar WP_DEBUG.
- A partir de ese momento, WordPress empieza a registrar avisos, errores y notificaciones que normalmente pasan desapercibidos.
- Esa información se puede mostrar directamente en la pantalla (poco recomendable en una web real) o guardarse en un archivo de registro privado.
- Quien está revisando el problema consulta ese archivo para ver en qué plugin, tema o línea de código ha surgido el fallo.
- Una vez localizada y corregida la causa, lo normal es desactivar WP_DEBUG de nuevo para no dejar información técnica expuesta.
Un fragmento típico que se añade al archivo de configuración es este:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );Con esta combinación, los errores se guardan en un archivo de registro en lugar de mostrarse directamente en la web, que es la forma segura de usarlo.
Ejemplo
Un taller mecánico en Valladolid con web de reserva de citas nos pidió ayuda porque un formulario dejaba de enviarse de forma intermitente, sin ningún mensaje de error visible para el cliente. Activamos WP_DEBUG de forma controlada, guardando los avisos en un archivo privado sin mostrarlos en la web pública, y así localizamos que un plugin de citas chocaba con otro de validación de formularios en ciertos casos concretos. Corregimos la configuración de ambos y desactivamos de nuevo el modo debug, dejando la web tan segura como antes pero con el fallo resuelto.
Señales de que te afecta
- Tienes un fallo intermitente o difícil de reproducir y no sabes qué plugin o parte del código lo está causando.
- Alguien técnico te pide activar «el modo debug» o «WP_DEBUG» para revisar un problema.
- Ves mensajes de aviso o advertencia en tu web que no deberían estar visibles.
- Quieres descartar qué plugin concreto está provocando un fallo antes de desactivarlo a ciegas.
Cómo lo resolvemos
Activamos WP_DEBUG de forma controlada y solo el tiempo necesario, guardando los registros en un archivo privado en lugar de mostrarlos en la web pública, para no exponer información técnica a los visitantes mientras localizamos la causa exacta del fallo. Una vez corregido, lo desactivamos de nuevo. Si tienes un error intermitente que no consigues identificar, en nuestro servicio de reparación de WordPress lo diagnosticamos de esta forma. Esta herramienta es justo la que usamos para encontrar la causa real detrás de muchos casos de conflicto de plugins o de memoria agotada, e incluso a veces revela código extraño que resulta ser un backdoor oculto entre archivos legítimos.
Preguntas frecuentes
¿Puedo dejar WP_DEBUG activado todo el tiempo?
No es recomendable, sobre todo si se muestra en pantalla, porque los visitantes podrían ver información técnica de tu web; lo normal es activarlo solo mientras se investiga un problema concreto y desactivarlo después.
¿Activar WP_DEBUG puede romper mi web?
No debería, porque solo cambia qué se muestra o se registra, no el funcionamiento de la web. Aun así, conviene hacerlo con una copia de seguridad reciente, como con cualquier cambio en el archivo de configuración.
¿Necesito saber programar para usar WP_DEBUG?
Para activarlo basta con añadir una línea concreta en un archivo; para interpretar lo que aparece en el registro de errores sí suele hacer falta cierto conocimiento técnico, por eso muchos dueños de web prefieren que lo revise alguien con experiencia.