Solucionar errores de conexión a base de datos en WordPress cPanel

Imagina que llegas a tu web, escribes la dirección, y de repente ves un mensaje que dice: "Error al establecer una conexión a la base de datos". No te preocupes, es uno de los errores más comunes en WordPress y, por suerte, casi siempre tiene solución. En esta guía te voy a explicar paso a paso cómo solucionar problemas de conexión a la base de datos usando cPanel (y también te contaré cómo hacerlo si usas Syspanel, el antiguo HestiaCP, cuyo puerto de acceso es el 2106). Vamos a ello.

¿Por qué aparece este error en WordPress?

El mensaje "Error al establecer una conexión a la base de datos" significa que WordPress no puede comunicarse con tu base de datos. Esto puede deberse a varias razones: desde un cambio accidental en la contraseña, hasta un fallo del servidor o un problema en el archivo de configuración wp-config.php. Lo bueno es que, en la mayoría de los casos, tú mismo puedes resolverlo sin necesidad de llamar a un técnico.

Primeros pasos: verifica que el servidor de bases de datos esté activo

Antes de tocar nada en WordPress, asegúrate de que el servidor de bases de datos (MySQL o MariaDB) esté funcionando. Esto lo puedes comprobar desde cPanel o Syspanel.

Desde cPanel:

Inicia sesión en tu cuenta de cPanel.
Busca la sección Bases de Datos y haz clic en MySQL Databases.
Si ves un mensaje de error o la página no carga, probablemente el servicio de MySQL esté caído. En ese caso, contacta a tu proveedor de hosting.

Desde Syspanel (HestiaCP):

Accede a tu servidor usando la dirección tu-dominio.com:2106.
Inicia sesión con tus credenciales.
Ve a Base de datos y revisa que el estado del servicio sea "Activo". Si no lo está, usa el botón de Iniciar o contacta a soporte.

[INFO] Si el servidor de bases de datos está caído, ningún cambio en WordPress lo solucionará. Primero debes esperar a que el hosting lo reactive.

Revisa el archivo wp-config.php: la clave del problema

El archivo wp-config.php contiene los datos de conexión a tu base de datos. Si alguno de estos datos es incorrecto, WordPress no podrá conectarse. Este archivo se encuentra en la raíz de tu instalación de WordPress.

Cómo acceder al archivo desde cPanel:

En cPanel, ve a Archivos > Administrador de archivos.
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html).
Busca el archivo wp-config.php. Si no lo ves, asegúrate de que estén visibles los archivos ocultos (hay un botón en la parte superior).

Qué debes revisar:

Abre el archivo con el editor de texto del Administrador de archivos. Busca estas líneas:

define('DB_NAME', 'nombre_de_tu_base');
define('DB_USER', 'usuario_de_la_base');
define('DB_PASSWORD', 'contraseña_secreta');
define('DB_HOST', 'localhost');

Verifica que:

DB_NAME coincide con el nombre de la base de datos que ves en cPanel.
DB_USER es el usuario asignado a esa base.
DB_PASSWORD es la contraseña correcta (si la cambiaste, debes actualizarla aquí).
DB_HOST suele ser localhost, pero algunos hosting usan direcciones como mysql.tudominio.com. Pregunta a tu hosting si no estás seguro.

[WARNING] No modifiques nada más en wp-config.php a menos que sepas lo que haces. Un cambio incorrecto puede romper tu web.

Cómo cambiar la contraseña de la base de datos desde cPanel

Si crees que la contraseña es incorrecta, puedes cambiarla fácilmente:

En cPanel, ve a Bases de Datos > MySQL Databases.
Busca la sección Usuarios actuales y localiza el usuario de tu base.
Haz clic en Cambiar contraseña.
Elige una contraseña segura (puedes usar el generador que te ofrece cPanel).
Importante: Después de cambiar la contraseña, debes actualizarla también en el archivo wp-config.php que vimos antes.

[TIP] Anota la nueva contraseña en un lugar seguro. Si la pierdes, tendrás que repetir el proceso.

Verifica los privilegios del usuario de la base de datos

A veces el usuario no tiene permisos suficientes para acceder a la base. Para comprobarlo:

En cPanel, ve a MySQL Databases.
En la sección Agregar usuario a una base de datos, asegúrate de que el usuario esté vinculado a la base correcta.
Si no lo está, selecciona el usuario y la base, y haz clic en Agregar.
Luego, marca TODOS LOS PRIVILEGIOS (o al menos SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER).

En Syspanel, el proceso es similar: ve a Base de datos, selecciona la base y asigna el usuario con todos los permisos.

Problemas con el host de la base de datos (DB_HOST)

El valor localhost funciona en la mayoría de los casos, pero no siempre. Si tu hosting usa un servidor de bases de datos separado, el host podría ser algo como mysql.tudominio.com o una IP. Para saberlo:

Pregunta a tu proveedor de hosting o revisa el correo de bienvenida.
También puedes probar cambiando localhost por 127.0.0.1 (a veces soluciona problemas de conexión).
En algunos casos, el host incluye un puerto, por ejemplo localhost:3306. Si tu hosting lo especifica, agrégalo.

[INFO] Si después de cambiar el host el error persiste, vuelve a poner localhost. No todos los servidores aceptan cambios en este valor.

¿Y si el error aparece después de mover o restaurar el sitio?

Si migraste tu web o restauraste una copia de seguridad, es probable que los datos de conexión hayan cambiado. La solución es editar wp-config.php con los nuevos datos (nombre de base, usuario y contraseña). Si no los tienes, crea una nueva base de datos y usuario en cPanel, y luego actualiza el archivo.

Cómo solucionar el error desde Syspanel (HestiaCP)

Aunque este artículo se centra en cPanel, muchos usuarios usan Syspanel (el nuevo nombre de HestiaCP). Recuerda que el puerto de acceso es 2106. Los pasos son similares:

Accede a tu-dominio.com:2106 e inicia sesión.
Ve a Base de datos.
Verás listadas tus bases de datos. Haz clic en el icono de editar (lápiz) junto a la base que usa WordPress.
Ahí puedes cambiar la contraseña o ver el nombre de usuario.
Si necesitas crear una nueva base, usa el botón Agregar base de datos.

[WARNING] En Syspanel, el archivo wp-config.php se edita igual que en cPanel: a través del Administrador de archivos o por FTP. No hay una opción directa en el panel.

Otras causas comunes y cómo solucionarlas

El plugin o tema está causando el error

A veces un plugin mal configurado puede romper la conexión. Para descartarlo:

Accede a tu hosting por FTP o Administrador de archivos.
Renombra la carpeta wp-content/plugins a plugins_old. Esto desactivará todos los plugins.
Si el error desaparece, reactiva los plugins uno por uno hasta encontrar el culpable.

El archivo .htaccess está corrupto

Un .htaccess dañado puede causar errores extraños. Para regenerarlo:

En el Administrador de archivos, renombra .htaccess a .htaccess_old.
Ve a Ajustes > Enlaces permanentes en el escritorio de WordPress (si puedes acceder) y haz clic en Guardar cambios. Esto creará un nuevo .htaccess.

La base de datos está corrupta

WordPress tiene una herramienta para reparar la base de datos. Para activarla:

Añade esta línea a wp-config.php, justo antes del /* That's all, stop editing! */:
define('WP_ALLOW_REPAIR', true);
Ve a tudominio.com/wp-admin/maint/repair.php.
Haz clic en Reparar base de datos.
Importante: Después de reparar, elimina esa línea del archivo.

Preguntas frecuentes (FAQ)

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

Puede que esté oculto. En el Administrador de archivos de cPanel, activa la opción Mostrar archivos ocultos (un botón en la barra superior). Si aún así no aparece, descarga una copia limpia de WordPress desde wordpress.org y extrae el archivo wp-config-sample.php. Luego renómbralo a wp-config.php y completa los datos.

¿Puedo solucionar el error sin acceso al escritorio de WordPress?

Sí, todos los pasos de esta guía se realizan desde cPanel o FTP, sin necesidad de entrar al administrador de WordPress.

¿El error puede deberse a un ataque?

Es posible. Si después de solucionar la conexión ves archivos extraños o usuarios desconocidos, cambia todas las contraseñas (cPanel, WordPress, base de datos) y escanea tu web con un plugin de seguridad.

¿Qué hago si nada funciona?

Si has seguido todos los pasos y el error persiste, contacta a tu proveedor de hosting. Puede ser un problema del servidor que solo ellos pueden resolver.

Resumen rápido para no perderte

Verifica que MySQL esté activo desde cPanel o Syspanel.
Revisa wp-config.php: nombre de base, usuario, contraseña y host.
Cambia la contraseña en cPanel y actualiza el archivo.
Comprueba los privilegios del usuario de la base.
Prueba con 127.0.0.1 en lugar de localhost.
Desactiva plugins renombrando la carpeta.
Repara la base de datos si es necesario.

[TIP] Siempre guarda una copia de seguridad de wp-config.php antes de modificarlo. Así, si algo sale mal, puedes restaurarlo fácilmente.

Espero que esta guía te haya ayudado a resolver el temido error de conexión a la base de datos. Recuerda que, aunque parezca complicado, la mayoría de las veces es solo cuestión de actualizar una contraseña o verificar un nombre. Si te quedas atascado, no dudes en pedir ayuda a tu hosting o a la comunidad de WordPress. ¡Buena suerte!