Error al establecer una conexión con la base de datos

Guía de resolución de incidencias

Errores comunes de WordPress y cómo solucionarlos

WordPress es potente y flexible, pero de vez en cuando falla: una pantalla en blanco, un aviso de base de datos o un panel de administración que no carga. La mayoría de estos errores se resuelven en pocos minutos si sabes exactamente dónde mirar.

5 errores diagnosticados
FTP / cPanel acceso necesario
< 10 min por solución

Cada ficha de esta guía identifica un síntoma concreto, su causa más habitual y los pasos exactos para solucionarlo sin perder contenido ni configuración. Si después de aplicarlos el problema continúa, al final tienes un acceso directo para pedir ayuda profesional.

ERR_WSOD

Pantalla blanca de la muerte (WSOD)

Al entrar en tu web solo ves una pantalla en blanco, sin ningún mensaje de error. Es uno de los fallos que más agobia porque no da ninguna pista visual de qué ha pasado, pero casi siempre se debe a una de estas tres causas: un plugin que se ha vuelto incompatible tras una actualización, un tema con un error en su código, o que el servidor se ha quedado sin memoria suficiente para cargar la web.

Cómo solucionarlo

  1. Entra en tu hosting (por FTP con un programa como FileZilla, o desde el Administrador de archivos de cPanel) y localiza la carpeta wp-content/plugins. Renómbrala, por ejemplo a plugins-desactivados. Al no encontrar esa carpeta con su nombre original, WordPress desactiva automáticamente todos los plugins sin borrar nada, y así puedes comprobar si la web vuelve a cargar.
  2. Si la web funciona de nuevo, el problema era un plugin. Vuelve a renombrar la carpeta a su nombre original (plugins) y ve activándolos uno a uno desde el panel de WordPress hasta encontrar cuál provoca el error.
  3. Si tras desactivar los plugins la pantalla sigue en blanco, repite el mismo proceso con el tema: dentro de wp-content/themes, renombra la carpeta de tu tema activo. WordPress cargará automáticamente un tema por defecto (como Twenty Twenty-Four) si lo tienes instalado.
  4. Si ni plugins ni tema son el problema, es probable que el servidor se esté quedando sin memoria. Abre el archivo wp-config.php (más abajo explicamos cómo) y añade esta línea justo antes de donde pone /* ¡Eso es todo, deja de editar!:
define('WP_MEMORY_LIMIT', '256M');

Esto le dice a WordPress que puede usar hasta 256 MB de memoria en lugar del límite por defecto, que en muchos hostings es más bajo. Si el error continúa, contacta con tu proveedor de hosting para que aumente el límite de memoria a nivel de servidor, ya que la línea anterior no puede superar lo que el propio servidor permite.

ERR_DB_CONN

Error de conexión con la base de datos

Aparece el mensaje Error establishing a database connection. Esto significa que WordPress se ha abierto correctamente, pero no consigue "hablar" con la base de datos donde están guardados todos tus contenidos: entradas, páginas, usuarios y ajustes. Casi siempre es porque las credenciales de acceso guardadas en tu web no coinciden con las credenciales reales de la base de datos, aunque a veces es simplemente que el servidor de base de datos está caído.

Paso 1 · Qué es wp-config.php y cómo acceder a él

wp-config.php es el archivo de configuración principal de WordPress. Es el primer archivo que WordPress lee al arrancar, y en él se guardan (entre otras cosas) los datos con los que tu web se conecta a la base de datos. Está en la carpeta raíz de tu instalación de WordPress, junto a carpetas como wp-content o wp-admin.

Para verlo o editarlo no necesitas descargar nada a tu ordenador, aunque puedes hacerlo si lo prefieres:

  1. Entra en cPanel (tu proveedor de hosting te da la URL y las credenciales de acceso, normalmente algo como tudominio.com/cpanel).
  2. Busca el icono Administrador de archivos (en inglés, File Manager) y ábrelo.
  3. Navega hasta la carpeta public_html (o la subcarpeta donde tengas instalado WordPress, si no está en la raíz del dominio).
  4. Busca el archivo wp-config.php en el listado. Haz clic derecho sobre él.
  5. Para editarlo directamente en el navegador, pulsa Editar (Edit). Para guardarlo en tu ordenador antes de tocar nada (recomendado como copia de seguridad), pulsa Descargar (Download): se guardará como un archivo .php que puedes abrir con cualquier editor de texto, como el Bloc de notas.

Paso 2 · Cómo ver las credenciales reales de tu base de datos

El archivo wp-config.php te dice qué credenciales está usando tu web, pero para comprobar si son correctas necesitas ver los datos reales de la base de datos en tu hosting:

  1. Dentro de cPanel, busca la sección Bases de datos y entra en Bases de datos MySQL (MySQL Databases).
  2. Ahí verás el nombre exacto de tu base de datos (algo como usuario_wp123) y, más abajo, los usuarios asociados a ella (algo como usuario_wpuser).
  3. Por seguridad, cPanel nunca muestra la contraseña ya guardada. Si no la recuerdas, en la misma sección hay un apartado para Cambiar contraseña de MySQL (Change Password): crea una contraseña nueva y apúntala.
  4. Confirma también el host de la base de datos: en la gran mayoría de hostings es localhost, pero algunos proveedores usan una dirección distinta que suelen indicar en su panel o en su documentación de ayuda.

Paso 3 · Comparar y corregir los datos en wp-config.php

Con el archivo abierto (paso 1) busca estas cuatro líneas, normalmente cerca del principio del archivo, y comprueba que cada valor coincide exactamente con lo que has visto en cPanel (mayúsculas, minúsculas y guiones bajos incluidos):

define('DB_NAME', 'nombre_de_la_base');
define('DB_USER', 'usuario_de_la_base');
define('DB_PASSWORD', 'contraseña_de_la_base');
define('DB_HOST', 'localhost'); // casi siempre localhost, pero revisa la documentación de tu hosting

Si acabas de cambiar la contraseña en el paso 2, este es el momento de escribir la contraseña nueva dentro de las comillas de DB_PASSWORD. Guarda el archivo (o vuelve a subirlo por FTP si lo habías descargado) y recarga tu web.

Paso 4 · Si los datos son correctos y sigue fallando

  1. Entra en phpMyAdmin desde cPanel, selecciona tu base de datos en el menú lateral, marca todas las tablas y usa la opción Reparar tabla (Repair table) en el desplegable de acciones: esto soluciona problemas de tablas dañadas o corruptas.
  2. Si phpMyAdmin tampoco carga o da error, es señal de que el propio servidor de base de datos está caído. Contacta con el soporte de tu hosting o reinicia el servicio de base de datos (MySQL) desde el panel de control, si tu plan de hosting te da esa opción.
ERR_MAINT_LOCK

WordPress atascado en modo mantenimiento

Tras actualizar plugins, temas o el propio WordPress, el sitio se queda bloqueado mostrando el aviso Briefly unavailable for scheduled maintenance. Esto ocurre porque, durante cualquier actualización, WordPress crea automáticamente un archivo temporal para avisar a los visitantes de que la web está en mantenimiento y evitar que alguien navegue mientras se actualizan los archivos. Ese archivo debería borrarse solo al terminar el proceso, pero si la actualización se interrumpe (por ejemplo, por una desconexión o un tiempo de espera agotado en el servidor), el archivo se queda ahí y bloquea la web aunque la actualización ya haya terminado.

Cómo solucionarlo

  1. Conéctate por FTP (o desde el Administrador de archivos de cPanel) a la carpeta raíz de tu instalación de WordPress, la misma donde está wp-config.php.
  2. Busca un archivo llamado .maintenance. Si no lo ves, activa la opción para mostrar archivos ocultos en tu cliente FTP, ya que al empezar por un punto puede quedar oculto por defecto.
  3. Elimínalo y recarga tu web: debería volver a funcionar de inmediato, sin que hayas perdido ningún dato.
  4. Si el aviso reaparece al poco tiempo, es señal de que la actualización sigue fallando por otro motivo (por ejemplo, permisos de archivos incorrectos o un límite de tiempo de ejecución muy bajo en el servidor). En ese caso, repite la actualización desde el panel de administración y, si vuelve a interrumpirse, contacta con tu hosting para revisar los límites del servidor.
ERR_404_ROUTE

Error 404 en páginas o entradas

Algunas páginas o entradas devuelven un error 404 (página no encontrada) mientras que la portada y otras secciones cargan sin problema. El origen casi siempre está en los enlaces permanentes: la configuración que decide qué forma tienen las URLs de tu web (por ejemplo, tudominio.com/mi-entrada en lugar de tudominio.com/?p=123). Esa configuración depende de un archivo llamado .htaccess, que le indica al servidor cómo redirigir cada URL hacia el contenido correcto. Si ese archivo se borra, se corrompe o queda desactualizado tras un cambio de servidor, WordPress deja de encontrar las páginas aunque sigan existiendo.

Cómo solucionarlo

  1. Entra en el panel de administración de WordPress y ve a Ajustes > Enlaces permanentes.
  2. Sin cambiar ninguna opción, simplemente pulsa Guardar cambios. Aunque no toques nada, este paso obliga a WordPress a regenerar el archivo .htaccess con la configuración correcta, y en la mayoría de los casos soluciona el error al instante.
  3. Si el error continúa, el archivo .htaccess puede no tener permisos de escritura o directamente no existir. Entra por FTP o desde el Administrador de archivos de cPanel a la carpeta raíz de tu instalación (donde está wp-config.php) y comprueba si el archivo .htaccess está ahí; si no aparece, puede estar oculto (activa "mostrar archivos ocultos") o haber sido eliminado.
  4. Ábrelo con el editor de texto de tu cliente FTP o de cPanel y sustituye su contenido por este bloque estándar de WordPress:
# BEGIN WordPress
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress
ERR_ADMIN_LOCK

No puedo acceder al panel de administración

Al entrar en /wp-admin/ ves un Acceso denegado o Página no encontrada, o simplemente el panel no termina de cargar. A diferencia de un olvido de contraseña normal (que se soluciona con el enlace de "¿Has olvidado la contraseña?" en la pantalla de acceso), este error suele deberse a un plugin en conflicto, a reglas mal escritas en el .htaccess, o a que la cuenta de administrador se ha dañado o eliminado por error.

Cómo solucionarlo

  1. Empieza por lo más sencillo: desactiva todos los plugins por FTP renombrando la carpeta wp-content/plugins (igual que en el error de la pantalla blanca) y prueba a entrar de nuevo en /wp-admin/. Muchas veces un plugin de seguridad mal configurado es el culpable de bloquear el acceso.
  2. Si sigues sin entrar, revisa el archivo .htaccess por si tiene alguna regla añadida recientemente (por ejemplo, por un plugin de seguridad) que esté bloqueando el acceso a /wp-admin/. Puedes renombrarlo temporalmente a .htaccess-bak para descartar esta causa.
  3. Si nada de lo anterior funciona y sospechas que la cuenta de administrador ya no existe o ha perdido sus permisos, puedes crear un nuevo usuario administrador directamente desde phpMyAdmin. Entra en cPanel > phpMyAdmin, selecciona tu base de datos (la misma que viste en el error anterior) y ve a la pestaña SQL para ejecutar este código, ajustando antes el prefijo wp_ si tu instalación usa uno distinto (lo puedes comprobar mirando el nombre de las tablas en el panel izquierdo de phpMyAdmin):
INSERT INTO `wp_users` (`user_login`, `user_pass`, `user_nicename`, `user_email`, `user_status`) 
VALUES ('nuevoadmin', MD5('contraseña_segura'), 'Nuevo Admin', 'email@correo.com', '0');

INSERT INTO `wp_usermeta` (`user_id`, `meta_key`, `meta_value`) 
VALUES (LAST_INSERT_ID(), 'wp_capabilities', 'a:1:{s:13:"administrator";b:1;}'), 
       (LAST_INSERT_ID(), 'wp_user_level', '10');
  1. Cambia 'nuevoadmin', 'contraseña_segura' y 'email@correo.com' por tus propios datos antes de ejecutar el código, y usa una contraseña robusta.
  2. Inicia sesión en /wp-admin/ con el nuevo usuario, revisa qué le ha pasado a la cuenta anterior y, si ya no la necesitas, elimina el usuario temporal una vez restablecido el acceso normal.

¿El error persiste después de seguir estos pasos?

WordPress puede fallar, pero casi siempre tiene arreglo si sabes dónde mirar. Si ya has probado todo esto y tu web sigue sin funcionar, puedo revisarlo y solucionarlo por ti sin que pierdas contenido ni configuración.

Pide ayuda profesional

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *