Solución de problemas básicos en WordPress: dudas comunes resueltas

Introducción: Todos nos enfrentamos a problemas en WordPress

Si tienes una web con WordPress, es casi seguro que en algún momento te has topado con algún error que te ha dejado sin saber qué hacer. No te preocupes, es más común de lo que crees y, por suerte, la mayoría de los problemas tienen una solución sencilla que puedes aplicar tú mismo.

En este artículo, vamos a repasar las dudas más frecuentes sobre problemas WordPress, desde la temida pantalla blanca WordPress hasta errores de conexión, actualizaciones fallidas y contenido que no se muestra. Te explicaré paso a paso cómo hacer un troubleshooting WordPress básico, sin necesidad de ser un experto técnico.

El objetivo es que, cuando te encuentres con un error, sepas por dónde empezar a buscar la solución. Vamos allá.

¿Por qué aparecen errores en WordPress?

Antes de meternos en materia, es útil entender por qué ocurren estos fallos. Las causas más habituales son:

Plugin o tema incompatible: Una actualización de WordPress o de un plugin puede romper la compatibilidad con otro elemento de tu web.
Problemas de memoria: WordPress tiene un límite de memoria PHP. Si tu web usa muchos recursos, puede saturarse.
Archivos corruptos: Una actualización fallida o un ataque pueden dañar archivos del núcleo de WordPress.
Configuración del servidor: A veces el problema no es de WordPress, sino de la configuración de tu hosting.
Error humano: Modificar código sin saber lo que se hace (por ejemplo, en el archivo functions.php) puede provocar errores.

Saber esto te ayudará a enfocar la solución WordPress adecuada.

La temida pantalla blanca de la muerte (WSOD)

Este es, con diferencia, uno de los errores WordPress que más asusta a los usuarios. De repente, tu web se vuelve completamente blanca, sin texto, sin imágenes, sin nada. No entres en pánico. Aquí tienes una guía para solucionarlo.

¿Qué la causa?

La pantalla blanca WordPress suele deberse a un error de PHP que no se muestra. Las causas principales son:

Un plugin o tema defectuoso.
Límite de memoria PHP excedido.

Solución paso a paso

Accede a tu panel de control del hosting. Normalmente es cPanel, Plesk o Syspanel (que se accede por el puerto 2106). Busca el "Administrador de archivos".
Navega a la carpeta wp-content de tu instalación de WordPress.
Renombra la carpeta plugins a plugins_old. Esto desactivará todos los plugins.
Vuelve a cargar tu web. Si el problema se soluciona, el culpable era uno de los plugins.
Para identificar el plugin malo: Vuelve a renombrar la carpeta plugins_old a plugins. Luego, desde el escritorio de WordPress (si ya puedes acceder), ve a Plugins y reactívalos uno por uno, comprobando la web después de cada activación.
Si el problema persiste: Renombra la carpeta themes a themes_old. WordPress cargará un tema por defecto (Twenty Twenty-Four, por ejemplo). Si la web vuelve a funcionar, el problema es tu tema.

[TIP] Si no puedes acceder al administrador de archivos, puedes usar un cliente FTP como FileZilla. Las acciones son las mismas.

Error de conexión a la base de datos

Otro clásico. Verás un mensaje como: "Error al establecer una conexión a la base de datos". Esto significa que WordPress no puede comunicarse con la base de datos donde se almacena tu contenido.

Causas comunes

Datos de conexión incorrectos en el archivo wp-config.php.
La base de datos está caída o corrupta.
El servidor de base de datos está sobrecargado.

Solución WordPress para este error

Revisa el archivo wp-config.php. Accede a la raíz de tu WordPress (por FTP o administrador de archivos). Busca las siguientes líneas:
```
define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_base_datos');
define('DB_HOST', 'localhost');
```
Asegúrate de que los datos son correctos. El DB_HOST suele ser localhost, pero tu hosting puede usar otro (p.ej., mysql.tudominio.com).
Repara la base de datos. Añade esta línea a tu wp-config.php, justo antes de la línea que dice "That's all, stop editing!":
```
define('WP_ALLOW_REPAIR', true);
```
Luego, visita esta URL en tu navegador: tudominio.com/wp-admin/maint/repair.php. Verás una opción para "Reparar base de datos". Haz clic.
Elimina la línea que añadiste después de la reparación. Es un riesgo de seguridad dejarla activa.
Contacta a tu hosting. Si los datos son correctos y la reparación no funciona, el problema es del servidor. Ellos deben verificar que el servicio MySQL/MariaDB esté funcionando.

Error 404 en páginas y entradas

De repente, todas tus páginas dan error 404 (página no encontrada), excepto la página de inicio. Esto suele pasar después de cambiar la estructura de enlaces permanentes.

Solución: Regenerar los enlaces permanentes

Ve a Ajustes > Enlaces permanentes en tu escritorio de WordPress.
Simplemente selecciona una opción diferente (por ejemplo, "Número de página") y luego vuelve a seleccionar la que tenías antes (normalmente "Nombre de la entrada").
Haz clic en Guardar cambios.

Esto regenera las reglas de reescritura de WordPress y, en el 99% de los casos, soluciona el error 404.

[WARNING] Si esto no funciona, puede ser que tu servidor no tenga activado el módulo mod_rewrite de Apache. En ese caso, deberás contactar con tu proveedor de hosting.

Problemas con las actualizaciones (se queda colgado)

Intentas actualizar WordPress, un plugin o un tema y el proceso se queda en "Descargando..." o "Instalando..." para siempre. Esto puede deberse a:

Límite de memoria PHP insuficiente.
Conflictos de plugins.
Permisos de archivos incorrectos.

Cómo solucionarlo

Aumenta el límite de memoria PHP. Edita el archivo wp-config.php y añade esta línea:
```
define('WP_MEMORY_LIMIT', '256M');
```
Desactiva todos los plugins temporalmente. Como vimos en la pantalla blanca WordPress, renombra la carpeta plugins a plugins_old. Intenta la actualización de nuevo.
Actualiza manualmente. Si nada funciona, puedes hacer la actualización de forma manual:
- Descarga la última versión de WordPress desde wordpress.org.
- Extrae el archivo ZIP.
- Sube las carpetas wp-admin y wp-includes a tu servidor, sobrescribiendo las existentes. No toques la carpeta wp-content (ahí están tus plugins, temas y medios).
- Luego, sube todos los archivos de la raíz del ZIP (excepto wp-content) a la raíz de tu instalación.

El editor de bloques (Gutenberg) no carga o da error

El editor de WordPress se queda cargando, se vuelve lento o muestra un error en la consola del navegador.

Causas y soluciones

Conflicto de plugins: Desactiva todos los plugins. Si el editor funciona, reactívalos uno a uno para encontrar el culpable.
Caché del navegador: Limpia la caché de tu navegador o prueba en una ventana de incógnito.
Caché del servidor o plugin de caché: Si usas un plugin de caché (como WP Rocket o W3 Total Cache), purga toda la caché.
Error de JavaScript: A veces, un tema o plugin añade código JavaScript que interfiere. Revisa la consola de tu navegador (F12 > Consola) para ver si hay errores.

[INFO] Si ves un mensaje como "Se ha producido un error crítico en tu sitio web", activa el modo de depuración de WordPress para ver el error exacto. Añade esto a wp-config.php:

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

Luego, revisa el archivo wp-content/debug.log para encontrar el error específico.

El contenido no se actualiza (problema de caché)

Has hecho cambios en una página o entrada, pero al visitar la web sigues viendo la versión antigua. Esto es casi siempre un problema de caché.

Solución WordPress: Limpiar todas las cachés

Caché del navegador: Pulsa Ctrl + F5 (Windows) o Cmd + Shift + R (Mac) para forzar una recarga.
Caché del plugin: Si usas un plugin de caché, busca el botón "Vaciar caché" o "Purgar caché" en la barra de administración.
Caché del servidor: Algunos hostings (como los que usan Syspanel) tienen su propio sistema de caché. Busca en el panel de control (puerto 2106) una opción como "Limpiar caché de LiteSpeed" o "Purgar caché de Varnish".
CDN: Si usas un CDN (Cloudflare, etc.), también debes purgar su caché desde su panel.

Error "No se puede conectar a WordPress.org"

Este error aparece cuando intentas instalar un plugin o tema desde el repositorio oficial, o al buscar actualizaciones.

Causas

Tu servidor no puede hacer peticiones externas (outbound connections).
El firewall de tu hosting bloquea las conexiones.
Problemas con el archivo wp-config.php.

Solución

Verifica la conectividad de tu servidor. Puedes usar un plugin como "WP Healthcheck" para diagnosticar problemas de comunicación.
Comprueba tu archivo wp-config.php. Asegúrate de que no hay líneas que bloqueen peticiones, como:
```
define('WP_HTTP_BLOCK_EXTERNAL', true);
```
Si existe, cámbiala a false o elimínala.
Contacta a tu hosting. Ellos deben asegurarse de que el servidor puede acceder a api.wordpress.org y downloads.wordpress.org.

Preguntas Frecuentes (FAQ) sobre problemas WordPress

¿Cómo puedo saber qué versión de PHP tengo?

Ve a Herramientas > Salud del sitio en tu escritorio de WordPress. En la pestaña "Información", busca la sección "Servidor". Allí verás la versión de PHP.

¿Qué hago si no puedo acceder al escritorio de WordPress?

Puedes usar el administrador de archivos de tu hosting (o FTP) para desactivar plugins o temas manualmente, como explicamos en la pantalla blanca WordPress. También puedes añadir código al archivo functions.php de tu tema (por FTP) para desactivar temporalmente un plugin específico.

¿Es seguro aumentar el límite de memoria PHP?

Sí, es una práctica común y segura. WordPress recomienda al menos 64 MB, pero 128 MB o 256 MB es ideal para la mayoría de sitios.

¿Cada cuánto debo actualizar WordPress?

Siempre que haya una actualización de seguridad o de mantenimiento disponible. Las actualizaciones mayores (cambios de versión grande, como de 5.x a 6.0) puedes esperar unos días para asegurarte de que tus plugins y tema son compatibles.

Los problemas empezaron después de instalar un plugin. ¿Qué hago?

Desactiva ese plugin inmediatamente. Si no puedes acceder al escritorio, hazlo por FTP o administrador de archivos renombrando la carpeta del plugin en wp-content/plugins.

Consejos finales para un troubleshooting WordPress efectivo

Siempre haz una copia de seguridad antes de hacer cambios importantes (actualizaciones, modificar código, instalar plugins).
Anota los cambios que haces. Si algo deja de funcionar, sabrás por dónde empezar a mirar.
No modifiques archivos del núcleo de WordPress. Usa un tema hijo para personalizaciones y plugins para funcionalidades.
Mantén todo actualizado: WordPress, temas y plugins.
Usa un hosting de calidad. Un buen hosting resuelve muchos problemas WordPress de raíz.

[WARNING] Si después de intentar todas estas soluciones el error persiste, puede ser un problema más complejo (como un hackeo o un error de configuración del servidor). En ese caso, no dudes en contactar al soporte técnico de tu hosting o a un desarrollador especializado.

Espero que esta guía te haya sido de ayuda. Recuerda que la mayoría de los errores tienen solución y, con un poco de paciencia y siguiendo estos pasos, podrás resolverlos tú mismo. ¡Ánimo!