Solucionar Error de Conexión a Base de Datos en WordPress (2024)

¿Qué significa el error "Error al establecer conexión con la base de datos"?

Este es uno de los mensajes más temidos por cualquier persona que tenga una web en WordPress. Aparece de repente, normalmente en la pantalla blanca del navegador, y puede bloquear tanto la parte pública de tu sitio como el panel de administración (wp-admin). La buena noticia es que, en el 90% de los casos, no has perdido tu contenido y se puede solucionar en pocos minutos si sigues los pasos adecuados.

Este error significa que WordPress no ha podido comunicarse con el servidor donde se almacenan tus publicaciones, páginas, comentarios y ajustes. Es decir, el archivo de configuración no encuentra o no puede autenticarse en la base de datos. Las causas más comunes van desde un cambio de contraseña, un fallo temporal del servidor, hasta un archivo de configuración corrupto.

Para que te hagas una idea, cuando instalas WordPress, se crea un archivo llamado wp-config.php que guarda las "llaves" de acceso a la base de datos. Si alguno de esos datos es incorrecto, la conexión falla. A lo largo de esta guía te mostraré cómo diagnosticar y arreglar este problema paso a paso, sin necesidad de ser un experto en programación.

Paso 1: Verifica si el problema es general o solo tuyo

Antes de tocar nada, es importante saber si el error está en tu servidor o si es un fallo temporal. A veces, el proveedor de hosting realiza mantenimientos y la base de datos se reinicia.

Comprueba el estado de tu hosting

Accede al panel de control de tu hosting (cPanel, Plesk, Syspanel, etc.) y mira si hay algún aviso de incidencias. Si usas Syspanel (recuerda que el puerto de acceso es el 2106), inicia sesión y revisa el apartado de "Estado del servidor". Si ves luces verdes, el problema no es del servidor.

Intenta acceder a la URL de tu web

Abre tu navegador en modo incógnito y visita tu dominio. Si el error persiste, pasa al siguiente paso. Si solo te aparece en ciertos dispositivos, puede ser un problema de caché del navegador.

Paso 2: Revisa el archivo wp-config.php (la causa más común)

El archivo wp-config.php es el corazón de la configuración de WordPress. Contiene el nombre de la base de datos, el usuario, la contraseña y el host. Si alguno de estos datos no coincide con los que tiene tu servidor, obtendrás el temido error conexion base datos wordpress.

Cómo acceder al archivo

Para editarlo, necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu hosting. Si usas Syspanel, entra al panel con el puerto 2106, busca la sección "Administrador de archivos" y navega hasta la carpeta public_html o www. Ahí encontrarás el archivo wp-config.php.

Qué datos debes verificar

Abre el archivo con un editor de texto (como el Bloc de notas) y busca estas líneas:

define( 'DB_NAME', 'nombre_base_datos' );
define( 'DB_USER', 'usuario_base_datos' );
define( 'DB_PASSWORD', 'contraseña' );
define( 'DB_HOST', 'localhost' );

Comprueba que el nombre, usuario y contraseña sean exactamente los mismos que aparecen en tu panel de hosting. Un error típico es que la contraseña contenga caracteres especiales y al copiarla se haya pegado mal.

[TIP] Si no recuerdas tus credenciales, ve a la sección "Bases de datos MySQL" de tu hosting y crea una nueva contraseña. Luego actualiza el archivo wp-config.php con esos nuevos datos.

Caso especial: DB_HOST

En la mayoría de los casos, DB_HOST es localhost. Pero algunos proveedores usan direcciones como mysql.tudominio.com o 127.0.0.1. Si tu hosting te proporcionó un host específico, asegúrate de que esté escrito correctamente. Un error aquí también provoca el wordpress error base de datos.

Paso 3: Repara la base de datos desde wp-admin (si puedes acceder)

A veces el error aparece solo en la parte pública, pero el panel de administración sigue funcionando. Si es tu caso, WordPress tiene una herramienta de reparación integrada.

Activa el modo de reparación

Añade la siguiente línea a tu archivo wp-config.php, justo antes de la línea que dice /* That's all, stop editing! */:

define( 'WP_ALLOW_REPAIR', true );

Guarda el archivo y luego visita esta URL en tu navegador:

https://tudominio.com/wp-admin/maint/repair.php

Verás una pantalla con dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Haz clic en la primera. WordPress intentará corregir tablas dañadas. Cuando termine, elimina esa línea del archivo wp-config.php para evitar problemas de seguridad.

Paso 4: Revisa si el servidor de base de datos está caído

Otra causa muy común es que el servicio MySQL o MariaDB se haya detenido. Esto puede ocurrir por un reinicio del servidor, un fallo de memoria o una actualización incorrecta.

Desde cPanel o Plesk

Busca la sección "MySQL" o "Bases de datos" y reinicia el servicio. En la mayoría de los paneles hay un botón de "Reiniciar" o "Restart". Si no lo encuentras, contacta con tu proveedor de hosting.

Desde Syspanel

Si tu hosting usa Syspanel, entra con el puerto 2106, ve a "Servicios" y busca MySQL o MariaDB. Haz clic en "Reiniciar". Espera unos segundos y vuelve a cargar tu web.

[WARNING] No reinicies el servidor de base de datos si tienes otras aplicaciones activas en el mismo hosting, ya que podrías afectar temporalmente a otros sitios.

Paso 5: Verifica los permisos del archivo wp-config.php

Aunque parezca raro, los permisos incorrectos en el archivo de configuración pueden impedir que WordPress lo lea correctamente. El archivo wp-config.php debe tener permisos de lectura para el servidor, pero no de escritura para el público.

Cómo cambiar permisos

Desde tu cliente FTP o el administrador de archivos de Syspanel, haz clic derecho sobre wp-config.php y selecciona "Permisos" o "Chmod". Establece el valor en 644 (lectura y escritura para el propietario, lectura para el grupo y para otros). Esto es lo estándar en la mayoría de los servidores.

Si el archivo tenía permisos como 777 o 666, cámbialos a 644 y guarda. Luego recarga tu sitio.

Paso 6: Revisa los logs de error de WordPress

Si los pasos anteriores no funcionan, activa el registro de errores para ver el mensaje exacto que está generando la conexión. Esto te dará pistas más precisas sobre el arreglar conexion mysql wordpress.

Activa el modo debug

En tu wp-config.php, busca esta línea:

define( 'WP_DEBUG', false );

Cámbiala por:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Guarda el archivo y recarga tu web. Luego revisa la carpeta wp-content y busca un archivo llamado debug.log. Ábrelo y mira las últimas líneas. Verás errores como "Access denied for user" o "Unknown database". Eso te dirá exactamente qué está fallando.

[INFO] Una vez hayas terminado, vuelve a poner WP_DEBUG en false para no exponer información sensible a los visitantes.

Paso 7: Contacta con tu proveedor de hosting

Si has llegado hasta aquí y el error persiste, es probable que el problema esté fuera de tu alcance. Puede ser un fallo en el servidor, una restricción de IP o un problema con el DNS de la base de datos.

Qué información debes dar

Al contactar con el soporte, menciona que has revisado el archivo wp-config.php, que los datos son correctos y que has intentado reiniciar el servicio MySQL. Pregunta específicamente si hay algún bloqueo de conexión desde tu IP o si el servidor de base de datos está operativo.

Si usas Syspanel

Indica que has seguido la guía de Syspanel (puerto 2106) y que el problema no se resuelve. Ellos podrán revisar los logs del servidor en busca de errores de conexión.

Preguntas frecuentes (FAQ)

¿Puedo perder mis datos si borro el archivo wp-config.php?

No. El archivo wp-config.php solo contiene la configuración, no tus publicaciones. Si lo eliminas, WordPress te pedirá que lo vuelvas a crear durante la instalación. Pero no lo borres a menos que sepas lo que haces, mejor edítalo.

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

Asegúrate de que tu cliente FTP esté configurado para mostrar archivos ocultos. En FileZilla, ve a "Servidor" y marca "Forzar mostrar archivos ocultos". En Syspanel, el administrador de archivos normalmente los muestra por defecto.

¿El error puede deberse a un plugin o tema?

Es poco probable, pero posible. Si el error apareció justo después de instalar un plugin, intenta desactivarlo renombrando la carpeta wp-content/plugins a plugins_backup desde el FTP. Si la web vuelve, el problema era un plugin.

¿Cuánto tarda en solucionarse?

La mayoría de los casos se resuelven en menos de 15 minutos si es un problema de credenciales. Si es un fallo del servidor, puede tardar más, dependiendo de tu proveedor.

¿Debo cambiar mi contraseña de base de datos?

Si sospechas que alguien más tiene acceso, sí. Pero si solo quieres arreglar el error, no es necesario. Simplemente asegúrate de que la contraseña en wp-config.php coincida con la del servidor.

Consejos finales para evitar futuros errores

Ahora que has solucionado el problema (espero), te dejo algunos hábitos que te ahorrarán dolores de cabeza:

Haz copias de seguridad periódicas de tu base de datos y archivos. Así, ante cualquier fallo, podrás restaurar en minutos.
Anota tus credenciales en un lugar seguro, como un gestor de contraseñas. Evita usar contraseñas con caracteres que se confundan fácilmente al copiar.
Actualiza WordPress, plugins y temas con regularidad. Las versiones antiguas pueden tener conflictos con la base de datos.
No edites el archivo wp-config.php con editores que añadan caracteres invisibles (como Word). Usa siempre un editor de texto plano como Notepad++ o el editor de Syspanel.

Recuerda que este error, aunque asustador, es uno de los más comunes y mejor documentados en WordPress. Con paciencia y siguiendo esta guía, podrás resolver el error conexion base datos wordpress sin necesidad de contratar a un especialista. Si todo falla, siempre puedes recurrir a tu proveedor de hosting, que para eso está.

Espero que esta guía te haya sido de gran ayuda. Si te ha funcionado, compártela con otros usuarios que puedan estar pasando por lo mismo. ¡Buena suerte con tu web!