Conectar WordPress a Base de Datos MySQL: Solución de Errores y Configuración

Antes de empezar: ¿Qué significa conectar WordPress a una base de datos existente?

Cuando instalas WordPress por primera vez, el asistente te pide crear una base de datos nueva. Pero, ¿qué pasa si ya tienes una base de datos MySQL creada en tu servidor (por ejemplo, con datos de una web anterior, una copia de seguridad o un sitio que migras)? Conectarla es un proceso manual que se hace editando un archivo clave: wp-config.php.

Este artículo está pensado para que, aunque no seas una persona técnica, puedas realizar la conexión paso a paso y, sobre todo, solucionar los errores más comunes que aparecen en el camino. Vamos a ello.

¿Qué necesitas antes de empezar?

Para conectar WordPress a una base de datos existente, necesitas tener a mano estos cuatro datos:

Nombre de la base de datos (ejemplo: mipagina_db).
Usuario de la base de datos (ejemplo: admin_miweb).
Contraseña del usuario (la que se asignó al crear el usuario).
Host de la base de datos (normalmente localhost, pero a veces es algo como mysql.midominio.com).

[INFO] Si tu hosting usa Syspanel (accesible por el puerto 2106), puedes encontrar estos datos en la sección "Bases de datos" del panel. Allí verás listadas todas tus bases de datos y los usuarios asociados.

Paso 1: Localiza y edita el archivo wp-config.php

El archivo wp-config.php es el corazón de la configuración de WordPress. Se encuentra en la raíz de tu instalación, es decir, en la carpeta donde está instalado WordPress (por ejemplo, public_html/).

Cómo editarlo de forma segura

Accede a tu hosting por FTP (con FileZilla, por ejemplo) o desde el administrador de archivos de Syspanel.
Busca el archivo wp-config.php en la carpeta raíz.
Descárgalo a tu ordenador para tener una copia de seguridad antes de tocarlo.
Ábrelo con un editor de texto plano (como Bloc de Notas o Visual Studio Code). No uses Word porque puede añadir caracteres raros.

Qué líneas debes buscar

Dentro del archivo, verás una sección que dice:

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

Estas cuatro líneas son las que controlan la conexión. Si tienes una base de datos existente, deberás sustituir los valores por los de tu nueva base. Por ejemplo:

define( 'DB_NAME', 'mi_web_anterior' );
define( 'DB_USER', 'usuario_mi_web' );
define( 'DB_PASSWORD', 'MiClaveSegura123!' );
define( 'DB_HOST', 'localhost' );

[TIP] Si no estás seguro del host, prueba primero con localhost. Si no funciona, consulta en Syspanel (puerto 2106) la información de tu base de datos, porque algunos servidores usan un host distinto.

Paso 2: Guarda y sube el archivo

Una vez editado, guarda el archivo y súbelo de nuevo a la misma ubicación, reemplazando el original. Si lo hacías desde el administrador de archivos de Syspanel, guarda los cambios directamente.

Ahora intenta acceder a tu web. Si todo ha ido bien, WordPress cargará y verás tu sitio. Si no, no te preocupes: a continuación te explico los errores más típicos y cómo resolverlos.

Error 1: "Error al establecer una conexión con la base de datos" (Error establishing a database connection)

Este es, con diferencia, el error más común. Aparece una pantalla blanca con ese mensaje. Las causas pueden ser varias:

1.1 Datos incorrectos en wp-config.php

Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactamente los que tienes en tu panel de hosting. Un simple espacio o una letra mal escrita rompe la conexión.

[WARNING] Presta atención a las mayúsculas y minúsculas. MySQL es sensible a ellas. MiBase no es lo mismo que mibase.

1.2 El usuario no tiene permisos sobre la base de datos

A veces el usuario existe, pero no tiene privilegios sobre la base de datos. Esto es habitual si creaste la base de datos y el usuario por separado. Para solucionarlo:

Entra en Syspanel (puerto 2106).
Ve a "Bases de datos" y localiza tu base de datos.
Busca la opción de "Usuarios" o "Privilegios".
Asegúrate de que el usuario tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.) sobre esa base de datos concreta.

1.3 El host de la base de datos no es localhost

Algunos servidores usan un host distinto (por ejemplo, mysql.tudominio.com). Si tu web está en un plan compartido, el host suele ser localhost, pero si tienes un servidor dedicado o VPS, puede variar.

[INFO] En Syspanel, al crear una base de datos, te indica el host exacto que debes usar. No lo adivines: míralo ahí.

1.4 Contraseña con caracteres especiales mal escapados

Si tu contraseña contiene caracteres como $, ", ' o \, es posible que PHP los interprete mal. La solución es "escaparlos" añadiendo una barra invertida antes. Por ejemplo:

define( 'DB_PASSWORD', 'Mi\$Clave' );

O, más fácil, cambia la contraseña de la base de datos desde Syspanel por una sin caracteres especiales y actualízala en el archivo.

Error 2: "Una o más tablas no están disponibles" (One or more database tables are unavailable)

Este error suele aparecer cuando la base de datos a la que conectas no tiene las tablas de WordPress instaladas. Es decir, estás apuntando a una base de datos vacía o que pertenece a otra aplicación.

Cómo solucionarlo

Tienes dos opciones:

Instalar WordPress en esa base de datos: Si no tienes datos importantes, ve a tu dominio y sigue el asistente de instalación de WordPress. Te pedirá los datos y creará las tablas desde cero.
Importar una copia de seguridad: Si tienes un backup de un WordPress anterior, tendrás que importar el archivo .sql en la base de datos. Puedes hacerlo desde Syspanel (sección "Bases de datos" → "Importar") o con phpMyAdmin.

[TIP] Si vas a importar una copia, asegúrate de que el archivo .sql sea de una versión de WordPress compatible con la que tienes instalada.

Error 3: "El servidor no responde" o "Tiempo de espera agotado"

Este error es menos común, pero puede ocurrir. Significa que WordPress no puede contactar con el servidor MySQL. Las causas suelen ser:

3.1 El servidor MySQL está caído o saturado

A veces el servicio de base de datos se detiene. Si tu hosting es compartido, espera unos minutos y reintenta. Si tienes un VPS o servidor dedicado, reinicia el servicio MySQL desde Syspanel (sección "Servicios").

3.2 Puerto incorrecto

MySQL usa por defecto el puerto 3306. Si tu servidor usa otro puerto, tendrás que especificarlo en el host. Por ejemplo:

define( 'DB_HOST', 'localhost:3307' );

Consulta la documentación de tu hosting o el panel de Syspanel para saber si usan un puerto no estándar.

Error 4: "No se pudo seleccionar la base de datos" (Can't select database)

Este error indica que el usuario y la contraseña son correctos, pero WordPress no puede "entrar" en la base de datos concreta. Las causas:

4.1 El nombre de la base de datos es incorrecto

Revisa que el nombre en DB_NAME coincida exactamente con el que aparece en tu panel. Ojo con prefijos: algunos hostings añaden un prefijo al nombre (por ejemplo, tuusuario_miweb).

4.2 La base de datos no existe

Puede que la hayas borrado por error o que el nombre esté mal. Ve a Syspanel (puerto 2106) y comprueba que la base de datos aparece en la lista.

Error 5: "Error de sintaxis en la consulta SQL"

Este error suele aparecer al importar una base de datos o al instalar un plugin que ejecuta consultas. No es un problema de conexión, sino de la propia base de datos. Si te aparece al conectar, revisa que el archivo .sql que importaste sea válido y completo.

[WARNING] Si importaste una copia desde otro servidor, es posible que el archivo esté corrupto o incompleto. Descarga de nuevo el backup y verifica su tamaño.

Paso 3: Verifica que todo funciona

Una vez solucionado el error, es buena práctica comprobar que la conexión es estable:

Entra en el escritorio de WordPress (/wp-admin).
Ve a "Herramientas" → "Estado del sitio" (o "Salud del sitio").
Busca la sección de "Bases de datos" y verifica que todo aparece en verde.

También puedes instalar un plugin de caché y ver si la web carga correctamente.

Preguntas frecuentes (FAQ)

¿Puedo cambiar la base de datos de mi WordPress sin perder contenido?

Sí, siempre que la nueva base de datos tenga las mismas tablas y datos. La forma más segura es hacer una copia de seguridad completa de la base de datos actual y restaurarla en la nueva. Después, cambia los datos en wp-config.php.

¿Qué hago si no encuentro el archivo wp-config.php?

Puede que esté oculto. En tu cliente FTP, activa la opción de "Mostrar archivos ocultos". En Syspanel, el administrador de archivos suele mostrarlo por defecto.

¿Es lo mismo conectar WordPress a MySQL que a MariaDB?

Sí, en la práctica son compatibles. WordPress funciona igual con MariaDB, que es un clon de MySQL muy usado en hostings modernos.

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

Técnicamente sí, pero no es recomendable. Las dos instalaciones compartirían las mismas tablas, lo que provoca conflictos de configuración y de datos. Mejor crea una base de datos separada para cada sitio.

¿Qué hago si sigo sin poder conectar tras probar todo?

Contacta con el soporte de tu hosting. A veces el problema está en el firewall del servidor o en la configuración de red. Si usas Syspanel, su soporte suele responder rápido.

Consejos finales para evitar errores futuros

Haz siempre una copia de seguridad del wp-config.php antes de editarlo.
Apunta los datos de la base de datos en un lugar seguro (gestor de contraseñas).
Actualiza la contraseña de la base de datos periódicamente desde Syspanel (puerto 2106).
No uses caracteres especiales en contraseñas si no es necesario; simplifica la vida.
Prueba la conexión con un script PHP simple antes de tocar WordPress, si te sientes cómodo.

Conectar WordPress a una base de datos MySQL existente no tiene por qué ser un dolor de cabeza. Con este artículo, los datos correctos en wp-config.php y un poco de paciencia, tendrás tu web funcionando en pocos minutos. Recuerda: la mayoría de los errores se deben a datos mal escritos o a permisos insuficientes, así que revisa siempre esas dos cosas primero.

Si te ha quedado alguna duda, repasa los pasos y no dudes en consultar la documentación de tu hosting. ¡Buena suerte con tu WordPress!