Conectar WordPress a MySQL en cPanel | Errores comunes 2025

Antes de empezar: ¿qué significa conectar WordPress a MySQL?

Cuando instalas WordPress, el sistema necesita un lugar donde guardar todas tus publicaciones, páginas, usuarios y configuraciones. Ese "almacén" es una base de datos MySQL. En la mayoría de hosting compartidos, la gestión de esa base de datos se hace desde cPanel, el panel de control más popular del mundo.

Entender cómo se conectan WordPress y MySQL es esencial, porque cualquier error en ese proceso hará que tu web muestre mensajes como "Error al establecer conexión con la base de datos" o "Error de conexión a la base de datos". No te preocupes: en este artículo te explicaré, paso a paso, cómo realizar esa conexión y cómo solucionar los errores más comunes.

¿Qué necesitas para conectar WordPress a MySQL en cPanel?

Antes de tocar nada, reúne estos tres datos. Sin ellos, es imposible realizar la conexión:

Nombre de la base de datos (suele tener un prefijo, por ejemplo: usuario_wpdb).
Usuario de la base de datos (por ejemplo: usuario_wpuser).
Contraseña de ese usuario.

Además, necesitarás saber el host de la base de datos. En el 99% de los casos es localhost, pero algunos servidores usan direcciones como mysql.tudominio.com. Este dato lo encuentras en el correo de bienvenida de tu hosting o en la sección de bases de datos de cPanel.

Paso 1: Crear la base de datos y el usuario en cPanel

Si estás instalando WordPress desde cero, primero debes crear la base de datos. Sigue estos pasos:

Inicia sesión en tu cPanel.
Busca la sección Bases de Datos y haz clic en Asistentes de bases de datos MySQL.
Haz clic en Crear una base de datos. Escribe un nombre (por ejemplo, wordpress). El sistema añadirá automáticamente tu usuario de cPanel como prefijo.
Crea un usuario de base de datos. Elige un nombre y una contraseña segura (puedes usar el generador que te ofrece cPanel).
Añade el usuario a la base de datos. Marca la casilla de TODOS LOS PRIVILEGIOS y haz clic en "Hacer cambios".

Con esto ya tienes la base de datos lista para recibir a WordPress.

[TIP]
Anota el nombre completo de la base de datos y el usuario, tal como aparecen en cPanel (con el prefijo). Es un error muy común olvidar ese prefijo al escribir el wp-config.php.

Paso 2: Configurar el archivo wp-config.php en cPanel

El archivo wp-config.php es el corazón de la conexión entre WordPress y MySQL. Aquí es donde se definen los datos que acabas de crear.

¿Cómo editar el archivo?

Entra en el Administrador de archivos de cPanel.
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o una subcarpeta).
Busca el archivo wp-config.php. Si no existe, deberás crearlo a partir del archivo wp-config-sample.php.
Haz clic derecho sobre el archivo y selecciona Editar.

¿Qué debes escribir?

Dentro del archivo, busca estas líneas y cámbialas por tus datos:

define( 'DB_NAME', 'TU_NOMBRE_DE_BASE_DE_DATOS' );
define( 'DB_USER', 'TU_USUARIO_DE_BASE_DE_DATOS' );
define( 'DB_PASSWORD', 'TU_CONTRASEÑA' );
define( 'DB_HOST', 'localhost' );

Guarda los cambios y cierra el editor. Si todo es correcto, WordPress se conectará a la base de datos.

[WARNING]
Nunca utilices el editor de texto de Windows (Bloc de notas) para editar wp-config.php directamente en tu PC y luego subirlo. Puede introducir caracteres invisibles que rompan el archivo. Siempre usa el editor integrado de cPanel.

Error conexión base de datos WordPress: causas y soluciones

Este es el error más temido. Aparece una pantalla blanca con el mensaje: "Error al establecer conexión con la base de datos". Vamos a ver las causas más habituales y cómo resolverlas.

Causa 1: Datos incorrectos en wp-config.php

Es la causa más frecuente. Has escrito mal el nombre de la base de datos, el usuario o la contraseña.

Solución: Revisa el wp-config.php y compáralo con los datos que aparecen en cPanel. Cuidado con los espacios adicionales, las mayúsculas y los caracteres especiales.

Causa 2: El host de la base de datos no es localhost

Algunos servidores no usan localhost como host. Si tu proveedor te ha indicado un host específico (como mysql.tudominio.com), deberás cambiarlo en DB_HOST.

Solución: Contacta con tu proveedor de hosting o revisa el correo de bienvenida. Prueba primero con localhost; si no funciona, prueba con la IP del servidor MySQL.

Causa 3: El usuario no tiene permisos suficientes

Puede que el usuario esté creado, pero no esté añadido a la base de datos o no tenga todos los privilegios.

Solución: Ve a cPanel → Bases de datos MySQL → busca tu base de datos y asegúrate de que el usuario está en la lista. Si no está, añádelo y otórgale TODOS LOS PRIVILEGIOS.

Causa 4: La base de datos está corrupta o no existe

Si la base de datos se eliminó por error o está dañada, WordPress no podrá conectarse.

Solución: En cPanel, verifica que la base de datos existe en la lista. Si no existe, créala de nuevo. Si existe pero está corrupta, puedes intentar repararla desde Bases de datos MySQL → marcar la base de datos → Reparar.

Causa 5: Problemas con el puerto de MySQL

En algunos servidores, MySQL no usa el puerto estándar (3306). Si tu proveedor usa otro puerto, debes agregarlo al host de la siguiente manera:

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

Solución: Consulta la documentación de tu hosting o contacta con soporte.

Otros errores comunes al conectar WordPress a MySQL en cPanel

Error: "Una o más tablas de base de datos no están disponibles"

Este error suele aparecer cuando una tabla concreta de la base de datos está dañada. Puedes intentar repararla desde cPanel seleccionando la base de datos y haciendo clic en Reparar. Si no funciona, tendrás que restaurar una copia de seguridad.

Error: "El servidor no responde"

Puede ser un problema temporal del servidor, pero también podría indicar que la base de datos ha superado el límite de conexiones simultáneas.

Solución: Espera unos minutos y vuelve a intentarlo. Si el error persiste, contacta con tu proveedor de hosting.

Error: "No se pudo conectar porque se denegó el acceso"

Este mensaje suele indicar que el usuario de la base de datos no tiene permisos para conectarse desde ese host. En algunos servidores, debes crear un usuario con host % (cualquier host) en lugar de localhost.

Solución: Si tienes acceso a phpMyAdmin, puedes crear un usuario con host %. Si no, contacta con soporte.

Cómo verificar la conexión sin instalar WordPress

Si quieres comprobar si los datos son correctos antes de instalar WordPress, puedes crear un archivo PHP de prueba:

Crea un archivo llamado test.php en public_html.
Pega este código:

<?php
$conn = new mysqli('localhost', 'TU_USUARIO', 'TU_CONTRASEÑA', 'TU_BASE_DE_DATOS');
if ($conn->connect_error) {
    die('Error de conexión: ' . $conn->connect_error);
} else {
    echo '¡Conexión exitosa!';
}
?>

Accede a tudominio.com/test.php en tu navegador.

Si ves "¡Conexión exitosa!", los datos son correctos. Si ves un error, te indicará exactamente qué está fallando.

[INFO]
Después de la prueba, elimina el archivo test.php para evitar riesgos de seguridad.

Conexión a MySQL en otros paneles de control (Syspanel)

Si tu hosting utiliza Syspanel en lugar de cPanel, el proceso es muy similar. Debes saber que el acceso al panel se realiza a través del puerto 2106 (por ejemplo: https://tudominio.com:2106). Dentro de Syspanel, busca la sección de Bases de Datos y sigue los mismos pasos: crear base, crear usuario, asignar privilegios y configurar el wp-config.php.

La lógica es idéntica, solo cambia la interfaz. Los errores y soluciones que hemos visto aplican igualmente.

Preguntas frecuentes (FAQ)

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

No es recomendable. Aunque técnicamente es posible, las tablas de WordPress no tienen prefijo por defecto y se mezclarían los datos de ambas instalaciones, corrompiendo todo. Si necesitas dos sitios, crea dos bases de datos separadas.

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

En cPanel, puedes cambiar la contraseña desde Bases de datos MySQL → Usuarios → Cambiar contraseña. Luego actualiza el valor en wp-config.php.

¿Cómo sé si mi hosting usa localhost u otro host?

La mayoría de los hosting compartidos usan localhost. Si no estás seguro, revisa el correo de bienvenida de tu proveedor o contacta con soporte. También puedes probar ambos valores en el archivo test.php que mencionamos antes.

¿Es seguro almacenar la contraseña en wp-config.php?

Es necesario, pero puedes aumentar la seguridad limitando el acceso al archivo desde el exterior. En cPanel, puedes añadir esta regla al .htaccess:

<Files wp-config.php>
Require all denied
</Files>

Esto evitará que alguien pueda leer el archivo desde el navegador.

¿Qué pasa si cambio la contraseña de la base de datos y no actualizo wp-config.php?

WordPress dejará de funcionar al instante, mostrando el error de conexión. Siempre actualiza el wp-config.php inmediatamente después de cambiar la contraseña.

Consejos finales para evitar errores de conexión

Haz copias de seguridad de tu base de datos con regularidad. En cPanel puedes usar la herramienta de copias o plugins como UpdraftPlus.
No uses caracteres raros (como ñ o tildes) en el nombre de la base de datos o el usuario. Solo letras, números y guiones bajos.
Actualiza WordPress y los plugins con frecuencia para evitar vulnerabilidades que puedan dañar la base de datos.
Si migras de hosting, asegúrate de exportar e importar la base de datos correctamente y de actualizar el wp-config.php con los nuevos datos.
Mantén un registro de tus credenciales en un lugar seguro, pero nunca en el mismo servidor.

Resumen rápido: conectar WordPress a MySQL en cPanel

Crea la base de datos y el usuario en cPanel.
Asigna todos los privilegios al usuario.
Edita wp-config.php con los datos correctos.
Si falla, revisa el host, los permisos y el puerto.
Usa un archivo de prueba para verificar la conexión.

Con estos pasos y soluciones, podrás resolver el 99% de los errores de conexión a la base de datos en WordPress. Recuerda que la paciencia es clave: revisa cada dato con calma y no dudes en contactar con el soporte de tu hosting si el problema persiste.

[TIP]
Si después de todo sigues con problemas, prueba a desactivar temporalmente el firewall o el CDN (como Cloudflare). A veces bloquean las conexiones internas entre WordPress y MySQL.

Espero que esta guía te haya sido de gran ayuda. Ahora ya sabes cómo conectar WordPress a MySQL en cPanel y cómo solucionar el temido error conexión base de datos WordPress editando correctamente el wp-config.php en cPanel. ¡Ponlo en práctica y tu web volverá a funcionar en pocos minutos!