🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Errores comunes al conectar WordPress con su base de datos

Actualizado el 22 de octubre de 2025

¡Hola! Soy tu técnico de soporte amigable. ¿Estás teniendo problemas para conectar tu WordPress con la base de datos? No te preocupes, es uno de los errores más comunes y, por suerte, casi siempre tiene una solución sencilla. En esta guía extensa, vamos a desglosar los errores más frecuentes, cómo identificarlos y, lo más importante, cómo solucionarlos paso a paso. Al final, tendrás un pequeño FAQ para resolver cualquier duda extra. ¡Vamos allá!

¿Por qué ocurre el temido "Error de conexión a la base de datos"?

Imagina que tu web WordPress es una tienda y la base de datos es el almacén donde guardas todos los productos (artículos, páginas, usuarios, configuraciones). Para que la tienda funcione, necesita una llave (las credenciales de acceso) para abrir el almacén. Si la llave está mal, el almacén está cerrado o la puerta está rota, la tienda no puede operar y te muestra el famoso mensaje: "Error al establecer una conexión a la base de datos".

Este error puede aparecer por varias razones, pero las más comunes son:

  1. Credenciales incorrectas en el archivo wp-config.php.
  2. Problemas con el servidor de base de datos (caído, sobrecargado o mal configurado).
  3. Corrupción de la base de datos (algo se dañó en el almacén).
  4. Errores al migrar o mover el sitio (cambiaste de hosting y olvidaste actualizar datos).

A continuación, veremos cada uno de estos errores y cómo solucionarlos, tanto si usas cPanel, Plesk o Syspanel (HestiaCP).

Error #1: Credenciales incorrectas en wp-config.php

Este es, con diferencia, el error más habitual. El archivo wp-config.php es el corazón de la configuración de WordPress y contiene los datos de acceso a tu base de datos. Si alguno de estos datos está mal, WordPress no podrá conectar.

Síntomas típicos

  • Ves el mensaje: "Error al establecer una conexión a la base de datos".
  • En algunos casos, verás un WordPress database error más técnico si tienes activado el modo depuración.

Solución paso a paso

  1. Accede a tu panel de control de hosting (cPanel, Plesk, Syspanel, etc.).

  2. Busca el administrador de archivos (File Manager). Normalmente está en la sección "Archivos".

  3. Navega hasta la carpeta raíz de tu WordPress. Suele ser public_html o htdocs. Dentro, busca el archivo wp-config.php.

  4. Abre el archivo con un editor de texto (clic derecho > Editar).

  5. Localiza las siguientes líneas (suelen estar al principio):

    define('DB_NAME', 'nombre_de_tu_base');
define('DB_USER', 'usuario_de_la_base');
define('DB_PASSWORD', 'contraseña_secreta');
define('DB_HOST', 'localhost');

  6. Verifica que cada línea sea correcta:

    • DB_NAME: El nombre exacto de tu base de datos. En cPanel suele ser usuario_nombrebasedatos.
    • DB_USER: El usuario que tiene permisos sobre esa base. En cPanel suele ser usuario_nombreusuario.
    • DB_PASSWORD: La contraseña de ese usuario. ¡Ojo! Si la cambiaste desde el panel, debes actualizarla aquí.
    • DB_HOST: Casi siempre es localhost, pero algunos hostings usan algo como mysql.tudominio.com o una IP. Verifica en la documentación de tu hosting o en la sección "Bases de Datos" de tu panel.

  7. Guarda los cambios y recarga tu web. Si el problema era este, ¡ya debería funcionar!

[TIP] Si no recuerdas la contraseña, puedes cambiarla desde tu panel de control (en cPanel: "MySQL Databases" > "Change Password"; en Plesk: "Bases de datos" > tu base > "Cambiar contraseña"; en Syspanel: "Bases de datos" > "Editar usuario"). Luego, actualiza el wp-config.php con la nueva.

Error #2: El servidor de base de datos está caído o sobrecargado

A veces el error no está en tu configuración, sino en el servidor que aloja tu base de datos. Esto puede ocurrir por mantenimiento, un fallo temporal o porque tu web está recibiendo mucho tráfico y el servidor no da abasto.

Síntomas típicos

  • El error aparece de repente, sin que hayas cambiado nada.
  • Otros sitios web en el mismo hosting también tienen problemas.
  • Ves un mensaje como "Error establishing a database connection" o "WordPress database error: Can't connect to MySQL server".

Solución paso a paso

  1. Comprueba el estado de tu hosting. Muchos paneles (como cPanel o Plesk) tienen un apartado de "Estado del servidor". También puedes contactar con el soporte de tu hosting.
  2. Reinicia el servicio de MySQL/MariaDB (si tienes acceso). En cPanel, a veces hay un botón en "MySQL Databases" o en "Servicios". En Plesk, ve a "Herramientas y configuraciones" > "Servicios" > "MySQL" y haz clic en "Reiniciar". En Syspanel, puedes usar el comando sudo systemctl restart mysql si tienes acceso SSH.
  3. Si el problema persiste, contacta a tu proveedor de hosting. Ellos pueden verificar si el servidor de bases está funcionando correctamente.

[WARNING] No intentes reiniciar servicios si no estás seguro de lo que haces. Pide ayuda al soporte técnico de tu hosting.

Error #3: Base de datos corrupta o dañada

Con el tiempo, una base de datos puede sufrir pequeños daños (por ejemplo, por un corte de energía, un plugin conflictivo o una migración mal hecha). Esto provoca que WordPress no pueda leer ciertas tablas.

Síntomas típicos

  • Aparecen errores específicos como "WordPress database error: Table 'wp_posts' doesn't exist" o "Table 'wp_options' is marked as crashed".
  • Algunas páginas funcionan y otras no.
  • El panel de administración (wp-admin) da errores.

Solución paso a paso

  1. Accede a phpMyAdmin (suele estar en la sección "Bases de Datos" de tu panel: cPanel, Plesk, Syspanel).
  2. Selecciona tu base de datos (a la izquierda).
  3. Marca la casilla "Seleccionar todo" (para elegir todas las tablas).
  4. En el menú desplegable "Con seleccionados", elige "Reparar tabla".
  5. Ejecuta la reparación. phpMyAdmin intentará reparar todas las tablas dañadas.
  6. Vuelve a tu web. Si el error era por corrupción, debería solucionarse.

[INFO] Si la reparación no funciona, puedes intentar una optimización (mismo proceso, pero eligiendo "Optimizar tabla"). Esto no repara datos perdidos, pero puede ayudar a que las tablas funcionen mejor.

Error #4: Problemas al migrar o mover el sitio

Si cambiaste de hosting, de dominio o de carpeta, es muy común olvidar actualizar las rutas o las credenciales en el archivo wp-config.php.

Síntomas típicos

  • El error aparece justo después de una migración.
  • Ves enlaces rotos o imágenes que no cargan.
  • Al intentar acceder al panel de administración, te redirige al dominio antiguo.

Solución paso a paso

  1. Verifica el archivo wp-config.php (como en el Error #1). Asegúrate de que DB_NAME, DB_USER, DB_PASSWORD y DB_HOST correspondan a la nueva base de datos.
  2. Actualiza las URLs del sitio. A veces, aunque la conexión funcione, las rutas internas están mal. Puedes hacerlo desde la base de datos con phpMyAdmin:
    • Busca la tabla wp_options (o el prefijo que tengas, como miweb_options).
    • Localiza las filas siteurl y home.
    • Edítalas y pon la URL nueva (por ejemplo, https://tunuevodominio.com).
  3. Revisa los archivos de configuración del servidor. Si usas un caché de servidor (como Varnish o Redis), puede que esté sirviendo datos antiguos. Limpia la caché desde tu panel de control.

[TIP] Si migraste de un hosting a otro, asegúrate de que la versión de PHP y MySQL sea compatible con tu WordPress. Versiones muy antiguas pueden dar errores de conexión.

Error #5: Conflictos con plugins o temas

A veces, un plugin mal codificado o un tema con errores pueden modificar la conexión a la base de datos, causando el error.

Síntomas típicos

  • El error aparece después de instalar o actualizar un plugin/tema.
  • El error es intermitente (a veces funciona, a veces no).
  • Ves errores de tipo "WordPress database error: Query error" en el log de errores.

Solución paso a paso

  1. Accede a tu panel de control de archivos (File Manager) o usa FTP.
  2. Navega a la carpeta wp-content/plugins.
  3. Renombra la carpeta del plugin sospechoso (por ejemplo, cambia miplugin a miplugin_desactivado). Esto desactivará el plugin.
  4. Prueba tu web. Si funciona, ese plugin es el culpable. Puedes eliminarlo o buscar una alternativa.
  5. Si no sabes qué plugin es, renombra toda la carpeta plugins a plugins_desactivados. Esto desactivará todos los plugins. Luego, ve renombrándolos de uno en uno para identificar al causante.
  6. Haz lo mismo con los temas: renombra la carpeta del tema activo en wp-content/themes. WordPress usará un tema por defecto (Twenty Twenty-Four, por ejemplo). Si el error desaparece, el tema tiene un problema.

[WARNING] Si renombras toda la carpeta plugins, perderás la configuración de algunos plugins (como los de caché). Es mejor hacerlo de forma selectiva.

FAQ: Preguntas frecuentes sobre errores de conexión a la base de datos

Aquí tienes respuestas a las dudas más comunes que nos llegan al soporte.

1. ¿Qué significa exactamente "WordPress database error"?

Es un mensaje genérico que indica que WordPress no pudo ejecutar una consulta SQL (una instrucción para leer o escribir datos). Puede deberse a una tabla dañada, un plugin malo, un servidor caído, etc. Siempre revisa el mensaje completo (a veces aparece en el log de errores) para saber qué tabla o consulta falló.

2. ¿Cómo puedo ver el error de base de datos en WordPress?

Activa el modo depuración. Edita tu wp-config.php y justo antes de la línea /* That's all, stop editing! Happy blogging. */, añade:

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

Esto creará un archivo debug.log en la carpeta wp-content. Ábrelo para ver los errores detallados. Recuerda desactivarlo (false) cuando termines, porque ralentiza la web.

3. ¿Puedo solucionar el error desde cPanel o Plesk sin tocar archivos?

Sí, en la mayoría de los casos. Desde cPanel, ve a "MySQL Databases" y verifica que el usuario esté vinculado a la base de datos correcta. Desde Plesk, ve a "Bases de datos" y revisa los permisos del usuario. En Syspanel (HestiaCP), ve a "Bases de datos" y edita el usuario para asegurarte de que tenga todos los privilegios.

4. ¿Qué hago si el error aparece solo en algunas páginas?

Es probable que sea un problema de una tabla específica. Accede a phpMyAdmin, selecciona la base de datos y busca la tabla que menciona el error (por ejemplo, wp_posts). Repárala como se explicó en el Error #3.

5. ¿El error puede deberse a un ataque o hackeo?

Sí, es posible. Si ves consultas extrañas en el log o tablas con nombres raros (como wp_hacked), podrías tener malware. En ese caso, además de reparar la base de datos, cambia todas las contraseñas (de WordPress, FTP, base de datos) y revisa los archivos de tu instalación.

6. ¿Cómo evito este error en el futuro?

  • Haz copias de seguridad regulares de tu base de datos (puedes programarlas desde cPanel, Plesk o Syspanel).
  • Actualiza WordPress, plugins y temas con frecuencia.
  • No instales plugins de fuentes no confiables.
  • Usa un hosting de calidad que ofrezca buen soporte y servidores estables.

Resumen rápido

ErrorCausa comúnSolución rápida
Credenciales incorrectaswp-config.php mal configuradoVerifica DB_NAME, DB_USER, DB_PASSWORD, DB_HOST
Servidor caídoMantenimiento o sobrecargaContacta al hosting o reinicia MySQL
Base de datos corruptaTablas dañadasRepara tablas desde phpMyAdmin
Migración mal hechaURLs o credenciales viejasActualiza wp-config.php y las URLs en wp_options
Plugin/tema conflictivoCódigo maloDesactiva plugins/temas desde File Manager

Espero que esta guía te haya sido de gran ayuda. Recuerda que, ante cualquier duda, tu equipo de soporte está aquí para ayudarte. ¡No dudes en contactarnos! Ahora, ve y arregla esa conexión. ¡Tu web te espera!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel