koode_
WordPress

Error de conexión a base de datos en WordPress: qué hacer

30 de octubre de 20265 min de lecturaEquipo koode.mx
Ilustración de una página web en blanco conectada por un cable desenchufado a un cilindro de base de datos dentro de un servidor

Abres tu sitio y en lugar de tu página de inicio aparece una pantalla blanca con una sola línea: “Error al establecer una conexión con la base de datos”. No hay menú ni logo. Tampoco puedes entrar a tu panel de WordPress. Si tienes una tienda en línea, ahorita nadie puede comprar.

Asusta, pero casi siempre tiene arreglo y casi nunca significa que perdiste tu información. En esta nota te explicamos qué está pasando, qué puedes revisar tú y qué información conviene tener lista para tu proveedor.

Qué significa este error en palabras simples

Un sitio WordPress tiene dos partes. Una son los archivos: el diseño, las imágenes y el código. La otra es la base de datos, donde se guardan tus textos, productos, pedidos, usuarios y configuraciones.

Cada vez que alguien visita tu página, WordPress le pide a la base de datos el contenido que debe mostrar. Este error aparece cuando esa petición no recibe respuesta. Los archivos siguen ahí y lo más probable es que tus datos también. Lo que se rompió es la comunicación entre las dos partes.

Piénsalo como una ferretería en Querétaro donde el mostrador está abierto pero la bodega tiene el candado cambiado. El inventario sigue completo. El vendedor no puede sacar nada.

Las causas más comunes

1. Alguien cambió la contraseña de la base de datos

WordPress guarda en un archivo llamado wp-config.php el nombre de la base de datos, el usuario y la contraseña para entrar. Si alguien cambió esa contraseña desde el panel del hosting (por seguridad, por limpieza o por error) y no actualizó el archivo, WordPress sigue tocando con la llave vieja.

Es más frecuente de lo que parece cuando varias personas tienen acceso. Si no tienes claro quién puede mover qué, revisa quién debe tener cada contraseña de tu sitio.

2. El servidor de base de datos está saturado o caído

En hosting compartido, la base de datos suele vivir en un servicio que atiende a muchos sitios. Si ese servicio se reinicia o se satura, tu sitio deja de responder aunque tú no hayas tocado nada. A veces se resuelve solo en minutos. Si se repite seguido, es una señal para hablar con tu proveedor.

3. Tu sitio se quedó sin recursos

Un pico de visitas, un robot que hace miles de peticiones o un plugin que consulta la base de datos sin parar pueden agotar las conexiones que tu plan permite. El síntoma puede ser este error o uno parecido al error 508 por límite de recursos.

4. Una migración o cambio de hosting a medias

Si acabas de mudar el sitio, es posible que los archivos ya estén en el servidor nuevo pero la base de datos no, o que el archivo de configuración apunte todavía al servidor viejo. Por eso conviene seguir una lista al migrar tu sitio a otro hosting.

5. Tablas dañadas

Menos común. Un corte a media escritura, un disco lleno o una actualización interrumpida pueden dejar alguna tabla dañada. En ese caso a veces el sitio carga y solo el panel de administración muestra el error, o al revés.

Qué revisar tú, en este orden

  1. Espera cinco minutos y vuelve a cargar. Si fue un reinicio del servicio, se resuelve solo. Prueba desde tu celular con datos móviles para descartar tu red.
  2. Pregunta en tu equipo si alguien movió algo. Una contraseña, un plugin nuevo, una actualización, una mudanza. El cambio más reciente suele ser el culpable.
  3. Entra al panel de tu hosting. Revisa si hay avisos de suspensión, de disco lleno o de recursos agotados. Si no sabes dónde buscar, aquí explicamos qué puedes hacer tú mismo en el panel de control.
  4. Compara los datos de conexión. En el administrador de archivos abre wp-config.php y busca cuatro líneas: DB_NAME, DB_USER, DB_PASSWORD y DB_HOST. Luego, en la sección de bases de datos del panel, confirma que el nombre y el usuario existen y coinciden. Si cambiaron la contraseña, puedes asignar una nueva al usuario y escribirla igual en el archivo.
  5. Si sospechas de tablas dañadas, pide ayuda. WordPress trae una herramienta de reparación, pero se activa editando el mismo archivo de configuración y luego hay que desactivarla. Si no te sientes cómodo, déjalo a quien administra tu sitio.

Antes de editar wp-config.php, descarga una copia del archivo a tu computadora. Si algo sale mal, lo vuelves a subir y quedas como estabas.

Qué no hacer

  • No reinstales WordPress por desesperación. No resuelve la conexión y puedes sobrescribir archivos que sí funcionaban.
  • No borres la base de datos ni crees una nueva vacía “para probar”. Ahí están tus pedidos y tu contenido.
  • No restaures un respaldo viejo sin saber la causa. Si tu tienda recibió pedidos esta semana y regresas a un respaldo de hace un mes, esos pedidos desaparecen.

Qué decirle a soporte para que te resuelvan rápido

Un mensaje claro ahorra varias vueltas. Incluye:

  • La dirección exacta del sitio y desde qué hora ves el error.
  • Si falla todo el sitio o solo el panel de administración.
  • Cualquier cambio de los últimos días: contraseñas, plugins, actualizaciones, migración.
  • Una captura de pantalla del error.

Con eso, un despacho contable en Guadalajara que manda “mi página no abre” recibe la misma atención, pero la respuesta llega mucho más rápido.

Cómo evitar que te vuelva a pasar

Tres hábitos cubren la mayoría de los casos. Primero, cualquier cambio de contraseña de la base de datos se hace junto con la actualización de wp-config.php, nunca por separado. Segundo, ten un monitoreo que te avise cuando el sitio deja de responder; explicamos cómo en enterarte de que tu sitio se cayó antes que tus clientes. Tercero, mantén respaldos que incluyan la base de datos y que hayas probado, porque un respaldo solo de archivos no te devuelve productos ni pedidos.

También ayuda revisar de vez en cuando qué plugins guardan registros sin límite. Algunos de estadísticas o de seguridad llenan la base de datos con millones de filas y la vuelven lenta hasta que un día deja de responder.

Si no quieres lidiar con esto tú

Este error se resuelve rápido cuando alguien conoce tu sitio y tiene sus accesos en orden. Si prefieres que eso lo vea un equipo en español mientras tú atiendes tu negocio, en koode.mx puedes revisar cómo funciona el mantenimiento de WordPress administrado.

¿Listo para empezar?

Nos encargamos de actualizar WordPress, plugins y temas, de respaldar tu sitio y de vigilar que esté en línea. Tú recibes un reporte mensual y te olvidas del tema.

Ver mantenimiento wordpress