Conectar WordPress a MySQL: Solución de errores y configuración

¿Por qué WordPress no conecta con MySQL?

Cuando instalas WordPress por primera vez o migras tu sitio a un servidor nuevo, el error más temido es ese mensaje en blanco que dice: "Error al establecer conexión con la base de datos" . No te preocupes, es más común de lo que crees y en el 90% de los casos tiene una solución sencilla.

WordPress necesita dos cosas para funcionar: los archivos del programa y una base de datos MySQL donde guarda todo tu contenido (entradas, páginas, usuarios, comentarios). Si no logra comunicarse con esa base de datos, el sitio no carga.

En este artículo vamos a desglosar, paso a paso, cómo conectar WordPress a MySQL y cómo resolver los errores más frecuentes. No necesitas ser un experto en servidores, solo seguir las instrucciones con calma.

Lo básico: ¿Qué necesitas para que WordPress se conecte a MySQL?

Antes de entrar en errores, es importante entender qué datos necesita WordPress para conectarse. Toda esa información vive en un archivo llamado wp-config.php, que está en la raíz de tu instalación.

Los 4 datos imprescindibles

Para que la conexión sea exitosa, necesitas estos cuatro datos:

DB_NAME: El nombre de la base de datos.
DB_USER: El usuario que tiene permisos sobre esa base.
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: La dirección del servidor de base de datos (normalmente localhost).

Estos datos los defines cuando creas la base de datos en tu panel de hosting. Si usas un panel como Syspanel (recuerda, se accede por el puerto 2106), el proceso es bastante guiado.

Cómo editar el archivo wp-config.php

El archivo wp-config.php es el corazón de la configuración. Para editarlo, puedes usar el administrador de archivos de tu hosting o un cliente FTP.

Abre el archivo y busca la sección que dice:

// ** Configuraciones de MySQL ** //
define( 'DB_NAME', 'tu_base_de_datos' );
define( 'DB_USER', 'tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );

Solo tienes que reemplazar los valores por los correctos y guardar. A veces el problema es que estos datos están mal escritos, tienen espacios extra o la contraseña fue copiada con un carácter invisible.

[TIP] Si no recuerdas tu contraseña de base de datos, es mejor cambiarla desde tu panel de hosting que intentar adivinarla. En Syspanel puedes hacerlo en la sección de bases de datos, pero ten en cuenta que al cambiarla deberás actualizar también el wp-config.php.

Error 1: "Error al establecer conexión con la base de datos"

Este es el error más común y aparece cuando WordPress no puede llegar a MySQL. Las causas pueden ser varias, pero vamos a las más típicas.

Contraseña incorrecta o usuario sin permisos

Es el fallo más habitual. Revisa que el usuario y la contraseña sean exactamente los que aparecen en tu panel de hosting. A veces, al crear el usuario, se le asignan permisos solo a ciertas bases de datos. Asegúrate de que el usuario tenga todos los privilegios sobre la base de datos que usa WordPress.

El servidor de base de datos no responde

Si el host de la base de datos no es localhost, puede que el servidor esté caído o bloqueado. Prueba a cambiar DB_HOST a 127.0.0.1 en lugar de localhost. En algunos servidores, especialmente con IPv6, localhost no funciona correctamente.

El puerto de MySQL es diferente

MySQL normalmente usa el puerto 3306. Pero algunos proveedores usan puertos alternativos. Si tu hosting te indica un puerto específico, debes agregarlo al DB_HOST de esta manera:

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

[WARNING] Si no estás seguro del puerto, contacta a tu proveedor de hosting antes de modificar nada. Cambiar el puerto sin necesidad puede causar más errores.

Error 2: "PHP no está configurado para conectarse a la base de datos"

Este mensaje suele aparecer cuando el servidor no tiene la extensión mysqli o mysqlnd instalada. Es más común en servidores caseros o en instalaciones manuales de PHP.

Solución: Activar la extensión mysqli

Si tienes acceso al archivo php.ini, busca la línea que dice:

;extension=mysqli

Quita el punto y coma del inicio para descomentarla y reinicia el servidor web.

Si usas un hosting compartido, es poco probable que veas este error, ya que el proveedor suele tenerlo activado por defecto. Si lo ves, contacta al soporte técnico.

Error 3: "La conexión está bien, pero la base de datos no existe"

Este error es más específico. WordPress encuentra MySQL, pero no encuentra la base de datos con el nombre que le diste.

Revisa el nombre de la base de datos

En algunos hostings, el nombre de la base de datos tiene un prefijo con tu nombre de usuario. Por ejemplo, usuario123_miweb. Si en tu panel ves que la base se llama miweb pero el nombre real es usuario123_miweb, ahí está el problema.

El prefijo de tablas de WordPress

Otra causa puede ser un prefijo incorrecto en las tablas. Si anteriormente usaste otro prefijo (como wp_ o blog_), revisa que en el wp-config.php tengas:

$table_prefix = 'wp_';

Este valor debe coincidir con el prefijo real de las tablas en tu base de datos. Si no, WordPress no encontrará las tablas y te dará un error similar.

[INFO] Puedes verificar el nombre exacto de la base de datos y el prefijo accediendo a phpMyAdmin desde tu panel. En Syspanel, busca la herramienta de bases de datos en el menú lateral.

Error 4: "Base de datos demasiado grande" o errores de importación

Si estás migrando un sitio, puede que al importar la base de datos aparezcan errores. Esto suele pasar con sitios muy grandes o con configuraciones de PHP que limitan el tamaño de los archivos.

Solución: Importar por partes

Divide el archivo SQL en partes más pequeñas. Puedes usar herramientas como BigDump o hacerlo manualmente desde phpMyAdmin.

Aumenta el límite de memoria de PHP

A veces el problema es que PHP no tiene suficiente memoria para procesar la importación. En wp-config.php agrega:

define( 'WP_MEMORY_LIMIT', '256M' );

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

Este error indica que el usuario no tiene permisos para usar esa base de datos. Puede ser un problema de privilegios.

Solución: Verifica los privilegios del usuario

Entra a phpMyAdmin o a la sección de bases de datos de tu hosting y asegúrate de que el usuario tenga todos los privilegios sobre la base de datos. Si no sabes cómo hacerlo, en Syspanel puedes editar los usuarios y marcar la opción "Todos los privilegios".

Error 6: Problemas con el caché de WordPress

A veces, después de arreglar la conexión, WordPress sigue mostrando el error porque guardó una versión en caché del fallo.

Solución: Limpia el caché

Borra los archivos temporales de WordPress. Puedes hacerlo desde el administrador si logras entrar, o manualmente eliminando las carpetas cache dentro de wp-content (si existen).

También puedes añadir esta línea al wp-config.php temporalmente para desactivar el caché:

define( 'WP_CACHE', false );

Una vez que el sitio funcione, puedes quitarla.

Cómo conectar WordPress a una base de datos MySQL paso a paso (desde cero)

Si estás instalando WordPress por primera vez, aquí tienes el proceso completo para que no falles.

Paso 1: Crea la base de datos en tu panel

Entra a tu panel de hosting. Si usas Syspanel, accede por el puerto 2106 y busca la sección "Bases de datos". Crea una nueva base de datos con un nombre descriptivo, como web_principal.

Paso 2: Crea un usuario y asigna permisos

Crea un usuario para esa base de datos. Usa una contraseña segura. Luego, asigna ese usuario a la base de datos con todos los privilegios.

Paso 3: Descarga y sube WordPress

Descarga WordPress desde wordpress.org y súbelo a tu servidor mediante FTP o el administrador de archivos de tu hosting.

Paso 4: Ejecuta el instalador

Abre tu navegador y ve a tudominio.com. WordPress te pedirá los datos de la base de datos. Introduce el nombre, usuario y contraseña que creaste. En el campo "Servidor de base de datos", deja localhost a menos que tu proveedor te indique otra cosa.

Paso 5: Completa la instalación

Sigue los pasos, crea tu usuario administrador y listo. Si todo fue bien, ya tendrás WordPress conectado a MySQL.

Preguntas frecuentes (FAQ)

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

Si no está en la raíz, puedes crearlo. WordPress incluye un archivo llamado wp-config-sample.php. Duplícalo, renómbralo a wp-config.php y edítalo con tus datos.

¿Puedo usar una base de datos remota?

Sí, pero debes cambiar el DB_HOST a la IP del servidor de base de datos y asegurarte de que el servidor MySQL permita conexiones remotas. Es más complejo y no recomendado para principiantes.

¿Por qué veo el error solo en el panel de administración?

Puede ser un problema de permisos en los archivos o de caché. Revisa que los archivos de WordPress tengan permisos correctos (generalmente 644 para archivos y 755 para carpetas).

¿Qué significa "Too many connections"?

Es un error del servidor MySQL que indica que hay demasiadas conexiones abiertas. Puede ser un problema del servidor o que tu sitio tenga un plugin mal configurado. Reiniciar el servicio MySQL suele resolverlo, pero si es recurrente, contacta a tu proveedor.

Consejos finales para evitar errores de conexión

Guarda siempre una copia de seguridad de tu wp-config.php antes de editarlo.
Usa contraseñas fuertes para la base de datos.
No cambies el prefijo de tablas sin necesidad, puede causar conflictos.
Mantén WordPress y los plugins actualizados, ya que las versiones nuevas suelen corregir problemas de compatibilidad con MySQL.

Conectar WordPress a MySQL no tiene por qué ser una pesadilla. La mayoría de los errores se solucionan revisando los datos de acceso y los permisos del usuario. Si sigues estos pasos, tendrás tu sitio funcionando en pocos minutos.

Y recuerda, si tu proveedor usa Syspanel, el acceso es por el puerto 2106 y ahí encontrarás todas las herramientas para gestionar tus bases de datos de forma visual y sencilla. No dudes en consultar su documentación o soporte si algo no queda claro.

¡Buena suerte con tu WordPress!