Error al establecer una conexión con la base de datos en WordPress

¿Su web muestra una página en blanco con la frase « Error al establecer una conexión con la base de datos » (en inglés: « Error establishing a database connection »)? Su contenido no se ha perdido. Sigue en la base de datos, pero WordPress ya no consigue conectarse a ella. Esta guía le ayuda a encontrar la causa y a corregirla, incluso sin grandes conocimientos técnicos.

¿Por qué aparece este error?

WordPress guarda sus textos, páginas y ajustes en una base de datos MySQL. En cada visita se conecta a ella con los datos escritos en el archivo wp-config.php. Si uno de ellos ya no coincide, la conexión falla y el sitio no puede mostrar nada.

Las causas más habituales son:

• datos de acceso incorrectos en wp-config.php, a menudo tras una migración o una modificación manual;
• una base eliminada o renombrada;
• una contraseña de usuario cambiada sin actualizar wp-config.php;
• tablas dañadas tras una interrupción durante una actualización;
• un servidor de base de datos saturado momentáneamente, algo más raro.

Antes de empezar

• Compruebe si el error afecta a todo el sitio o solo a la administración (/wp-admin). Si solo afecta a la administración, puede que las tablas estén dañadas (vea más abajo).
• Si acaba de modificar un archivo, instalar un plugin o migrar el sitio, anótelo: suele ser la pista.
• Puede que ya exista una copia de seguridad de su hosting, consulte Restaurar una copia de seguridad de su sitio.

Corregir el error paso a paso

1. Abra su hosting y Bases de datos, y localice la base de su sitio y su usuario.
2. Abra la herramienta Archivos y entre en la carpeta httpdocs.
3. Abra el archivo wp-config.php para editarlo.
4. Compare el valor de DB_NAME con el nombre exacto de la base.
5. Compare el valor de DB_USER con el nombre exacto del usuario.
6. Revise el valor de DB_PASSWORD: es la contraseña del usuario de la base, no la de WordPress.
7. Mantenga el valor original de DB_HOST, salvo que el soporte le indique otra cosa.
8. Guarde el archivo y recargue su sitio.

Las líneas que debe revisar tienen este aspecto:

• define( 'DB_NAME', 'nombre_de_la_base' );
• define( 'DB_USER', 'nombre_de_usuario' );
• define( 'DB_PASSWORD', 'contrasena' );
• define( 'DB_HOST', 'servidor' );

Cuidado con los detalles: una mayúscula, un espacio antes o después del valor o una comilla borrada bastan para romper la conexión. Mantenga las comillas simples rectas alrededor de cada valor.

¿Cómo comprobar que la contraseña es la correcta?

Abra la base en phpMyAdmin desde la herramienta Bases de datos, consulte Crear una base de datos MySQL. Si ve las tablas de WordPress (suelen empezar por wp_), la base existe y contiene su sitio. Si ya no conoce la contraseña del usuario, abra un ticket al soporte: le ayudará a redefinirla y después la copia en wp-config.php.

¿Y si la administración indica « Una o más tablas de la base de datos no están disponibles »?

Las tablas están dañadas. WordPress incluye una herramienta de reparación:

1. Añada la línea define( 'WP_ALLOW_REPAIR', true ); en wp-config.php, justo encima de la línea « ¡Eso es todo, deja de editar! ».
2. Abra la dirección sudominio.es/wp-admin/maint/repair.php.
3. Haga clic en Reparar la base de datos.
4. Cuando termine la reparación, elimine la línea añadida: si no, cualquiera podría usar esta herramienta.

¿Y si nada funciona?

• Consulte los registros de errores del hosting (Logs y luego Registros de errores): suelen mostrar el mensaje exacto de MySQL, como « Access denied ».
• Restaure una copia de seguridad anterior a la aparición del error, consulte Restaurar una copia de seguridad de su sitio.
• Abra un ticket desde /submitticket.php o escriba a support@upkyo.com, indicando lo que ha cambiado recientemente. El soporte responde 24/7.

¿Cómo evitar que el error vuelva?

• Guarde los datos de la base en un gestor de contraseñas desde su creación.
• No elimine nunca una base sin comprobar qué sitio la usa.
• Haga sus actualizaciones con una copia de seguridad reciente, consulte Actualizar WordPress, los plugins y los temas.
• Durante una migración, actualice wp-config.php con los datos del nuevo hosting.

Preguntas frecuentes

¿He perdido el contenido de mi web?

Casi nunca. El error significa que WordPress no llega a la base, no que la base esté vacía. Una vez corregidos los datos de conexión, el sitio vuelve tal como estaba.

¿Dónde está el archivo wp-config.php?

En la raíz de su instalación de WordPress, normalmente directamente en la carpeta httpdocs. Puede abrirlo con la herramienta Archivos del área de cliente o por SFTP, consulte Conectarse por FTP o SFTP.

¿La contraseña de la base es la de mi cuenta de WordPress?

No. DB_PASSWORD es la contraseña del usuario MySQL de la base. La contraseña de su cuenta de administrador de WordPress es distinta y no interviene aquí.

¿Por qué apareció el error después de una migración?

El nuevo hosting usa una base, un usuario o una contraseña distintos del anterior. El archivo wp-config.php copiado conserva los valores antiguos: sustitúyalos por los nuevos.

El error aparece y desaparece, ¿es normal?

Un error intermitente puede deberse a un pico de visitas o a un plugin que abre demasiadas conexiones. Anote la hora en que ocurre y abra un ticket: el soporte podrá consultar los registros del servidor.