Ver Logs de Errores de WordPress en cPanel (error_log) – Guía

¿Tu sitio WordPress muestra un error y no sabes qué está pasando? Esa sensación de ver una pantalla blanca o un mensaje de "Error al conectar con la base de datos" es bastante angustiante, pero no te preocupes: en la mayoría de los casos, la solución está en un archivo llamado error_log. Este es el diario de a bordo de tu hosting, donde se registran todos los fallos que ocurren en tu web. En este artículo, te voy a enseñar, paso a paso y sin tecnicismos raros, cómo ver los logs de errores de WordPress en cPanel. Aprenderás a diagnosticar problemas como un profesional, incluso si es la primera vez que entras a tu panel de control.

¿Qué es el archivo error_log y por qué es tu mejor amigo?

Imagina que tu web es un coche. El error_log es la caja negra. Cada vez que algo falla (un plugin incompatible, un tema con errores de código, un límite de memoria excedido), el servidor anota el incidente en ese archivo. Sin él, estarías a ciegas, probando soluciones al azar. Con él, puedes leer exactamente qué línea de código o qué archivo está causando el problema.

Los logs errores WordPress cPanel son la fuente de información más fiable que tienes. No es magia, es solo un archivo de texto (a veces muy largo) que se guarda en tu cuenta de hosting. Lo mejor de todo es que no necesitas ser un programador experto para interpretarlos. Basta con saber dónde mirar y qué buscar.

Primer paso: Localizar el archivo error_log en el Administrador de Archivos

Para ver error_log cPanel, lo primero es entrar a tu panel de control. Normalmente, accedes a través de una URL como tudominio.com/cPanel o tudominio.com:2083. Una vez dentro, sigue estos pasos:

Busca la sección "Archivos" y haz clic en "Administrador de archivos".
Se abrirá una ventana nueva. Asegúrate de que estás en la carpeta public_html. Esta es la raíz de tu sitio web.
En la esquina superior derecha, activa la opción "Mostrar archivos ocultos" (a veces se llama "Mostrar archivos dot" o similar). Esto es crucial, ya que el archivo error_log suele estar oculto.
Verás una lista de carpetas y archivos. Busca el archivo llamado error_log. Estará en la raíz, justo donde están tus carpetas wp-admin, wp-content y wp-includes.

[TIP]: Si no ves el archivo, prueba a hacer clic en "Recargar" en la barra de herramientas. A veces, el servidor tarda unos segundos en mostrar los archivos recién creados.

¿Cómo abrir y leer el archivo de logs?

Una vez que has localizado el archivo error_log, haz clic derecho sobre él. Verás un menú contextual. Selecciona "Editar" o "Ver". Se abrirá una ventana con el contenido del archivo.

Pero, ¡ojo! Este archivo puede ser enorme (de varios megabytes). Si lo abres entero, tu navegador podría colapsar. Por eso, es mejor que sigas estos consejos:

Editar te permite ver las últimas líneas, que son las más importantes.
Si el archivo es demasiado grande, cierra la vista y busca la opción "Descargar" para abrirlo en tu ordenador con un editor de texto como Notepad++ o Sublime Text. Esto te facilitará la búsqueda.

Interpretando las líneas del log: ¿Qué significa todo eso?

No te asustes con tanto código. Una línea típica de un error en WordPress se ve así:

[Wed Jan 10 10:15:30 2024] [error] [client 192.168.1.1] PHP Fatal error: Call to undefined function wp_get_current_user() in /home/usuario/public_html/wp-content/plugins/mi-plugin/funciones.php on line 25

Vamos a desglosarla:

Fecha y hora: [Wed Jan 10 10:15:30 2024]. Esto te dice cuándo ocurrió el error. Es vital para correlacionarlo con los cambios que hiciste en tu web (por ejemplo, "activé un plugin a las 10:15").
Nivel del error: [error] o [warning]. Un error crítico hará que la página se rompa; un warning solo es un aviso.
Mensaje: PHP Fatal error: Call to undefined function.... Esta es la parte más importante. Te dice qué falló exactamente.
Ubicación: /home/usuario/public_html/wp-content/plugins/mi-plugin/funciones.php on line 25. Te indica el archivo y la línea exacta donde está el problema.

Los errores más comunes que verás

PHP Fatal error: Es el más grave. Significa que el script se detuvo por completo. Las causas habituales son un plugin o tema mal codificado, o un límite de memoria agotado.
PHP Warning: No detiene la ejecución, pero indica algo que no está bien, como intentar incluir un archivo que no existe.
PHP Notice: Son avisos menores, a menudo inofensivos, pero pueden acumularse y ralentizar tu web.

[WARNING]: Si ves un error que menciona "Allowed memory size of X bytes exhausted", significa que tu sitio se quedó sin memoria. La solución rápida es aumentar el límite de memoria de PHP, pero lo mejor es encontrar el plugin o script que está consumiendo todos los recursos.

Método alternativo: Usar el visor de errores de cPanel

cPanel tiene una herramienta integrada llamada "Errores" (o "Errors" en inglés). Aunque no es tan detallada como el archivo error_log, es muy útil para una vista rápida.

En tu cPanel, busca la sección "Métricas".
Haz clic en el icono "Errores".
Se abrirá una página con los últimos errores registrados, sin necesidad de navegar entre archivos.

Esta herramienta es perfecta para una primera comprobación rápida, pero para un análisis profundo, siempre recomiendo ir al archivo error_log directamente.

¿Y si no encuentro el archivo error_log? Activar el registro de errores

A veces, el archivo error_log no existe porque la opción de registro está desactivada en la configuración de PHP. No es lo habitual, pero puede pasar. Para solucionarlo, puedes forzar su creación.

En cPanel, busca la sección "Software" y haz clic en "Seleccionar versión de PHP" (o "MultiPHP Manager").
Haz clic en el botón "Opciones de PHP" o "Switch to PHP Options".
Busca la directiva log_errors y asegúrate de que esté en On.
También busca error_log (a veces aparece como error_log sin más) y establece la ruta donde quieres que se guarde. Si lo dejas en blanco, se guardará en public_html.

Guarda los cambios y, a partir de ahora, el servidor empezará a crear el archivo error_log en tu carpeta raíz.

[INFO]: Si tu hosting usa Syspanel (el antiguo HestiaCP), el acceso al panel de control se realiza a través del puerto 2106. La estructura de carpetas es similar, pero el registro de errores puede estar en logs/ dentro de tu carpeta de usuario. La lógica es la misma, solo cambia la interfaz.

Errores de WordPress que no verás en error_log

Es importante aclarar un punto: no todos los errores de WordPress se registran en error_log. Por ejemplo:

Errores 404: Estos se registran en el log de acceso (access log) del servidor, no en el de errores.
Errores de base de datos: A veces, se muestran en pantalla pero no se guardan en el log.
Errores de JavaScript: Estos ocurren en el navegador del usuario, no en el servidor.

Para diagnosticar esos, necesitarás otras herramientas, pero para el 80% de los problemas críticos (pantalla blanca, errores de plugins, problemas de memoria), el error_log es tu primera y mejor opción.

Cómo diagnosticar un problema real con los logs: Un caso práctico

Imagina que ayer actualizaste un plugin y hoy tu web da error 500 (Error interno del servidor). Esto es lo que harías:

Abre el error_log siguiendo los pasos anteriores.
Busca la fecha de hoy o la de ayer por la noche.
Verás una línea que dice algo como: PHP Fatal error: Uncaught Error: Call to undefined method ... in /public_html/wp-content/plugins/plugin-de-prueba/class.php:45.
El mensaje te dice el plugin exacto: plugin-de-prueba. Ahora sabes que ese plugin es el culpable.
Solución: Ve a tu panel de WordPress (si puedes acceder) y desactiva ese plugin. Si no puedes acceder, entra a public_html/wp-content/plugins/ y renombra la carpeta del plugin (por ejemplo, de plugin-de-prueba a plugin-de-prueba-desactivado). WordPress lo desactivará automáticamente.

Así de simple. Sin el log, habrías tardado horas en adivinar cuál de los 20 plugins que tienes era el problemático.

Preguntas frecuentes (FAQ) sobre logs de errores

¿Puedo borrar el archivo error_log?

Sí, es totalmente seguro. De hecho, es recomendable hacerlo de vez en cuando para que el archivo no crezca demasiado y ralentice tu hosting. Se recreará automáticamente cuando ocurra un nuevo error.

¿Por qué mi error_log está vacío?

Puede ser que no haya habido errores (¡enhorabuena!) o que la configuración de PHP no esté registrando los errores. Revisa el paso anterior sobre activar el registro.

¿El error_log afecta al rendimiento de mi web?

Sí, si el archivo es gigantesco (varios cientos de MB), puede ralentizar las copias de seguridad y el acceso. Por eso es buena práctica limpiarlo mensualmente.

¿Qué hago si el error_log no me da ninguna pista?

Si el log no muestra nada o los errores son muy confusos, el problema puede estar en el servidor (memoria, CPU) o en un conflicto de red. En ese caso, contacta con tu proveedor de hosting.

¿Puedo ver los logs de errores desde el móvil?

Sí, puedes usar la aplicación de cPanel para móviles, o simplemente acceder al Administrador de archivos desde el navegador de tu teléfono. No es la experiencia más cómoda, pero funciona.

¿Qué diferencia hay entre error_log y debug.log?

error_log es el log del servidor (PHP). debug.log es un log específico de WordPress que se crea cuando activas el modo de depuración (WP_DEBUG). Para problemas avanzados, activar WP_DEBUG y ver debug.log es más detallado, pero para el día a día, error_log es suficiente.

Conclusión: Domina los logs y deja de temer a los errores

Saber ver error_log cPanel es una habilidad que te ahorrará muchísimo tiempo y dolores de cabeza. Ya no tendrás que esperar a que un técnico te responda o probar soluciones a ciegas. Con este conocimiento, podrás:

Identificar rápidamente qué plugin o tema está fallando.
Saber si el problema es de memoria o de código.
Actuar con rapidez para restaurar tu sitio web.

La próxima vez que veas un error en tu WordPress, no entres en pánico. Ve a tu cPanel, abre el error_log, respira hondo y lee lo que te dice. Esa información es oro puro. Y recuerda, si tu hosting usa Syspanel, el acceso es por el puerto 2106, pero la lógica es exactamente la misma. ¡Ahora ya tienes la llave para diagnosticar los errores de tu web como un profesional!