Los problemas en WordPress suelen deberse a plugins o temas de­fe­c­tuo­sos, errores en el código o la base de datos, una co­n­fi­gu­ra­ción in­co­rre­c­ta del servidor, archivos dañados o problemas con la caché. Algunas so­lu­cio­nes ha­bi­tua­les consisten en des­ac­ti­var ex­te­n­sio­nes so­s­pe­cho­sas, revisar los registros de errores, los permisos de los archivos y los límites del servidor, así como restaurar una copia de seguridad o utilizar el modo de re­cu­pe­ra­ción.

Resumen

Muchos de los errores más ha­bi­tua­les de WordPress se pueden so­lu­cio­nar con unos pocos pasos. En este artículo se abordan las si­guie­n­tes causas y so­lu­cio­nes:

  • White Screen of Death: utilizar el modo de re­cu­pe­ra­ción, des­ac­ti­var plugins, corregir errores de código y activar el modo de de­pu­ra­ción
  • 500 Internal Server Error: comprobar si hay un archivo .htaccess dañado, memoria PHP in­su­fi­cie­n­te o archivos del núcleo dañados
  • Error al conectar con la base de datos: revisar los datos de acceso en wp-config.php, reparar la base de datos y pedir a tu proveedor de hosting que compruebe el servidor de la base de datos
  • Co­n­ne­c­tion timed out: revisar la carga del servidor, los plugins, el límite de memoria PHP y el tiempo máximo de ejecución
  • WordPress no guarda los cambios: vaciar la caché del navegador, la del plugin de caché y la del servidor
  • Otros errores: modo de ma­n­te­ni­mie­n­to tras una ac­tua­li­za­ción, errores de sintaxis, ac­tua­li­za­cio­nes au­to­má­ti­cas fallidas, problemas al subir imágenes y barra lateral debajo del contenido

1. White Screen of Death: WordPress solo muestra una pantalla en blanco

Antes, cuando se producían errores graves, WordPress mostraba a menudo úni­ca­me­n­te una pantalla en blanco, de ahí el término algo dramático “White Screen of Death”. Hoy en día, WordPress ofrece más in­fo­r­ma­ción en muchos casos, por ejemplo mediante mensajes de error concretos o el modo de re­cu­pe­ra­ción.

La pantalla en blanco en WordPress (White Screen of Death) puede deberse a distintas causas, como plugins que no funcionan co­rre­c­ta­me­n­te, problemas con PHP y diversos errores en el código o la base de datos. Por eso, es re­co­me­n­da­ble ide­n­ti­fi­car la causa exacta del error.

Modo de re­cu­pe­ra­ción: primer punto de partida ante errores críticos

Desde la versión 5.2, WordPress cuenta con un modo de re­cu­pe­ra­ción integrado que se activa au­to­má­ti­ca­me­n­te ante de­te­r­mi­na­dos errores críticos. Si se produce un error grave de PHP, WordPress muestra un aviso general en lugar de una pantalla en blanco y envía un correo ele­c­tró­ni­co a la dirección de ad­mi­ni­s­tra­ción. Este correo incluye un enlace de un solo uso que te permite iniciar sesión en el backend a pesar del error. Allí, WordPress indica qué plugin o tema está causando el problema y te permite des­ac­ti­var di­re­c­ta­me­n­te la extensión afectada.

El modo de re­cu­pe­ra­ción solo funciona si WordPress puede detectar el error a tiempo. Si el fallo de PHP se produce antes de que el sistema pueda in­te­r­ve­nir, es posible que no se envíe ningún correo ele­c­tró­ni­co. En esas si­tua­cio­nes, tendrás que corregir el error ma­nua­l­me­n­te mediante SFTP (pre­fe­ri­ble­me­n­te), FTP o el ad­mi­ni­s­tra­dor de archivos, como se explica en los apartados si­guie­n­tes.

Origen del error 1: plugins

A menudo, la pantalla en blanco en WordPress aparece después de realizar alguna de las si­guie­n­tes acciones:

  • Has activado un plugin que no funciona co­rre­c­ta­me­n­te.
  • Has cambiado la co­n­fi­gu­ra­ción de un plugin activo.
  • Has mo­di­fi­ca­do el código de un plugin activo.

Si has realizado re­cie­n­te­me­n­te alguno de estos cambios, ve a la página de plugins de WordPress y desactiva el plugin que hayas mo­di­fi­ca­do o activado por última vez. En muchos casos, esto basta para resolver el problema.

Si ya no puedes acceder al panel de control de WordPress, puedes recurrir al modo de re­cu­pe­ra­ción de WordPress, siempre que hayas recibido el correo ele­c­tró­ni­co co­rre­s­po­n­die­n­te. Si tampoco es posible, tendrás que acceder a los archivos de WordPress mediante SFTP, FTP o el ad­mi­ni­s­tra­dor de archivos de tu hosting para des­ac­ti­var los plugins ma­nua­l­me­n­te. Para ello, sigue estos pasos:

  1. Abre el di­re­c­to­rio en el que están guardados tus archivos de WordPress.
  2. Abre la carpeta wp-content.
  3. Dentro de wp-content, localiza la carpeta plugins.
  4. Cambia el nombre de la carpeta plugins para des­ac­ti­var todos los plugins a la vez.

Origen del error 2: errores de código

Si el problema no se debe a un plugin, también puede aparecer después de modificar el archivo functions.php u otro archivo PHP mediante el editor de archivos de temas de WordPress. En estos casos, WordPress suele mostrar un mensaje de error concreto o activar el modo de re­cu­pe­ra­ción. Un mensaje típico sería, por ejemplo, el siguiente:

Parse error: syntax error, unexpected end of file in /home/name/public_html/wordpress/wp-content/themes/your_theme/functions.php on line 231
text

Esto significa que hay un error en el código del archivo indicado. Como co­n­se­cue­n­cia, el tema que has elegido o el framework de WordPress puede dejar de funcionar co­rre­c­ta­me­n­te. En este caso, tendrás que restaurar una versión funcional del archivo afectado.

Si no puedes acceder al panel de WordPress, puedes sustituir el archivo con errores mediante FTP o el ad­mi­ni­s­tra­dor de archivos de tu hosting:

  1. Abre el di­re­c­to­rio en el que se en­cue­n­tran tus archivos de WordPress.
  2. Abre la carpeta wp-content.
  3. Dentro de wp-content, abre la carpeta de temas (themes).
  4. Abre la carpeta de tu tema activo.
  5. Busca el archivo afectado.
  6. Sube una versión funcional del archivo, ya sea desde una copia de seguridad o desde la versión original del tema.

Como al­te­r­na­ti­va, puedes des­ac­ti­var te­m­po­ra­l­me­n­te el tema cambiando el nombre de su carpeta o activar otro tema. Si hay instalado un tema pre­de­te­r­mi­na­do de WordPress, el sistema puede recurrir a él au­to­má­ti­ca­me­n­te. A co­n­ti­nua­ción, vuelve al navegador y actualiza tu página web.

Origen del error de­s­co­no­ci­do

A veces, la pantalla en blanco en WordPress aparece sin una causa evidente: no has mo­di­fi­ca­do ningún plugin ni has cambiado el código de tu tema. En estos casos, es im­po­r­ta­n­te proceder de forma si­s­te­má­ti­ca. Una opción es­pe­cia­l­me­n­te útil es WP_DEBUG: activa el modo de de­pu­ra­ción para obtener mensajes de error más concretos. Así podrás ide­n­ti­fi­car los archivos o líneas de código que están causando el problema.

Para ello, abre el archivo wp-config.php en el di­re­c­to­rio principal de tu in­s­ta­la­ción de WordPress y añade las si­guie­n­tes líneas:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
php

Con WP_DEBUG_LOG, los mensajes de error se guardan en el archivo wp-content/debug.log. WP_DEBUG_DISPLAY debe ma­n­te­ne­r­se en false para que los errores no se muestren pú­bli­ca­me­n­te en la página web. Esto es es­pe­cia­l­me­n­te im­po­r­ta­n­te en páginas web en pro­du­c­ción, ya que la in­fo­r­ma­ción de de­pu­ra­ción puede revelar datos sensibles, como rutas del sistema o detalles de la co­n­fi­gu­ra­ción del servidor. Puedes analizar los errores di­re­c­ta­me­n­te en el archivo de registro, al que puedes acceder mediante SFTP, FTP o el ad­mi­ni­s­tra­dor de archivos. Una vez fi­na­li­za­do el análisis, debes des­ac­ti­var de nuevo el modo de de­pu­ra­ción poniendo las tres opciones en false.

Además de los plugins y los errores de código, existen otras causas menos evidentes que también pueden provocar una pantalla en blanco en WordPress:

  • Caché: si utilizas un plugin de caché, puede que baste con vaciar la caché de la página web. Si no puedes acceder a WordPress para hacerlo, borra también la caché del navegador para descartar que el problema se deba a contenido al­ma­ce­na­do lo­ca­l­me­n­te.
  • Archivos dañados: es posible que algunos archivos de WordPress estén dañados, por ejemplo, debido a malware. En ese caso, ponte en contacto con tu proveedor de hosting para solicitar un dia­g­nó­s­ti­co y de­te­r­mi­nar la causa.
  • Problemas del servidor: si el servidor está so­bre­ca­r­ga­do o te­m­po­ra­l­me­n­te no di­s­po­ni­ble, también puede aparecer una pantalla en blanco en WordPress. Revisa tu correo ele­c­tró­ni­co por si tu proveedor de hosting te ha enviado algún aviso o ponte en contacto con el servicio de soporte.

2. Error interno del servidor: 500 Internal Server Error

El mensaje de error 500 Internal Server Error es uno de los errores de servidor más ha­bi­tua­les. En WordPress, suele deberse a plugins o a problemas con los temas. Otras posibles causas son un archivo .htaccess dañado o un límite de memoria PHP in­su­fi­cie­n­te. Los errores internos del servidor también pueden afectar úni­ca­me­n­te al área de ad­mi­ni­s­tra­ción de WordPress, mientras que el resto de la página web sigue fu­n­cio­na­n­do co­rre­c­ta­me­n­te.

Nota

Desde WordPress 5.2 existe además una pro­te­c­ción integrada frente a errores graves de PHP. En estos casos, en lugar de aparecer un error 500 clásico, puede mostrarse un aviso de error crítico o enviarse un correo ele­c­tró­ni­co con un enlace de re­cu­pe­ra­ción.

Origen del error 1: archivo .htaccess dañado

Una causa frecuente del mensaje de error “500 Internal Server Error” es un archivo .htaccess dañado. Por eso, conviene comprobar primero si este archivo es el re­s­po­n­sa­ble: inicia sesión en tu servidor mediante SFTP, FTP o a través del ad­mi­ni­s­tra­dor de archivos de tu proveedor de hosting. Ve al di­re­c­to­rio raíz de WordPress y busca el archivo .htaccess. Cámbiale el nombre te­m­po­ra­l­me­n­te y, a co­n­ti­nua­ción, recarga la página web. Si vuelve a funcionar, es muy probable que el archivo .htaccess fuera la causa del problema.

A co­n­ti­nua­ción, puedes generar de nuevo las reglas de .htaccess iniciando sesión en el backend de WordPress y ac­ce­die­n­do a “Ajustes” → “Enlaces pe­r­ma­ne­n­tes”. Guarda de nuevo la co­n­fi­gu­ra­ción. Si WordPress tiene permisos de escritura sobre el archivo, ac­tua­li­za­rá au­to­má­ti­ca­me­n­te las reglas co­rre­s­po­n­die­n­tes.

Origen del error 2: memoria PHP in­su­fi­cie­n­te

Un 500 Internal Server Error puede pro­du­ci­r­se cuando WordPress o un plugin necesita más memoria PHP de la que tiene di­s­po­ni­ble en el servidor. A menudo en­co­n­tra­rás indicios en el registro de errores, con mensajes como “Allowed memory size exhausted”.

Para analizar el problema, activa el modo de de­pu­ra­ción de WordPress y registra los errores en un archivo. Si se confirma que la causa es la memoria di­s­po­ni­ble, puede ayudar aumentar el valor de WP_MEMORY_LIMIT en el archivo wp-config.php, siempre que los límites es­ta­ble­ci­dos por el servidor lo permitan. Además, conviene revisar los plugins y temas, ya que un consumo de memoria inu­sua­l­me­n­te alto puede deberse a una sola extensión y provocar otros problemas en WordPress, como una pantalla en blanco en WordPress.

Origen del error 3: archivos del núcleo dañados

Aunque no es muy frecuente, algunos archivos dañados del núcleo de WordPress también pueden provocar un error interno del servidor. En ese caso, puedes sustituir los archivos del núcleo por copias nuevas para eliminar la posible causa del error.

Antes de hacerlo, crea una copia de seguridad de la página web y la base de datos. A co­n­ti­nua­ción, descarga una copia nueva de WordPress y accede a tu servidor mediante SFTP, FTP o el ad­mi­ni­s­tra­dor de archivos. Sustituye las carpetas wp-admin y wp-includes por las de la copia nueva y reemplaza también los archivos del núcleo situados en el di­re­c­to­rio raíz. No elimines ni su­s­ti­tu­yas la carpeta wp-content ni el archivo wp-config.php, ya que contienen, re­s­pe­c­ti­va­me­n­te, los temas, plugins y otros co­n­te­ni­dos de la in­s­ta­la­ción, así como su co­n­fi­gu­ra­ción.

3. Error al conectar con la base de datos: Error es­ta­bli­shi­ng a database co­n­ne­c­tion

El mensaje “Error es­ta­bli­shi­ng a database co­n­ne­c­tion” significa que WordPress no puede es­ta­ble­cer una conexión con la base de datos. Sin esta conexión, la página web no puede cargar co­rre­c­ta­me­n­te sus co­n­te­ni­dos ni el backend. La causa puede estar en unos datos de acceso in­co­rre­c­tos en wp-config.php, un host de base de datos erróneo o un problema con el servidor de la base de datos. WordPress utiliza pre­ci­sa­me­n­te los valores DB_NAME, DB_USER, DB_PASSWORD y DB_HOST de wp-config.php para es­ta­ble­cer esta conexión.

Origen del error 1: ajustes de conexión in­co­rre­c­tos

Revisa primero los datos de acceso en el archivo wp-config.php. Estos cuatro pa­rá­me­tros son fu­n­da­me­n­ta­les:

define( 'DB_NAME', 'nombre_de_base_de_datos' );
define( 'DB_USER', 'usuario_de_base_de_datos' );
define( 'DB_PASSWORD', 'contraseña' );
define( 'DB_HOST', 'localhost' );
php

Basta un pequeño error ti­po­grá­fi­co en el nombre de la base de datos, el nombre de usuario, la co­n­tra­se­ña o el host para que WordPress no pueda es­ta­ble­cer la conexión. Por ejemplo, después de una migración puede ocurrir que no se haya ac­tua­li­za­do el host de la base de datos o la co­n­tra­se­ña.

El valor de DB_HOST suele ser localhost, pero no siempre. Algunos pro­vee­do­res de hosting utilizan un nombre de host o una dirección es­pe­cí­fi­cos para el servidor de la base de datos. En esos casos, debes in­tro­du­cir el valor que te haya pro­po­r­cio­na­do tu proveedor. De­pe­n­die­n­do de la co­n­fi­gu­ra­ción, DB_HOST también puede contener una dirección IP y un puerto.

Origen del error 2: la base de datos está dañada

Este error no es idéntico a “Error es­ta­bli­shi­ng a database co­n­ne­c­tion”, pero está re­la­cio­na­do. A veces, el frontend de tu página web funciona co­rre­c­ta­me­n­te, pero al acceder al backend aparece un mensaje indicando que una o varias tablas de la base de datos no están di­s­po­ni­bles. En ese caso, puede que sea necesario reparar la base de datos.

Antes de realizar cambios, crea una copia de seguridad completa de la base de datos. A co­n­ti­nua­ción, abre el archivo wp-config.php y añade la siguiente línea:

define( 'WP_ALLOW_REPAIR', true );
php

Guarda el archivo wp-config.php y súbelo de nuevo al servidor si lo has editado lo­ca­l­me­n­te. Después, abre la siguiente dirección en el navegador:

https://www.tu-dominio.es/wp-admin/maint/repair.php

En la página en­co­n­tra­rás dos opciones: Reparar base de datos y Reparar y optimizar la base de datos. WordPress permite acceder a esta función sin iniciar sesión cuando WP_ALLOW_REPAIR está activado, pre­ci­sa­me­n­te porque una base de datos dañada puede impedir el acceso al backend.

Se­le­c­cio­na la opción de re­pa­ra­ción y, una vez fi­na­li­za­do el proceso, comprueba si tanto la página web como el backend vuelven a funcionar co­rre­c­ta­me­n­te.

Nota

Después de la re­pa­ra­ción, elimina de nuevo la línea WP_ALLOW_REPAIR de wp-config.php o desactiva esta función. Mientras esté ha­bi­li­ta­da, se puede acceder a la página de re­pa­ra­ción sin iniciar sesión, por lo que WordPress re­co­mie­n­da activarla úni­ca­me­n­te cuando sea necesaria y des­ac­ti­var­la después.

Origen del error 3: el servidor de base de datos no está di­s­po­ni­ble

Este problema puede pro­du­ci­r­se si el servidor de la base de datos de tu proveedor de hosting está so­bre­ca­r­ga­do, presenta una avería o no está di­s­po­ni­ble te­m­po­ra­l­me­n­te. Un aumento im­po­r­ta­n­te del tráfico también puede co­n­tri­buir a alcanzar los límites de recursos del servicio de hosting, de­pe­n­die­n­do de la in­frae­s­tru­c­tu­ra y del plan co­n­tra­ta­do.

Para co­m­pro­bar­lo, ponte en contacto con el servicio de soporte de tu proveedor de hosting y pide que ve­ri­fi­quen el estado del servidor de la base de datos. También puedes revisar si el proveedor ha co­mu­ni­ca­do alguna in­ci­de­n­cia o un ma­n­te­ni­mie­n­to pro­gra­ma­do.

4. Tiempo de conexión agotado: Co­n­ne­c­tion timed out

El mensaje “Co­n­ne­c­tion timed out” significa que una solicitud no ha podido co­m­ple­tar­se dentro del tiempo previsto. En WordPress, esto puede ocurrir cuando el servidor, un plugin, un tema o un servicio externo tarda demasiado en responder.

Origen del error 1: el servidor está so­bre­ca­r­ga­do

Una de las causas más fre­cue­n­tes es la so­bre­ca­r­ga del servidor. Esto puede ocurrir, por ejemplo, en planes de hosting co­m­pa­r­ti­do, cuando se reciben de­ma­sia­das so­li­ci­tu­des si­mu­l­tá­neas o hay procesos que consumen muchos recursos. Si el servidor no responde a tiempo, el navegador, el servidor web o un proceso de WordPress puede in­te­rru­m­pir la solicitud y generar un timeout.

Origen del error 2: plugins o temas de­fe­c­tuo­sos

Los plugins y temas pueden provocar timeouts si realizan de­ma­sia­das consultas, ejecutan procesos que consumen muchos recursos o llaman a servicios externos que no responden a tiempo. Desactiva te­m­po­ra­l­me­n­te todos los plugins y comprueba si el error des­apa­re­ce. Después, ve ac­ti­vá­n­do­los de nuevo uno a uno para ide­n­ti­fi­car el posible causante. Si es necesario, cambia también te­m­po­ra­l­me­n­te a un tema pre­de­te­r­mi­na­do de WordPress para descartar que el problema esté re­la­cio­na­do con el tema activo.

Origen del error 3: límite de memoria PHP in­su­fi­cie­n­te

Si la memoria PHP di­s­po­ni­ble no es su­fi­cie­n­te, de­te­r­mi­na­dos procesos pueden in­te­rru­m­pi­r­se o fallar. En estos casos, puede ayudar aumentar el límite de memoria de WordPress en el archivo wp-config.php. WordPress establece por defecto un límite de 40 MB para in­s­ta­la­cio­nes in­di­vi­dua­les y de 64 MB para in­s­ta­la­cio­nes mu­l­ti­si­tio, siempre dentro de los límites pe­r­mi­ti­dos por la co­n­fi­gu­ra­ción de PHP. Si necesitas más memoria, puedes es­ta­ble­cer, por ejemplo:

define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '256M' );
php

Ten en cuenta que estos valores no pueden superar el límite de memoria es­ta­ble­ci­do por el servidor. Si tu plan de hosting no permite au­me­n­tar­lo hasta el valor deseado, tendrás que ponerte en contacto con tu proveedor para comprobar qué límites admite tu alo­ja­mie­n­to.

Origen del error 4: tiempo máximo de ejecución de PHP demasiado bajo

Un timeout también puede pro­du­ci­r­se cuando un script PHP necesita más tiempo para eje­cu­tar­se del permitido por el servidor. En estos casos, puede aparecer un mensaje como “Maximum execution time of 30 seconds exceeded”. El ajuste co­rre­s­po­n­die­n­te se denomina max_execution_time y puede definirse en el archivo php.ini. Este parámetro determina durante cuántos segundos puede eje­cu­tar­se un script antes de que PHP lo detenga. En muchos entornos web, el valor pre­de­te­r­mi­na­do es de 30 segundos, aunque puede variar según la co­n­fi­gu­ra­ción del servidor.

Si de­te­r­mi­na­das ope­ra­cio­nes, como im­po­r­ta­cio­nes, subidas de archivos grandes, ac­tua­li­za­cio­nes o plugins que requieren muchos recursos, superan re­gu­la­r­me­n­te este límite, puede resultar útil au­me­n­tar­lo. En el archivo php.ini, por ejemplo:

max_execution_time = 60
ini

5. WordPress no guarda los cambios

Si WordPress no muestra los cambios, eso no significa ne­ce­sa­ria­me­n­te que no se hayan guardado. A menudo, el problema es que sigues viendo una versión antigua de la página web al­ma­ce­na­da en caché. Las causas más fre­cue­n­tes son la caché del navegador, un plugin de caché, la caché del servidor de tu proveedor de hosting o una CDN.

Solución 1: recargar la página por completo

Los na­ve­ga­do­res guardan co­n­te­ni­dos en caché para que las páginas carguen más rápido en visitas po­s­te­rio­res. Por eso, prueba primero a realizar una ac­tua­li­za­ción forzada. En Windows suele funcionar con [Ctrl] + [F5] o [Ctrl] + [Shift] + [R], y en Mac no­r­ma­l­me­n­te con [Cmd] + [Shift] + [R].

Solución 2: vaciar la caché del navegador

Si la ac­tua­li­za­ción forzada no ayuda, vacía por completo la caché del navegador. Esto puede ser útil cuando el navegador sigue cargando archivos como hojas de estilo, Ja­va­S­cri­pt o imágenes de una versión anterior. Después, abre de nuevo la página y comprueba si se muestran los cambios. Este paso es es­pe­cia­l­me­n­te im­po­r­ta­n­te si has mo­di­fi­ca­do el CSS, archivos del tema o ajustes de diseño.

Solución 3: borrar la caché en WordPress o en el hosting

Si la versión antigua sigue apa­re­cie­n­do, es posible que el problema no esté en el navegador, sino en otra capa de caché. Muchas páginas web de WordPress utilizan sistemas adi­cio­na­les de caché, por ejemplo mediante plugins, la caché del servidor del proveedor de hosting o una CDN. Estos sistemas sirven versiones al­ma­ce­na­das en caché para acelerar la carga de la página, por lo que los cambios pueden tardar en mostrarse aunque se hayan guardado co­rre­c­ta­me­n­te.

Borra, por tanto, su­ce­si­va­me­n­te:

  • la caché de tu plugin de caché
  • la caché del servidor de tu proveedor de hosting
  • la caché de la CDN, si utilizas una

Muchos pro­vee­do­res de hosting ofrecen para ello una función como “Vaciar caché”, “Purge Cache” o “Flush Cache” en el panel de cliente o di­re­c­ta­me­n­te en el panel de WordPress.

Solución 4: comprobar el guardado de cambios en el editor

Si no solo se muestran co­n­te­ni­dos antiguos, sino que los cambios rea­li­za­dos en el propio editor no se guardan, también puede haber un problema durante el proceso de guardado. Esto es es­pe­cia­l­me­n­te relevante en el editor de bloques, ya que WordPress utiliza Ja­va­S­cri­pt y la REST API para procesar y guardar de­te­r­mi­na­dos co­n­te­ni­dos. Si se produce un error, es posible que los cambios no se guarden co­rre­c­ta­me­n­te.

En estos casos, desactiva te­m­po­ra­l­me­n­te todos los plugins y comprueba si el problema persiste.

Solución 5: comprobar la subida y la ruta

Si has realizado cambios di­re­c­ta­me­n­te en archivos, por ejemplo en archivos CSS, pla­n­ti­llas o archivos del tema, comprueba también que el archivo mo­di­fi­ca­do se haya subido realmente al servidor y que se encuentre en la carpeta correcta. Es re­la­ti­va­me­n­te frecuente editar el archivo adecuado en local, pero mantener una versión antigua en el servidor o so­bre­s­cri­bir por error un archivo distinto.

Es­pe­cia­l­me­n­te si utilizas un tema hijo o hay varias versiones de un mismo tema en el servidor, conviene revisar cui­da­do­sa­me­n­te la ruta del archivo.

6. Modo de ma­n­te­ni­mie­n­to pe­r­si­s­te­n­te después de una ac­tua­li­za­ción

Si una ac­tua­li­za­ción de WordPress se in­te­rru­m­pe, tu página web puede mostrar de forma pe­r­ma­ne­n­te el mensaje: “Briefly una­vai­la­ble for scheduled mai­n­te­na­n­ce. Check back in a minute.” La causa suele ser un archivo llamado .maintenance, que WordPress crea au­to­má­ti­ca­me­n­te en el di­re­c­to­rio raíz durante una ac­tua­li­za­ción. No­r­ma­l­me­n­te, este archivo se elimina al finalizar el proceso. Si eso no ocurre, la página puede quedarse bloqueada en modo de ma­n­te­ni­mie­n­to.

La solución, en la mayoría de los casos, es sencilla:

  1. Inicia sesión mediante SFTP, FTP o el ad­mi­ni­s­tra­dor de archivos de tu proveedor de hosting.
  2. Abre el di­re­c­to­rio principal de tu in­s­ta­la­ción de WordPress, es decir, la carpeta en la que también se encuentra el archivo wp-config.php.
  3. Elimina el archivo .maintenance y, a co­n­ti­nua­ción, recarga la página web.

Si el problema persiste, es probable que no se deba úni­ca­me­n­te al archivo .maintenance, sino que la propia ac­tua­li­za­ción haya fallado. En ese caso, comprueba qué plugin, tema o versión del núcleo de WordPress se estaba ac­tua­li­za­n­do cuando se produjo el error e intenta realizar de nuevo la ac­tua­li­za­ción o re­in­s­ta­lar ma­nua­l­me­n­te el co­m­po­ne­n­te afectado. También conviene revisar los registros del servidor o los registros de errores de WordPress, ya que pueden indicar por qué se in­te­rru­m­pió la ac­tua­li­za­ción.

New call-to-action

7. Errores de sintaxis

Un error de sintaxis suele deberse a un fallo pequeño, pero decisivo, en el código. Una coma que falta o un pa­ré­n­te­sis mal colocado puede in­te­rru­m­pir por completo la ejecución de un script. A menudo, el error aparece después de insertar código ma­nua­l­me­n­te en un archivo del tema, en functions.php, en un plugin o en un snippet propio. En muchos casos, el mensaje de error ya indica el archivo afectado y el número de línea, lo que facilita localizar la parte que debes revisar.

Para corregir el error de sintaxis, tienes que editar el fragmento de código que lo está pro­vo­ca­n­do. Puedes eli­mi­nar­lo por completo o corregir la sintaxis. Lo más sencillo es hacerlo mediante SFTP, FTP, desde el ad­mi­ni­s­tra­dor de archivos de tu proveedor de hosting o mediante cualquier otra forma de acceso directo al archivo afectado.

Desde WordPress 5.2, además, el modo de re­cu­pe­ra­ción puede ayudarte: en muchos casos, WordPress muestra un mensaje de error en lugar de una página en blanco en WordPress y envía por correo ele­c­tró­ni­co un enlace de re­cu­pe­ra­ción a la dirección de ad­mi­ni­s­tra­ción.

8. Ac­tua­li­za­ción au­to­má­ti­ca fallida: Update failed

WordPress instala muchas ac­tua­li­za­cio­nes menores y de seguridad au­to­má­ti­ca­me­n­te en segundo plano. Si una de estas ac­tua­li­za­cio­nes falla, puede aparecer un mensaje como “Update failed” o dejar de co­m­ple­tar­se co­rre­c­ta­me­n­te la ac­tua­li­za­ción de WordPress, un plugin o un tema.

Comprueba primero qué co­m­po­ne­n­te se estaba ac­tua­li­za­n­do cuando se produjo el error e intenta ejecutar de nuevo la ac­tua­li­za­ción. Si WordPress se ha quedado bloqueado en modo de ma­n­te­ni­mie­n­to, elimina el archivo .maintenance como se explica en el apartado anterior. Si el fallo se repite, puedes realizar la ac­tua­li­za­ción ma­nua­l­me­n­te y revisar los registros de errores para de­te­r­mi­nar la causa.

Nota

Si durante la ac­tua­li­za­ción aparece un mensaje como “No ha sido posible crear el di­re­c­to­rio”, comprueba si WordPress tiene permisos de escritura en la carpeta afectada. Para ello, revisa los permisos y el pro­pie­ta­rio de los archivos y carpetas co­rre­s­po­n­die­n­tes.

9. Problemas al subir imágenes en WordPress

Si no puedes subir imágenes en WordPress, la causa no siempre está di­re­c­ta­me­n­te en WordPress. A menudo, el problema se debe a permisos de archivos in­co­rre­c­tos, límites del servidor in­su­fi­cie­n­tes, errores en el pro­ce­sa­mie­n­to de imágenes o co­n­fli­c­tos con plugins. Los formatos de imagen modernos como WebP y AVIF también pueden dar problemas si el entorno del servidor no dispone de la co­m­pa­ti­bi­li­dad necesaria.

Un primer vistazo a “He­rra­mie­n­tas” → “Salud del sitio” → “In­fo­r­ma­ción” puede resultar útil. Allí en­co­n­tra­rás, entre otros datos, in­fo­r­ma­ción sobre el pro­ce­sa­mie­n­to de medios, las subidas de archivos, los permisos del sistema de archivos y el entorno del servidor. Así podrás comprobar si WordPress dispone de los re­qui­si­tos ne­ce­sa­rios para procesar imágenes o si hay indicios de un problema en la co­n­fi­gu­ra­ción del servidor.

Solución 1: comprobar los permisos de archivos

Si sospechas que los permisos son la causa del problema, conéctate a la página web mediante FTP, SFTP o el ad­mi­ni­s­tra­dor de archivos de tu proveedor de hosting y abre la carpeta /wp-content/. Dentro en­co­n­tra­rás el di­re­c­to­rio /uploads/.

Comprueba primero los permisos del di­re­c­to­rio uploads y de sus su­b­ca­r­pe­tas. En muchas co­n­fi­gu­ra­cio­nes, los di­re­c­to­rios utilizan permisos 755 o 750 y los archivos 644 o 640. La co­n­fi­gu­ra­ción adecuada puede variar según el entorno del servidor, por lo que no debes modificar los permisos si no es necesario.

Solución 2: comprobar la co­n­fi­gu­ra­ción del servidor

Otra causa frecuente de los problemas al subir imágenes son unos límites del servidor demasiado bajos. Entre los pa­rá­me­tros de PHP re­le­va­n­tes se en­cue­n­tran upload_max_filesize, post_max_size, memory_limit y el tiempo máximo de ejecución. Estos valores pueden limitar el tamaño de los archivos que se suben y los recursos di­s­po­ni­bles para procesar las imágenes.

Comprueba primero en el panel de hosting o en la in­fo­r­ma­ción de PHP los valores actuales. En pa­r­ti­cu­lar:

  • upload_max_filesize debe ser su­fi­cie­n­te para el tamaño de las imágenes que quieras subir.
  • post_max_size debe ser igual o superior a upload_max_filesize.
  • memory_limit debe pro­po­r­cio­nar su­fi­cie­n­te memoria para procesar las imágenes, es­pe­cia­l­me­n­te si son de alta re­so­lu­ción o WordPress tiene que generar varios tamaños.

No existe un valor mínimo universal adecuado para todas las in­s­ta­la­cio­nes. Si no tienes acceso directo a estos ajustes o los límites de tu plan de hosting son in­su­fi­cie­n­tes, ponte en contacto con tu proveedor.

Solución 3: formatos de imagen modernos

Si los archivos JPG o PNG funcionan, pero los archivos WebP o AVIF no, el problema suele estar en la co­m­pa­ti­bi­li­dad del entorno de hosting con el pro­ce­sa­mie­n­to de estos formatos. WordPress es co­m­pa­ti­ble con WebP desde la versión 5.8 y con AVIF desde la versión 6.5, sin necesidad de un plugin adicional, siempre que el servidor también sea co­m­pa­ti­ble con el formato co­rre­s­po­n­die­n­te.

Para utilizar AVIF, la bi­blio­te­ca de pro­ce­sa­mie­n­to de imágenes di­s­po­ni­ble en el servidor, como GD o Imagick, debe ser co­m­pa­ti­ble con este formato. Puedes co­m­pro­bar­lo en “He­rra­mie­n­tas” → “Salud del sitio” → “In­fo­r­ma­ción”, en el apartado dedicado al pro­ce­sa­mie­n­to de medios. Si falta esta co­m­pa­ti­bi­li­dad, pueden pro­du­ci­r­se errores al subir archivos AVIF o al generar au­to­má­ti­ca­me­n­te los distintos tamaños de imagen.

10. La barra lateral aparece debajo del contenido principal

Si la barra lateral de WordPress se muestra debajo del contenido principal en lugar de al lado, no­r­ma­l­me­n­te hay un problema con el diseño. La página puede parecer des­or­de­na­da o incluso “rota”, pero por lo general es posible co­rre­gi­r­la con unos pocos ajustes.

Antes de buscar un error, conviene comprobar el contexto: no siempre se trata de un fallo. Muchos temas modernos desplazan de forma in­te­n­cio­na­da la barra lateral debajo del contenido en pantallas pequeñas para mejorar la le­gi­bi­li­dad en di­s­po­si­ti­vos móviles. Por eso, comprueba primero si el problema también aparece en or­de­na­do­res de es­cri­to­rio o solo con anchos de pantalla más reducidos.

Causas fre­cue­n­tes de este problema

Una causa habitual es un código HTML in­co­rre­c­to, por ejemplo, debido a elementos que no se han cerrado co­rre­c­ta­me­n­te. En estos casos, la es­tru­c­tu­ra de la página puede verse alterada y la barra lateral dejar de colocarse junto al contenido. También pueden ser re­s­po­n­sa­bles las de­cla­ra­cio­nes CSS in­co­rre­c­tas o co­n­tra­di­c­to­rias. Si el contenido principal y la barra lateral ocupan más espacio del previsto en el diseño, esta última puede de­s­pla­zar­se debajo del contenido. Esto puede deberse, entre otros, a los si­guie­n­tes factores:

  • Anchos demasiado grandes para el contenido o la barra lateral
  • Valores de padding o márgenes adi­cio­na­les
  • Valores max-width in­co­rre­c­tos
  • Ajustes in­co­rre­c­tos en diseños Flexbox o Grid

Los cambios en los archivos CSS o en el CSS pe­r­so­na­li­za­do también pueden alterar el diseño de forma ine­s­pe­ra­da.

Otra posible causa está en la es­tru­c­tu­ra del tema o de las pla­n­ti­llas. Los temas modernos de WordPress, es­pe­cia­l­me­n­te los temas de bloques, no utilizan ne­ce­sa­ria­me­n­te barras laterales clásicas, sino bloques de diseño o pla­n­ti­llas. Si, por ejemplo, has se­le­c­cio­na­do una plantilla de ancho completo o eliminado la barra lateral de la plantilla, esta dejará de aparecer junto al contenido.

Además, los plugins y los co­n­s­tru­c­to­res visuales pueden influir en el diseño. Las he­rra­mie­n­tas de op­ti­mi­za­ción del re­n­di­mie­n­to, la co­m­pre­sión CSS o los co­n­s­tru­c­to­res visuales pueden modificar la forma en que se procesa o muestra el CSS y provocar de manera in­vo­lu­n­ta­ria que la barra lateral se desplace.

Cómo ide­n­ti­fi­car la causa

Ve paso a paso para acotar el problema:

  1. Comprueba si solo aparece en di­s­po­si­ti­vos móviles y forma parte del diseño web ada­p­ta­ti­vo del tema.
  2. Comprueba si has se­le­c­cio­na­do otra plantilla de página, por ejemplo, “Estándar” en lugar de “Ancho completo”.
  3. Desactiva te­m­po­ra­l­me­n­te los plugins o co­n­s­tru­c­to­res visuales in­s­ta­la­dos re­cie­n­te­me­n­te.
  4. Revisa el código HTML pe­r­so­na­li­za­do para detectar elementos sin cerrar, por ejemplo, con un validador HTML.
  5. Revisa las pe­r­so­na­li­za­cio­nes de CSS, es­pe­cia­l­me­n­te los anchos, márgenes y ajustes de diseño.
  6. Comprueba si el problema persiste al cambiar te­m­po­ra­l­me­n­te a un tema pre­de­te­r­mi­na­do de WordPress.

Si, después de estos pasos, la barra lateral sigue apa­re­cie­n­do debajo del contenido, conviene revisar los archivos y las pla­n­ti­llas del tema o consultar la do­cu­me­n­ta­ción y el servicio de soporte del tema.

Ir al menú principal