Cómo activar y desactivar el modo debug de WordPress

El modo debug de WordPress permite registrar errores para ayudar a encontrar la causa de un fallo. Se configura en el archivo wp-config.php; no hay un botón para activarlo desde el panel de WordPress. Cuando termines el diagnóstico, desactiva la depuración y elimina el registro si ya no lo necesitas.

Esta guía es para sitios WordPress autohospedados cuyos archivos puedes editar. Antes de cambiar la configuración, usa una copia de staging si tienes una. Si vas a editar la web publicada, guarda una copia segura de wp-config.php: un error de sintaxis puede impedir que cargue el sitio. Conserva esa copia fuera de la carpeta pública.

Antes de activar el modo debug

La documentación oficial de depuración en WordPress recomienda usar estas herramientas en instalaciones locales o de pruebas. Si necesitas registrar un error en la web publicada, hazlo solo durante el diagnóstico y mantén los mensajes ocultos para tus visitantes.

wp-config.php suele estar en la carpeta de instalación de WordPress, junto a wp-admin y wp-content, aunque algunas instalaciones lo colocan un nivel por encima. Puedes abrirlo desde el administrador de archivos del panel de hosting o mediante FTP/SFTP. Los nombres de los menús varían según el panel. La guía oficial para editar wp-config.php explica más sobre este archivo.

Cómo activar el modo debug

1. Haz una copia segura de wp-config.php. Descárgala a tu equipo o guárdala en una ubicación privada fuera de la carpeta pública.

2. Localiza las constantes de depuración. Abre wp-config.php y busca WP_DEBUG, WP_DEBUG_LOG o WP_DEBUG_DISPLAY. Si ya existen, modifica esas líneas en lugar de añadir otra definición.

3. Activa el registro y mantén los errores ocultos. Si las constantes no existen, añade este bloque antes del comentario /* That's all, stop editing! Happy blogging. */:

   define( 'WP_DEBUG', true );
   define( 'WP_DEBUG_LOG', true );
   define( 'WP_DEBUG_DISPLAY', false );
   @ini_set( 'display_errors', 0 );

   

   WP_DEBUG activa la depuración, WP_DEBUG_LOG guarda los errores y WP_DEBUG_DISPLAY evita mostrarlos en la página. El último ajuste también pide a PHP que no los muestre. En la configuración habitual, WordPress guarda el registro en wp-content/debug.log.

4. Guarda el archivo y reproduce el problema una vez. Luego abre wp-content/debug.log desde el administrador de archivos o por FTP/SFTP. El registro puede incluir rutas y detalles técnicos: no publiques su contenido ni lo envíes completo sin revisarlo.

Si el archivo no aparece, comprueba que WP_DEBUG y WP_DEBUG_LOG estén en true, que hayas guardado el archivo correcto y que WordPress haya procesado la acción que genera el error. Si sigue sin crearse, consulta el registro de errores del hosting. No cambies los permisos a 777.

Cómo desactivar el modo debug

Cuando termines de recopilar la información, vuelve a abrir wp-config.php y deja las constantes así:

define( 'WP_DEBUG', false );
define( 'WP_DEBUG_LOG', false );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Si las líneas ya existen, modifica sus valores en lugar de duplicarlas. Guarda el archivo y comprueba que la web pública y el panel de administración cargan con normalidad. Si el sitio deja de cargar después de editarlo, restaura la copia segura de wp-config.php.

Descarga solo el fragmento del registro que necesites conservar y guárdalo en un lugar privado. Después, elimina wp-content/debug.log del servidor si ya no necesitas consultarlo. La documentación de WordPress advierte que los registros pueden quedar en una ubicación accesible desde la web.

Si necesitas ayuda

Activar el modo debug no repara el error: registra información que puede ayudar a diagnosticarlo. Si investigas un error 500, consulta también la guía sobre cómo solucionar un error 500 en WordPress.

Si no puedes acceder a los archivos o el registro no aparece, contacta con el equipo de miHosting e indica el dominio afectado, el mensaje exacto y la hora aproximada. No envíes contraseñas, el archivo wp-config.php ni registros completos sin revisar.