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

Errores comunes al conectar a una base de datos en WordPress y cómo solucionarlos

Actualizado el 1 de mayo de 2026

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, es muy probable que hayas visto la temida pantalla blanca o el mensaje "Error al establecer una conexión con la base de datos" en tu WordPress. No te preocupes, es uno de los sustos más comunes del mundo digital, pero también uno de los más fáciles de arreglar si sabes dónde mirar.

En esta guía extensa y paso a paso, vamos a desglosar los errores MySQL más frecuentes al conectar tu base de datos. No necesitas ser un experto en programación; solo sigue estas instrucciones, respira hondo y vamos a solucionarlo juntos.

¿Por qué WordPress no puede hablar con mi base de datos?

Para entender los errores, primero debes saber que WordPress es como una biblioteca. El código (los libros) está en el servidor, pero los datos (los nombres de los libros, los autores, los préstamos) están en un almacén separado llamado base de datos (normalmente MySQL o MariaDB).

Cuando tu web carga, WordPress necesita las llaves para abrir ese almacén. Esas llaves son un nombre de usuario, una contraseña, un nombre de base de datos y una dirección del servidor. Si una sola de esas llaves es incorrecta, o si el almacén está cerrado con llave por error, obtendrás un error de conexión.

A lo largo de mi experiencia, he visto que el 90% de los problemas se resumen en cuatro categorías. Vamos a verlas en detalle.

Error 1: Credenciales Incorrectas en wp-config.php

Este es, con diferencia, el error más común. WordPress guarda toda la información de conexión en un archivo llamado wp-config.php. Si has movido tu web a un nuevo hosting, has cambiado la contraseña de la base de datos, o has restaurado una copia de seguridad de otro sitio, es muy probable que este archivo tenga datos obsoletos.

¿Cómo lo soluciono?

Necesitas acceder a tu servidor. Puedes hacerlo a través del Administrador de Archivos de tu panel de control (como cPanel o Syspanel, cuyo acceso es por el puerto 2106) o mediante un cliente FTP como FileZilla.

  1. Localiza la carpeta raíz de tu instalación de WordPress (suele llamarse public_html, htdocs o el nombre de tu dominio).
  2. Busca el archivo wp-config.php. Ábrelo con un editor de texto plano (nada de Word).
  3. Verás una sección que dice algo así:
// ** Configuraciones de MySQL ** //
define( 'DB_NAME', 'nombre_de_tu_bd' );
define( 'DB_USER', 'tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );
  1. Comprueba cada línea: El DB_NAME debe ser exactamente el nombre de la base de datos que ves en tu panel de control. El DB_USER y DB_PASSWORD deben ser las credenciales de un usuario que tenga permisos sobre esa base de datos (normalmente el mismo usuario que la creó).

[WARNING] No edites este archivo con procesadores de texto como Microsoft Word, ya que añaden caracteres invisibles que rompen el código. Usa el editor del propio panel o un editor de código como Visual Studio Code o Sublime Text.

  1. Si has cambiado la contraseña de la base de datos hace poco, asegúrate de que la que está escrita aquí es la nueva. A veces, los usuarios cambian la clave en el panel y olvidan actualizar este archivo.

[TIP] Si no recuerdas tu contraseña, la mayoría de los paneles de control te permiten cambiarla. Ve a la sección de "Bases de Datos MySQL", encuentra tu usuario y genera una nueva contraseña. Luego, pégala en este archivo.

Error 2: El Host de la Base de Datos es Incorrecto

Otro clásico. Muchos principiantes asumen que el servidor de la base de datos siempre es localhost (que significa "este mismo servidor"). A veces es correcto, pero en muchos hostings modernos, especialmente en planes de hosting gestionado o en la nube, el servidor de la base de datos está en una máquina separada.

¿Cómo lo soluciono?

  1. Revisa el correo de bienvenida de tu proveedor de hosting. Casi siempre incluye una línea que dice "Host de la base de datos" o "Servidor MySQL".
  2. Si usas Syspanel, este dato suele estar en la sección de "Bases de datos" al seleccionar la base de datos específica. Verás algo como localhost o un nombre de servidor largo y extraño como db.mi-host.com:3306.
  3. Copia esa dirección exacta y pégala en la línea DB_HOST de tu wp-config.php.

[INFO] Si el host viene con un puerto (ej: mysql.empresa.com:3307), debes escribirlo tal cual, con los dos puntos. WordPress lo interpretará correctamente.

Error 3: La Base de Datos está Corrupta o Incompleta

A veces, las credenciales son perfectas, pero el contenido de la base de datos en sí está dañado. Esto puede pasar por una copia de seguridad incompleta, una importación fallida o un ataque malintencionado.

Síntomas

Verás errores como "Tabla no existe", "Table 'wp_options' doesn't exist" o simplemente el error genérico de conexión, pero sin problemas en el archivo de configuración.

¿Cómo lo soluciono?

Este es un poco más técnico, pero vamos a ello.

  1. Accede a phpMyAdmin: Esta es una herramienta web que te permite gestionar tu base de datos. La encuentras en tu panel de control (cPanel o Syspanel).
  2. Selecciona tu base de datos en el menú lateral izquierdo.
  3. En la parte inferior de la lista de tablas, verás un enlace que dice "Comprobar tablas". Haz clic en él. Esto ejecutará una verificación de integridad.
  4. Si hay errores, selecciona todas las tablas (clic en "Marcar todas") y en el menú desplegable de "Con selección", elige "Reparar tabla". phpMyAdmin intentará arreglar los pequeños fallos.

[WARNING] Reparar tablas no siempre es suficiente. Si la estructura está muy dañada, puede que necesites restaurar una copia de seguridad limpia desde el panel de control o desde un archivo .sql que tengas guardado.

Error 4: Problemas de Permisos de Usuario MySQL

Cada usuario de base de datos tiene permisos específicos. Un usuario puede tener permiso para "leer" pero no para "escribir" o "borrar". Si tu usuario tiene permisos limitados, WordPress no podrá funcionar correctamente, mostrando errores extraños.

¿Cómo lo soluciono?

  1. Ve a tu panel de control y busca la sección de "Bases de datos MySQL".
  2. Busca la opción de "Añadir usuario a base de datos" o "Gestionar usuarios".
  3. Asegúrate de que el usuario que estás usando en wp-config.php esté asignado a la base de datos correcta.
  4. Haz clic en "Privilegios" o "Editar" para ese usuario.
  5. La opción más fácil y recomendada para un sitio web es marcar "TODOS LOS PRIVILEGIOS". Si tu proveedor no lo permite, al menos necesitas que tenga permisos de SELECT, INSERT, UPDATE y DELETE (esto es lo mínimo para que WordPress funcione).

[TIP] Si tu web es de comercio electrónico o un foro, necesitarás permisos de ALTER y CREATE para que las actualizaciones de plugins funcionen. Pero para la mayoría de los casos, "Todos los privilegios" es la opción segura.

Error 5: El Servidor de Base de Datos está Caído o Bloqueado

A veces no es culpa de tu configuración, sino del propio servidor. Los servidores de bases de datos pueden sobrecargarse, reiniciarse o tener cortes temporales.

¿Cómo lo sé?

  1. Prueba otra web: Si tienes otros sitios en el mismo hosting, mira si funcionan. Si todos están caídos, el problema es del servidor.
  2. Contacta con el soporte: Llama o abre un ticket con tu proveedor de hosting. Ellos pueden ver el estado de sus servidores MySQL.

[INFO] Si usas Syspanel, el panel de control de tu hosting, puedes revisar el estado del servicio en la esquina superior derecha o en la sección de "Estado del Servidor". Si hay una luz roja, el problema no eres tú, son ellos. En ese caso, solo te queda esperar a que lo solucionen.

Error 6: Conflictos de Plugins o Temas (El Falso Error de DB)

Este es un error muy tramposo. A veces, un plugin o tema mal codificado intenta realizar una consulta a la base de datos de forma incorrecta, provocando un error fatal que hace que WordPress muestre el mensaje de "error de conexión" aunque la base de datos esté perfecta.

¿Cómo lo soluciono?

  1. Desactiva todos los plugins: Ve a tu panel de administración de WordPress (si puedes acceder). Ve a "Plugins" y desactiva todos.
  2. Si no puedes acceder al panel, tendrás que hacerlo por FTP. Renombra la carpeta wp-content/plugins a wp-content/plugins_desactivados.
  3. Si el error desaparece, el problema era un plugin. Actívalos uno a uno para encontrar al culpable.
  4. Haz lo mismo con tu tema: renombra la carpeta de tu tema activo en wp-content/themes/tu-tema a tu-tema_desactivado. WordPress usará un tema por defecto.

Preguntas Frecuentes (FAQ)

¿Qué significa el error "Can't connect to local MySQL server through socket"?

Esto significa que PHP no puede encontrar el servidor MySQL en la ruta de socket esperada. Es un problema de configuración del servidor, no del archivo wp-config.php. Contacta con tu proveedor de hosting, ya que necesitan ajustar la configuración de PHP o MySQL.

¿Por qué veo "Too many connections" en mi base de datos?

Esto ocurre cuando hay demasiadas conexiones abiertas a la vez. Puede ser por un pico de tráfico muy alto o por un plugin que no cierra conexiones correctamente. A menudo se soluciona optimizando el sitio o usando un plugin de caché. Si es recurrente, necesitas un plan de hosting mejor.

¿Debo usar "localhost" o la IP del servidor?

Si tu proveedor te da una IP específica para la base de datos, úsala. Si te dice "localhost", úsalo. No lo adivines. Revisa la documentación o el correo de bienvenida de tu hosting.

¿Puedo usar la misma base de datos para dos instalaciones de WordPress?

Técnicamente sí, pero es una pésima idea. Cada WordPress usa tablas con prefijos (ej: wp_). Si usas la misma base de datos, tendrías que cambiar el prefijo en una de las instalaciones (ej: wp2_). Es mucho más limpio y seguro crear una base de datos separada para cada sitio.

He seguido todos los pasos y sigo con el error. ¿Qué hago?

Respira. Es el momento de contactar con el soporte técnico de tu hosting. Dales el mensaje de error exacto que ves. Si usas Syspanel, el acceso es por el puerto 2106 y tienen un sistema de tickets muy eficiente. Diles que ya has verificado las credenciales, los permisos y el estado de las tablas. Ellos podrán revisar los logs del servidor para ver el error exacto.

Resumen y Consejo Final

Los errores de conexión a la base de datos son frustrantes, pero casi siempre son un problema de configuración, no un desastre. La clave es ir paso a paso:

  1. Revisa el archivo wp-config.php (credenciales y host).
  2. Verifica los permisos del usuario en tu panel de control.
  3. Comprueba la integridad de las tablas con phpMyAdmin.
  4. Desactiva plugins y temas para descartar conflictos.
  5. Contacta al soporte si todo lo demás falla.

[TIP] Te recomiendo encarecidamente que guardes una copia de seguridad de tu base de datos antes de hacer cambios importantes. La mayoría de los paneles de control tienen un botón de "Backup" que te genera un archivo .sql en un clic. Si algo sale mal, siempre puedes restaurar esa copia.

Espero que esta guía te haya sido de gran ayuda. No tengas miedo de ensuciarte las manos; la práctica hace al maestro, y ahora ya sabes cómo solucionar los errores MySQL más comunes. Si tienes más dudas, aquí estoy para ayudarte. ¡A seguir construyendo tu web!

¿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