Cómo Activar la Depuración de Errores en WordPress y Leer el Log

Mantener un sitio web WordPress sin tropiezos es lo que todos queremos. Pero los errores, bueno, son parte del juego. De la vida, incluso. Y de la gestión web, claro. Cuando tu sitio se cae, te lanza advertencias raras o simplemente hace lo que no debe, saber qué le pasa es clave. Ah, y aquí es donde la depuración de errores en WordPress se vuelve tu mejor amiga. Prenderla te da pistas valiosísimas, la información justa para dar con el fallo y arreglarlo. Rápido y bien.

Aquí en RedServicio (redservicio.net) sabemos lo frustrante que puede ser lidiar con los errores de WordPress. Por eso, este artículo es una guía sencilla para que aprendas a activar la depuración y, más importante, a leer ese archivo log como si fueras un experto. ¿Te sientes superado? Tranquilo. Siempre puedes llamarnos. En RedServicio estamos listos para echarte una mano profesional con cualquier movida técnica en tu instalación de WordPress.

Activar la Depuración en WordPress: Lo que necesitas saber

WordPress trae un sistema de depuración potente, sí. Viene apagado por defecto en sitios que ya están online (por temas de seguridad y rendimiento), pero para desarrollar o solucionar líos, es una herramienta indispensable. ¿Cómo encenderlo? Toca editar el archivo wp-config.php.

1. Busca el archivo wp-config.php

El wp-config.php es, quizá, uno de los archivos más críticos de tu WordPress. Ahí está toda la configuración base. ¿Cómo lo encuentras? Hay varias formas:

1. Mediante FTP/SFTP: Usa un cliente FTP como FileZilla para conectarte a tu servidor. El wp-config.php se esconde en el directorio raíz de tu instalación de WordPress (casi siempre public_html o htdocs).
2. A través del Administrador de Archivos de tu cPanel (o panel de control similar): La mayoría de los hostings ofrecen un administrador de archivos web. Navega hasta la raíz de tu WordPress y busca el wp-config.php.

Cuando lo tengas localizado, bájate una copia a tu ordenador, por si las moscas, o ábrelo directamente desde el editor de tu panel.

2. Edita el wp-config.php

Ya dentro del wp-config.php, busca esta línea:

define( 'WP_DEBUG', false );

Si no la ves, busca entonces esta otra:

/* ¡Eso es todo, deja de editar! Feliz blogging. */

Y ahí, justo antes, metes las constantes de depuración.

3. Ajusta las constantes de depuración

Para una depuración a fondo, y que realmente funcione, te aconsejo poner estas constantes:

• WP_DEBUG: Esta es la clave para prender o apagar el modo depuración.
  • define( 'WP_DEBUG', true ); — Enciende el modo de depuración.
  • define( 'WP_DEBUG', false ); — Apaga el modo de depuración (es el valor por defecto y el recomendado para cuando el sitio está en producción).
• WP_DEBUG_LOG: Si WP_DEBUG está encendido, esto decide si los mensajes de error van a un archivo log. Sí, es importantísimo para guardar fallos que no salen en pantalla o para revisarlos después.
• define( 'WP_DEBUG_LOG', true ); — Guarda todos los mensajes de depuración en un archivo llamado debug.log dentro de la carpeta wp-content/.
• define( 'WP_DEBUG_LOG', false ); — No guarda los mensajes en un archivo log.
• WP_DEBUG_DISPLAY: Controla si los mensajes de depuración se ven directamente en tu web. Útil para desarrollar, claro. Pero nunca la dejes activa en un sitio en producción. Podrías mostrar información delicada a cualquiera que entre. Si la pones en false y WP_DEBUG_LOG está en true, los errores se guardarán igual en el log. Es lo más seguro cuando depuras un sitio que ya está en marcha.
• define( 'WP_DEBUG_DISPLAY', true ); — Muestra los errores y advertencias directamente en tu navegador.
• define( 'WP_DEBUG_DISPLAY', false ); — Oculta los errores y advertencias de la visualización pública.
• SCRIPT_DEBUG: Una constante que no todo el mundo conoce, pero que viene de perlas a los desarrolladores. Obliga a WordPress a usar las versiones «dev» de los archivos JavaScript y CSS de plugins y temas, en vez de las minificadas. Muy útil para cazar fallos de JavaScript o CSS.
• define( 'SCRIPT_DEBUG', true ); — Fuerza a WordPress a usar las versiones «dev» de los archivos JS y CSS.

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 ); // Asegura que PHP no muestre errores en pantalla.

Guarda los cambios en tu wp-config.php y súbelo de nuevo al servidor. Sobreescribe el anterior, sin miedo.

El debug.log: Tu mapa para encontrar errores en WordPress

Cuando activas WP_DEBUG_LOG, WordPress empieza a apuntar todos los errores, advertencias y avisos en un archivo. Se llama debug.log. Piénsalo como el mapa del tesoro de tus problemas.

Dónde encontrar el debug.log

El debug.log aparece solito dentro de la carpeta wp-content/ de tu WordPress. Imagina que tu sitio está en public_html/; pues la ruta completa sería public_html/wp-content/debug.log.

Cómo entrar al debug.log

Para ver el debug.log, usa los mismos métodos que para el wp-config.php:

1. FTP/SFTP: Conéctate a tu servidor, navega a wp-content/ y descarga debug.log.
2. Administrador de Archivos (cPanel, etc.): Navega a wp-content/ y abre debug.log en el editor de texto.
3. SSH (para usuarios avanzados): Si tienes acceso SSH, puedes usar comandos como cat wp-content/debug.log, tail -f wp-content/debug.log (para ver el log en tiempo real) o less wp-content/debug.log.

Entender lo que dice el log

Cada línea del debug.log es un aviso, un evento de depuración o un error. Suelen tener esta pinta:

[dd-mmm-yyyy hh:mm:ss UTC] PHP Warning:  Undefined array key "my_key" in /home/user/public_html/wp-content/plugins/my-plugin/my-plugin.php on line 123

Vamos a ver qué significa cada parte:

• [dd-mmm-yyyy hh:mm:ss UTC]: Fecha y hora exactas del evento. Crucial para atar cabos: ¿qué hacías justo cuando apareció el error?
• PHP Warning:: El tipo de mensaje. Aquí van los más comunes:
  • PHP Notice: — Un simple aviso. Puede que algo no esté del todo bien, pero el script sigue funcionando.
  • PHP Warning: — Una advertencia. Indica un problema más serio. Podría haber comportamientos raros, pero el script no se para.
  • PHP Fatal error: — Error fatal. Esto lo para todo. Completamente. Es el que casi siempre causa las famosas «pantallas blancas de la muerte» (WSOD).
  • PHP Deprecated: — Significa que se está usando una función o característica antigua, que ya no se usará en futuras versiones de PHP. Ojo con estas.
• Undefined array key "my_key": El mensaje de error en sí. Te cuenta el problema.
• in /home/user/public_html/wp-content/plugins/my-plugin/my-plugin.php: La ruta completa del archivo que generó el error. Esto es oro. Te dice al momento qué plugin, tema o archivo de WordPress es el culpable.
• on line 123: El número de línea dentro de ese archivo. Vas directo al grano, a investigar el código.

Resolviendo problemas con el log: Trucos clave

• Recrea el error: Una vez activada la depuración, repite la acción que crees que causa el problema. Así, el debug.log registrará nuevas entradas.
• Empieza por lo más reciente: Los errores aparecen en orden. Mira las últimas entradas para dar con el problema del momento.
• Prioriza los errores fatales: Los Fatal errors son los peores. Hay que atacarlos primero, porque paralizan tu web.
• Identifica la fuente: La ruta del archivo (/wp-content/plugins/mi-plugin/ o /wp-content/themes/mi-tema/) te lo chiva. ¿Es un plugin, un tema o algo del propio WordPress?
• Desactiva la fuente: Si el error viene de un plugin o tema, desactívalo. Si el problema se va, bingo. Ya sabes quién es.
• Busca en línea: Copia y pega el mensaje de error tal cual (sin las rutas de tu servidor) en Google. Lo más seguro es que alguien ya haya pasado por lo mismo y la solución esté ahí.

Depuración: ¿Cuándo sí, cuándo no?

La depuración es una herramienta potente, no lo niego. Pero hay que usarla con cabeza:

• Durante el Desarrollo: Cuando estés desarrollando un tema o plugin, ten siempre activos WP_DEBUG, WP_DEBUG_LOG y WP_DEBUG_DISPLAY. Te ayudará a ver los problemas al momento.
• Resolución de Problemas en Producción: Si tu web en producción está dando guerra, enciende la depuración un rato. Pero con la configuración segura (WP_DEBUG_DISPLAY en false). Así, los errores se guardan sin fastidiar la experiencia del usuario.
• Después de Resolver el Problema: Una vez que has pillado el error y lo has arreglado, esto es clave: ¡desactiva la depuración! Vuelve a poner WP_DEBUG en false en tu wp-config.php. Dejarla encendida en un sitio que ya está al aire puede traer problemas gordos:
  • Riesgos de Seguridad: Los mensajes de error, a veces, revelan rutas de archivos, nombres de usuario de bases de datos o información delicada. Un caramelo para los atacantes.
  • Rendimiento Reducido: Cada aviso, cada advertencia que se registra, consume recursos del servidor. Y eso se traduce en una web más lenta.
  • Mala Experiencia de Usuario: Si WP_DEBUG_DISPLAY está activo, los visitantes verán mensajes de error en vez de tu contenido. Poco profesional, y un lío para ellos.

Cierre

Saber cómo activar la depuración de errores en WordPress y leer su log… es un superpoder. Créeme. Te da autonomía para diagnosticar y arreglar líos por tu cuenta, ahorrándote un montón de tiempo y quebraderos de cabeza. Eso sí, una vez que el problema esté solucionado, apaga la depuración en los sitios en producción. Es lo más sensato para la seguridad y el buen rendimiento de tu web.

Si, después de todo esto, los problemas siguen ahí, o la depuración te parece un mundo, no te lo pienses. Busca ayuda. En RedServicio (redservicio.net) tenemos expertos en WordPress y administración de servidores listos para cualquier reto técnico que se te ponga por delante.