Error 'Cannot connect to database' en WordPress: soluciones rápidas

¡Tranquilo! Ver el mensaje "Cannot connect to database" en WordPress asusta, pero es uno de los errores más comunes y, por suerte, casi siempre tiene solución. Este error significa que WordPress no puede comunicarse con la base de datos donde guarda todo tu contenido (posts, páginas, usuarios, configuraciones).

En esta guía detallada, te explicaré paso a paso cómo diagnosticar y solucionar error base de datos WordPress. No necesitas ser un experto técnico; solo sigue las instrucciones con calma.

Vamos a dividir el proceso en 5 causas principales:

Datos de conexión incorrectos en el archivo wp-config.php.
Problemas con el servidor de base de datos (caído o sobrecargado).
Base de datos corrupta (necesita reparación).
Problemas de permisos del usuario de la base de datos.
Conflictos con plugins o temas (poco común, pero posible).

1. Revisa el archivo `wp-config.php` (La causa más frecuente)

WordPress guarda los datos de acceso a tu base de datos en un archivo llamado wp-config.php. Si alguno de estos datos es incorrecto, verás el error "Cannot connect to database WordPress".

¿Cómo acceder al archivo?

Opción 1 (Recomendada para principiantes): Usa el panel de control de tu hosting (cPanel, Syspanel, Plesk, etc.). Busca la sección "Administrador de archivos" (File Manager) y navega hasta la carpeta raíz de tu web (normalmente public_html o www).
Opción 2 (con FTP): Conéctate a tu servidor mediante un cliente FTP (como FileZilla) y busca el archivo wp-config.php en la raíz.

¿Qué debes verificar?

Abre el archivo con un editor de texto (como el Bloc de notas o el editor del panel). Busca estas líneas:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_la_base_de_datos');
define('DB_PASSWORD', 'contraseña_de_la_base_de_datos');
define('DB_HOST', 'localhost');

[TIP] El valor de DB_HOST casi siempre es localhost, pero algunos hosts usan direcciones como 127.0.0.1 o mysql.servidor.com. Si tu hosting te proporcionó una específica, úsala.

Errores comunes aquí:

Nombre de base de datos incorrecto: Asegúrate de que coincida exactamente con el que creaste en tu panel de control.
Usuario o contraseña incorrectos: Revisa que el usuario tenga acceso a la base de datos y que la contraseña sea la correcta. Si la cambiaste recientemente en tu panel, debes actualizarla aquí también.
Espacios en blanco o comillas erróneas: No añadas espacios extra dentro de las comillas.

[WARNING] Ten mucho cuidado al editar este archivo. No borres ni modifiques otras líneas. Si algo sale mal, puedes descargar una copia de seguridad antes de editarlo.

2. Verifica que el servidor de base de datos esté funcionando

A veces el problema no está en tu web, sino en el servidor de tu hosting. El servicio de base de datos (MySQL/MariaDB) puede haberse caído o estar en mantenimiento.

¿Cómo comprobarlo?

Prueba con otra web en el mismo hosting: Si tienes otra instalación de WordPress en el mismo plan, y funciona, el problema es específico de esta web. Si todas fallan, el problema es del servidor.
Revisa el estado del servicio en tu panel: En paneles como Syspanel (accede por tu-dominio.com:2106), busca la sección de "Servicios" o "Estado del servidor". Asegúrate de que MySQL/MariaDB aparezca como "Activo" o "Running".
Contacta a tu soporte técnico: Si no estás seguro, la forma más rápida es abrir un ticket de soporte a tu empresa de hosting. Ellos pueden verificar el estado del servidor en segundos.

[INFO] Si tu hosting tiene un panel como cPanel, busca la herramienta "MySQL Databases" o "phpMyAdmin". Si no puedes acceder a phpMyAdmin, es probable que el servidor de base de datos esté caído.

3. Repara la base de datos (si está corrupta)

Una base de datos puede corromperse por cortes de luz, errores al actualizar WordPress o plugins, o por ataques maliciosos. WordPress tiene un modo de reparación automática muy sencillo.

Paso a paso para activar la reparación:

Accede a tu archivo wp-config.php (como vimos en el paso 1).
Busca la línea que dice: define('WP_DEBUG', false);
Justo ANTES de esa línea (o al final del archivo, antes de /* That's all, stop editing! */), añade esta línea:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo y súbelo al servidor (si lo editaste localmente).
Ahora, abre tu navegador y visita esta URL (cambia tudominio.com por el tuyo):

https://tudominio.com/wp-admin/maint/repair.php
Verás una pantalla con dos opciones:
- "Repair Database" (Reparar base de datos): Intenta arreglar los problemas sin eliminar datos.
- "Repair and Optimize Database" (Reparar y optimizar): Hace lo mismo, pero además optimiza las tablas (recomendado).
Haz clic en "Repair and Optimize Database". El proceso puede tardar unos segundos o minutos, dependiendo del tamaño de tu base de datos.

[WARNING] Una vez terminada la reparación, ES OBLIGATORIO que vuelvas al archivo wp-config.php y elimines o comentes la línea que añadiste (define('WP_ALLOW_REPAIR', true);). Si la dejas, cualquiera podría acceder a esa URL y potencialmente dañar tu base de datos.

[TIP] Después de reparar, intenta acceder a tu web. Si el error era por corrupción, debería haberse solucionado.

4. Revisa los permisos del usuario de la base de datos

A veces el usuario que WordPress usa para conectarse a la base de datos no tiene todos los permisos necesarios (especialmente si migraste la web o cambiaste el usuario).

¿Cómo solucionarlo desde tu panel de hosting?

En cPanel:
1. Ve a "MySQL Databases".
2. Busca tu base de datos y el usuario asignado.
3. Marca la opción "ALL PRIVILEGES" (Todos los privilegios) y guarda.
En Syspanel (puerto 2106):
1. Inicia sesión en tu-dominio.com:2106.
2. Ve a la sección de "Bases de Datos".
3. Busca tu base de datos y haz clic en "Usuarios" o "Permisos".
4. Asegúrate de que el usuario tenga marcados todos los permisos (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si no, asígnaselos y guarda.

[INFO] Si no encuentras cómo hacerlo, contacta al soporte de tu hosting. Es un cambio rápido que ellos pueden hacer por ti.

5. Desactiva plugins o temas (como último recurso)

Aunque es menos común, un plugin o tema mal codificado puede interferir con la conexión a la base de datos. Esto suele ocurrir después de una actualización.

¿Cómo probar esto?

Si aún puedes acceder al panel de administración de WordPress (wp-admin):
1. Ve a "Plugins" y desactívalos todos.
2. Si el error desaparece, reactívalos uno por uno hasta encontrar el culpable.
3. Si no, cambia temporalmente a un tema por defecto (Twenty Twenty-Four o similar).
Si no puedes acceder al panel (lo más probable):
1. Conéctate por FTP o al administrador de archivos de tu hosting.
2. Ve a la carpeta wp-content.
3. Renombra la carpeta plugins a plugins_old. Esto desactivará todos los plugins.
4. Prueba a acceder a tu web. Si funciona, el problema era un plugin. Luego puedes ir renombrando carpetas dentro de plugins_old (como plugins_old/mi-plugin) a plugins para reactivarlos uno a uno y encontrar el conflictivo.
5. Si el error persiste, renombra la carpeta themes a themes_old. WordPress usará un tema por defecto. Si funciona, el problema es tu tema.

[WARNING] Renombrar la carpeta themes puede hacer que tu web se vea diferente temporalmente, pero no perderás ningún ajuste del tema.

Preguntas Frecuentes (FAQ)

¿Qué significa exactamente "Cannot connect to database"?

Significa que WordPress intentó hablar con tu base de datos, pero no pudo establecer la conexión. Es como si intentaras llamar a alguien, pero el teléfono estuviera apagado, el número fuera incorrecto o la línea estuviera cortada.

¿Perderé mis datos si reparo la base de datos?

No. La reparación de WordPress solo corrige tablas corruptas, no borra datos. Es un proceso seguro, aunque siempre es recomendable tener una copia de seguridad antes de hacer cualquier cambio importante.

¿Puedo solucionar este error si soy muy novato?

Sí. La mayoría de las soluciones son sencillas y no requieren conocimientos de programación. Sigue los pasos en orden: empieza por revisar el wp-config.php y, si no funciona, prueba la reparación automática. Si nada funciona, contacta a tu soporte técnico.

¿El error puede deberse a un ataque?

Sí, aunque no es lo más común. Un ataque podría corromper la base de datos o cambiar tus credenciales. Si sospechas de un ataque, cambia todas tus contraseñas (de WordPress, FTP, base de datos) y escanea tu web con un plugin de seguridad (como Wordfence) después de solucionar el error de conexión.

¿Cuánto tiempo tarda en solucionarse?

Si el problema es un dato mal escrito en wp-config.php, se soluciona en 5 minutos. Si es una base de datos corrupta, la reparación puede tardar de 1 a 10 minutos. Si es un problema del servidor, depende de tu hosting.

¿Qué hago si después de todo esto el error persiste?

Si has seguido todos los pasos (revisar wp-config, reparar base de datos, verificar permisos, desactivar plugins) y el error sigue apareciendo, es momento de contactar al soporte técnico de tu empresa de hosting. Ellos tienen acceso directo al servidor y pueden diagnosticar problemas más profundos (como errores en el servicio MySQL o en la configuración del servidor).

Recuerda, este error es frustrante, pero casi siempre tiene una solución sencilla. ¡Respira hondo y empieza por el primer paso!

1. Revisa el archivo wp-config.php (La causa más frecuente)