Conectar WordPress a MySQL | Errores de conexión

¿Por qué WordPress necesita una base de datos MySQL?

WordPress no es solo archivos PHP, CSS y JavaScript. La parte "viva" de tu web (entradas, páginas, comentarios, usuarios, ajustes) se guarda en una base de datos MySQL. Piensa en la base de datos como el almacén central donde WordPress guarda toda la información, y el código PHP actúa como el encargado que va a buscar esos datos para mostrarlos en tu pantalla.

Cuando instalas WordPress por primera vez, el instalador te pedirá cuatro datos clave: el nombre de la base de datos, el usuario, la contraseña y el host (servidor). Esos datos se guardan en un archivo llamado wp-config.php, que es el corazón de la configuración de WordPress.

Si esos datos no coinciden con los que tiene tu servidor, o si el servidor de base de datos no está accesible, verás el temido mensaje de "Error al conectar con la base de datos". A lo largo de esta guía te enseñaré, paso a paso, cómo hacer la conexión correctamente y cómo solucionar los errores más comunes cuando algo sale mal.

Qué necesitas antes de empezar a conectar WordPress MySQL

Antes de lanzarte a editar archivos, asegúrate de tener a mano la siguiente información. Sin ella, será imposible completar la conexión:

Nombre de la base de datos: suele ser algo como usuario_wpdb o basedatos_principal.
Usuario de la base de datos: normalmente distinto del usuario de hosting, por ejemplo usuario_wpuser.
Contraseña: la que asignaste al crear el usuario de la base de datos.
Host de la base de datos: normalmente localhost, pero puede ser un servidor remoto como mysql.tudominio.com o una IP.
Prefijo de tablas: aunque no es imprescindible para conectar, sí que lo necesitarás si tu base de datos usa un prefijo distinto al estándar wp_.

Si estás usando un panel de control como cPanel, Plesk o Syspanel (recuerda que Syspanel es el nombre de HestiaCP en este artículo, y su puerto de acceso es el 2106), podrás encontrar toda esta información en la sección de "Bases de datos MySQL".

Cómo conectar WordPress a una base de datos MySQL paso a paso

Aquí tienes el proceso completo, tanto si estás instalando WordPress desde cero como si ya tienes el código y solo necesitas conectarlo a una base de datos existente.

1. Crear la base de datos y el usuario en tu hosting

Lo primero es tener una base de datos creada. Si tu web ya está montada, seguramente ya la tienes. Si no, sigue estos pasos:

Accede a tu panel de control de hosting (cPanel, Plesk o Syspanel en el puerto 2106).
Busca la sección "Bases de datos MySQL" o "MySQL Databases".
Crea una nueva base de datos con un nombre descriptivo, por ejemplo mipagina_wp.
Crea un usuario para esa base de datos, por ejemplo mipagina_user, con una contraseña segura.
Asigna todos los privilegios al usuario sobre esa base de datos (SELECT, INSERT, UPDATE, DELETE, etc.). En la mayoría de paneles, marcar "All Privileges" es lo correcto.

[INFO] En Syspanel (HestiaCP), la gestión de bases de datos está en la sección "Base de datos" del panel. El acceso al panel es https://tu-dominio.com:2106. Ahí podrás crear la base de datos y el usuario en unos pocos clics.

2. Localizar y editar el archivo wp-config.php

El archivo wp-config.php está en la raíz de tu instalación de WordPress. Si no lo ves, puede estar oculto. Necesitarás un cliente FTP (como FileZilla) o el administrador de archivos de tu hosting para verlo.

Dentro de ese archivo, busca el bloque que dice:

// ** Ajustes de MySQL ** //
define( 'DB_NAME', 'nombre_base_datos' );
define( 'DB_USER', 'usuario_base_datos' );
define( 'DB_PASSWORD', 'contraseña_usuario' );
define( 'DB_HOST', 'localhost' );

Ahora, sustituye los valores por los que has creado:

DB_NAME: pon el nombre exacto de tu base de datos.
DB_USER: el usuario que has creado.
DB_PASSWORD: la contraseña de ese usuario.
DB_HOST: normalmente localhost, pero si tu hosting usa un servidor de base de datos externo, te lo indicarán en la documentación del hosting. A veces es algo como mysql.tudominio.com.

Guarda el archivo y súbelo de nuevo si lo editaste localmente.

3. Probar la conexión

Una vez guardado, intenta acceder a tu web. Si todo está bien, verás tu sitio cargando con normalidad. Si estás en plena instalación, WordPress te pedirá el idioma y luego te mostrará la pantalla de configuración del sitio.

[TIP] Si estás instalando WordPress por primera vez, puedes dejar el archivo wp-config.php sin los datos de la base de datos. WordPress te mostrará un asistente visual donde podrás introducir los datos. Al final, él mismo generará el archivo wp-config.php con los valores correctos.

Errores comunes al conectar WordPress con MySQL (y sus soluciones)

Aquí es donde la mayoría de usuarios se atasca. Te explico los errores más frecuentes y cómo solucionarlos de forma clara.

Error: "Error al conectar con la base de datos" en WordPress

Es el mensaje genérico más común. Aparece cuando WordPress no puede comunicarse con MySQL. Las causas más habituales son:

Datos incorrectos en wp-config.php: revisa que el nombre, usuario y contraseña estén escritos exactamente igual que en el panel de hosting. Un espacio extra o una letra en mayúscula puede romper la conexión.
El servidor de base de datos no está activo: en algunos hostings, el servicio MySQL puede caerse temporalmente. Espera unos minutos y vuelve a intentarlo.
El host no es correcto: si tu hosting usa un servidor de base de datos remoto, localhost no funcionará. Consulta la documentación del hosting para obtener el host correcto.

Error: "No se puede seleccionar la base de datos"

Este error suele aparecer cuando el usuario de la base de datos no tiene permisos sobre la base de datos. La solución es:

Entra en tu panel de hosting.
Ve a la sección de bases de datos MySQL.
Asegúrate de que el usuario está añadido a la base de datos.
Marca todos los privilegios (o al menos los básicos: SELECT, INSERT, UPDATE, DELETE).

Error: "Demasiadas conexiones"

Cuando tu web recibe mucho tráfico o hay un plugin que hace consultas excesivas, MySQL puede agotar el límite de conexiones. Si ves este error:

Revisa si tienes plugins de caché activados; a veces conviene aumentarlos.
Contacta con tu proveedor de hosting para que aumente el límite en el servidor.
Comprueba si hay algún script que esté haciendo un bucle infinito de consultas (esto suele estar relacionado con plugins mal configurados).

Error: "El servidor MySQL se ha ido" (MySQL server has gone away)

Este error suele deberse a que el servidor de base de datos tiene un tiempo de espera demasiado corto, o a que el paquete de datos que envías es demasiado grande. Las soluciones más efectivas son:

Aumentar el límite de memoria de WordPress en wp-config.php añadiendo esta línea:
```
define( 'WP_MEMORY_LIMIT', '256M' );
```
Contactar con el hosting para que aumente max_allowed_packet en MySQL.
Si tienes acceso al servidor, puedes editar el archivo my.cnf y aumentar los valores de wait_timeout y max_allowed_packet.

[WARNING] Cambiar la configuración del servidor MySQL puede afectar a otras webs que compartan el mismo servidor. Si no tienes experiencia, consulta antes con tu proveedor de hosting.

Error: "Falta la tabla wp_options" o "La tabla no existe"

Esto significa que la base de datos está vacía o que las tablas se han eliminado. Si tienes una copia de seguridad, puedes restaurarla desde el panel de hosting. Si no, tendrás que reinstalar WordPress desde cero (perderás el contenido).

Solucionar el error de conexión usando el archivo wp-config.php

Si WordPress te da el error de conexión, puedes intentar forzar la depuración para ver más detalles. Edita wp-config.php y añade estas líneas justo antes de la línea que dice /* ¡Eso es todo, deja de editar! */:

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

Guarda el archivo y recarga tu web. Ahora, WordPress creará un archivo de log llamado debug.log en la carpeta wp-content. Ábrelo con un editor de texto y verás el error exacto que está ocurriendo. Esto es oro puro para diagnosticar el problema.

[INFO] Recuerda desactivar el modo de depuración cuando termines de arreglar el problema. Dejar WP_DEBUG activo en producción puede mostrar errores a tus visitantes y ralentizar la web.

Base de datos WordPress hosting: cómo saber si el problema es de tu hosting

A veces la conexión falla por motivos ajenos a tu configuración. Estos son los síntomas de que el problema está en el servidor de hosting:

Todas tus webs dan el mismo error: si tienes varias webs y todas fallan, el problema es del servidor.
El panel de control de hosting también da error: si no puedes acceder a Syspanel (puerto 2106) o a cPanel, el servidor tiene problemas.
El servicio MySQL aparece como "caído" en el panel de estado de tu hosting.

En estos casos, la solución es contactar con el soporte técnico de tu proveedor. Ellos podrán reiniciar el servicio MySQL o solucionar el problema en el servidor.

Preguntas frecuentes (FAQ) sobre conectar WordPress a MySQL

¿Qué hago si no recuerdo la contraseña de la base de datos?

Si tienes acceso al panel de hosting, puedes cambiar la contraseña del usuario de la base de datos desde la sección de bases de datos MySQL. Luego actualiza el archivo wp-config.php con la nueva contraseña.

¿Puedo cambiar el host de la base de datos en WordPress?

Sí, solo tienes que editar DB_HOST en wp-config.php. Sin embargo, si tu hosting usa localhost, no deberías cambiarlo a menos que sepas exactamente lo que estás haciendo. Cambiar el host a un valor incorrecto provocará un error de conexión.

¿Qué es el prefijo de tablas en WordPress?

Es el prefijo que se añade antes del nombre de cada tabla de la base de datos. Por defecto es wp_. Si usas un prefijo distinto, asegúrate de que en wp-config.php la línea $table_prefix = 'wp_'; coincida con el prefijo de tus tablas. Si no, WordPress no encontrará las tablas y te dará errores.

¿Es lo mismo MySQL y MariaDB?

A efectos prácticos, sí. MariaDB es un clon de MySQL y la mayoría de hostings lo usan. Los comandos y la forma de conectar son idénticos. Si tu hosting usa MariaDB, no tendrás que hacer nada diferente.

¿Cómo sé si mi base de datos está bien conectada?

La forma más rápida es entrar en el administrador de WordPress (/wp-admin). Si puedes entrar y ves tus entradas y páginas, la conexión es correcta. También puedes instalar un plugin como "Health Check & Troubleshooting" que te mostrará el estado de la conexión a la base de datos.

Consejos finales para evitar problemas de conexión MySQL

Haz copias de seguridad periódicas de tu base de datos. En Syspanel (HestiaCP), puedes configurar copias automáticas desde la sección de "Backups".
No compartas la contraseña de la base de datos con nadie que no deba tenerla.
Usa contraseñas robustas para el usuario de la base de datos.
Mantén WordPress actualizado y evita plugins de dudosa procedencia que puedan hacer consultas SQL excesivas.
Si cambias de hosting, asegúrate de exportar la base de datos e importarla en el nuevo servidor antes de cambiar la configuración de wp-config.php.

Conectar WordPress a una base de datos MySQL no es complicado si sigues estos pasos y entiendes qué hace cada parámetro. La mayoría de errores se deben a datos mal escritos o a permisos insuficientes, así que revisa bien esa parte antes de entrar en pánico.

Si después de todo sigues teniendo el error de conexión, respira hondo, revisa el log de depuración y contacta con tu hosting. La paciencia y un buen diagnóstico son las mejores herramientas para resolver cualquier problema con tu base de datos WordPress hosting.