Errores comunes de WordPress: soluciones para administradores de sistemas

¿Tu sitio WordPress se ha vuelto lento, muestra una pantalla en blanco o no te deja acceder al panel de administración? No te preocupes, es más común de lo que crees. Como SysAdmin, estos problemas son parte del día a día, pero con un enfoque metódico y las herramientas adecuadas, puedes resolverlos rápidamente.

Esta guía te llevará paso a paso por los errores más frecuentes en WordPress y te enseñará cómo solucionarlos, incluso si no eres un experto en desarrollo. Al final, tendrás un checklist claro para diagnosticar y reparar tu sitio.

1. La temida "Pantalla Blanca" (White Screen of Death — WSoD)

Este es, probablemente, el error más frustrante. Accedes a tu web y solo ves un fondo blanco, sin mensajes de error. Es como si WordPress hubiera dejado de funcionar por completo.

¿Por qué ocurre?

Generalmente, se debe a un conflicto de plugins o temas, o a un límite de memoria de PHP agotado. Un plugin defectuoso o un tema mal codificado pueden forzar un error fatal que WordPress no puede mostrar.

Cómo solucionarlo paso a paso

Accede por FTP o cPanel (o Syspanel): Necesitas un gestor de archivos. Si usas Syspanel, accede por el puerto 2106 y ve a "Administrador de Archivos". Si usas FTP, conecta con FileZilla.
Desactiva todos los plugins: Ve a la carpeta wp-content y renombra la carpeta plugins a plugins_desactivados. Esto obliga a WordPress a ignorar todos los plugins.
Prueba tu web: Si vuelve a funcionar, el problema está en uno de tus plugins. Ahora, renombra la carpeta de nuevo a plugins y ve desactivando plugins uno por uno desde el panel de administración (si ya puedes acceder). Si no, renombra la carpeta a plugins y luego mueve los plugins de uno en uno a una carpeta temporal para identificar al culpable.
Revisa el tema: Si el problema persiste sin plugins, cambia temporalmente el tema. Ve a wp-content/themes y renombra la carpeta de tu tema activo (ej: mi-tema a mi-tema-backup). WordPress usará automáticamente un tema por defecto (Twenty Twenty-Four, por ejemplo).
Aumenta la memoria PHP: Si nada funciona, edita el archivo wp-config.php (en la raíz de WordPress) y añade esta línea justo antes de la línea que dice /* That's all, stop editing! */:
```
define('WP_MEMORY_LIMIT', '256M');
```

[TIP] Si no puedes acceder por FTP, muchos paneles de hosting (como Syspanel) tienen un "Administrador de Archivos" web. Busca la opción en el panel de control (puerto 2106 para Syspanel).

2. Error de conexión a la base de datos

Este error aparece como: "Error establishing a database connection". Es un clásico y suele ser fácil de arreglar.

Causas comunes

Credenciales de base de datos incorrectas en wp-config.php.
El servidor de base de datos está caído o sobrecargado.
La base de datos está corrupta.

Pasos para solucionarlo

Verifica las credenciales en wp-config.php: Busca las líneas:
```
define('DB_NAME', 'nombre_base');
define('DB_USER', 'usuario_base');
define('DB_PASSWORD', 'contraseña_base');
define('DB_HOST', 'localhost');
```
Asegúrate de que coincidan exactamente con las que te proporcionó tu hosting. Si las cambiaste recientemente, este es el problema.
Comprueba el estado del servidor de base de datos: Si usas cPanel o Syspanel, busca la sección "Bases de Datos MySQL" o "phpMyAdmin". Intenta acceder. Si no puedes, contacta a tu proveedor de hosting.
Repara la base de datos: Añade esta línea a wp-config.php:
```
define('WP_ALLOW_REPAIR', true);
```
Luego, visita: tudominio.com/wp-admin/maint/repair.php. Haz clic en "Reparar base de datos". ¡Importante! Una vez terminado, elimina esa línea de wp-config.php por seguridad.
Reinicia el servicio MySQL (si tienes acceso root): En un servidor Linux con acceso SSH, ejecuta:
```
sudo systemctl restart mysql
# o
sudo systemctl restart mariadb
```

[WARNING] No dejes la línea WP_ALLOW_REPAIR activa permanentemente. Es un agujero de seguridad.

3. Error "404 Página no encontrada" en todas las páginas (excepto la principal)

Este error suele aparecer después de cambiar la estructura de enlaces permanentes o al migrar el sitio.

¿Qué lo causa?

WordPress no puede generar correctamente las reglas de reescritura (rewrite rules) en el archivo .htaccess.

Solución rápida

Ve al panel de administración (si puedes acceder): Ajustes > Enlaces permanentes.
Selecciona cualquier opción (por ejemplo, "Simple") y haz clic en "Guardar cambios".
Vuelve a seleccionar la opción que usabas (por ejemplo, "Nombre de la entrada") y guarda de nuevo. Esto regenera el archivo .htaccess.

Si no puedes acceder al panel

Conéctate por FTP o Syspanel.
Busca el archivo .htaccess en la raíz de WordPress. Si no existe, créalo.

Pega este código (el estándar de WordPress):

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

4. Error "500 Internal Server Error"

Este es un error genérico del servidor. Puede deberse a muchas causas: un plugin defectuoso, un archivo .htaccess corrupto, o un problema de permisos.

Diagnóstico paso a paso

Revisa el archivo .htaccess: Renómbralo a .htaccess_old y recarga la web. Si funciona, el problema está ahí. Regenera las reglas como en el punto anterior.
Aumenta la memoria PHP (como en el punto 1, paso 5).
Verifica los permisos de archivos y carpetas: En general, las carpetas deben tener permisos 755 y los archivos 644. Desde FTP o Syspanel, selecciona toda la carpeta de WordPress y ajusta los permisos recursivamente.
- Carpetas: chmod -R 755 .
- Archivos: find . -type f -exec chmod 644 {} \;
Revisa los logs de error del servidor: Esta es la clave. En Syspanel, busca "Registros de errores" o "Error Logs". El mensaje exacto te dirá qué archivo PHP está fallando.

[INFO] Si ves errores como PHP Fatal error: Unauthorized ... suele ser un tema o plugin malicioso. Escanea tu web con un plugin de seguridad como Wordfence.

5. Error de "Enlace roto" o "Loop de redirección"

Tu navegador te dice que la página te está redirigiendo en un bucle infinito.

Causas

Problema con la URL del sitio: En Ajustes > Generales, la URL de WordPress y la URL del sitio deben ser iguales (o la correcta).
Plugin de redirección o caché mal configurado.
Problema con el protocolo HTTPS/HTTP: Si tienes un certificado SSL pero las URLs están configuradas como HTTP.

Solución

Accede a la base de datos (phpMyAdmin desde Syspanel o cPanel).
Busca la tabla wp_options (el prefijo puede variar).
Localiza las filas siteurl y home. Asegúrate de que tengan la URL correcta, incluyendo https:// si tienes SSL.
Desactiva todos los plugins de caché y redirección (como se explicó en el punto 1).
Borra la caché del navegador y prueba de nuevo.

6. El panel de administración es lento o no carga CSS/JS

Entras a /wp-admin y ves una página sin estilos, solo texto feo.

Posibles causas

Plugin de optimización mal configurado (por ejemplo, uno que minifique o combine CSS/JS).
Problema de CDN.
Límite de memoria de PHP.

Pasos para arreglarlo

Accede por FTP y renombra la carpeta plugins (como en el punto 1). Si el panel vuelve a la normalidad, el culpable es un plugin.
Revisa la configuración de tu CDN (si usas Cloudflare, MaxCDN, etc.). A veces una configuración incorrecta bloquea los archivos estáticos.
Aumenta la memoria PHP (paso 5 del punto 1).
Limpia la caché de tu navegador y la caché del servidor (si usas un plugin de caché, bórrala desde el propio plugin o desde Syspanel, que suele tener un botón de "Limpiar caché").

7. Error "Failed to open stream: Permission denied"

Este error aparece al intentar instalar un plugin, tema o actualizar WordPress.

¿Qué significa?

El usuario del servidor web (www-data, por ejemplo) no tiene permisos de escritura en la carpeta wp-content.

Solución

Conéctate por SSH o Syspanel.
Ve a la raíz de WordPress.
Ejecuta estos comandos (ajusta las rutas si es necesario):
```
sudo chown -R www-data:www-data wp-content/
sudo chmod -R 755 wp-content/
```
(Si no sabes qué usuario es, en Syspanel suele ser el mismo que el del FTP)

[WARNING] No pongas permisos 777 a ninguna carpeta. Es un riesgo de seguridad enorme.

Preguntas Frecuentes (FAQ)

¿Cómo puedo saber qué plugin está causando el error?

Desactiva todos los plugins renombrando la carpeta plugins. Luego, actívalos de uno en uno desde el panel de administración (si puedes acceder) o moviéndolos de vuelta a la carpeta plugins desde FTP. Después de activar cada uno, comprueba si el error reaparece.

¿Qué hago si no puedo acceder al panel de administración?

Siempre puedes usar FTP o el Administrador de Archivos de tu panel de hosting (Syspanel en puerto 2106). Desde ahí puedes modificar archivos, renombrar carpetas y arreglar la mayoría de los problemas sin necesidad del panel.

¿El error "pantalla blanca" puede deberse a un tema hijo?

Sí, a veces el tema hijo tiene un error de sintaxis. Prueba a cambiar al tema padre o a un tema por defecto (Twenty Twenty-Four) renombrando la carpeta del tema hijo.

¿Cómo restauro una copia de seguridad de WordPress?

Si nada funciona, la mejor opción es restaurar una copia de seguridad. La mayoría de los proveedores de hosting (incluyendo Syspanel) ofrecen copias de seguridad automáticas. Busca la sección "Backups" o "Copias de seguridad" en tu panel y restaura la más reciente anterior al error.

¿Debo actualizar WordPress, plugins y temas siempre?

Sí, las actualizaciones corrigen errores y vulnerabilidades de seguridad. Sin embargo, siempre haz una copia de seguridad antes de actualizar, especialmente si usas muchos plugins o un tema muy personalizado.

Conclusión

Ser SysAdmin de un WordPress no tiene por qué ser una pesadilla. La mayoría de los errores comunes tienen soluciones sencillas que puedes aplicar sin ser un experto. La clave está en tener un proceso metódico: desactivar plugins, cambiar el tema, revisar permisos y, sobre todo, leer los logs de error.

Con esta guía, ya tienes un mapa para enfrentarte a los problemas más habituales. Recuerda, la paciencia y el método son tus mejores aliados. Si después de todo el sitio sigue sin funcionar, contacta con tu soporte técnico y muéstrales los logs de error. ¡Buena suerte!