🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Cómo conectar WordPress a una base de datos MySQL: errores comunes y solución

Actualizado el 29 de diciembre de 2025

¿Por qué WordPress necesita una base de datos MySQL?

Antes de entrar en materia, es fundamental entender qué papel juega MySQL en tu sitio web. WordPress no es solo un montón de archivos PHP, HTML y CSS; es un sistema de gestión de contenidos (CMS) que almacena toda tu información (entradas, páginas, comentarios, usuarios y ajustes) en una base de datos.

Cuando escribes una entrada, WordPress la guarda en MySQL. Cuando un visitante entra a tu web, WordPress consulta esa base de datos para mostrar el contenido. Sin una conexión correcta entre WordPress y MySQL, tu sitio simplemente mostrará un error o una pantalla en blanco.

Por eso, realizar una conexión WordPress MySQL correcta es el primer paso (y el más crítico) para tener un sitio funcional. A lo largo de esta guía, veremos cómo hacerlo paso a paso y, lo más importante, cómo solucionar los errores más comunes que aparecen en el camino.

Requisitos previos antes de conectar WordPress a MySQL

Para que la conexión sea exitosa, necesitas tener a mano los siguientes datos. Si no los tienes, será imposible avanzar.

  1. Nombre de la base de datos (ej: mipagina_wp).
  2. Usuario de la base de datos (ej: admin_wp).
  3. Contraseña del usuario de la base de datos.
  4. Host de la base de datos (normalmente localhost, pero en servidores externos puede ser una IP o un dominio como mysql.midominio.com).
  5. Prefijo de las tablas (por defecto es wp_, pero a veces se cambia por seguridad).

[TIP]: Si usas un panel de control como Syspanel (accesible a través del puerto 2106), estos datos los encuentras en la sección de "Bases de Datos". Allí puedes crearlas y gestionar usuarios fácilmente.

Paso a paso: Cómo configurar wp-config.php para conectar WordPress a MySQL

El archivo wp-config.php es el corazón de la configuración de WordPress. Es donde se definen las constantes de conexión a la base de datos. Sigue estos pasos:

1. Localiza el archivo wp-config.php

Este archivo se encuentra en la raíz de tu instalación de WordPress. Si has instalado WordPress en una carpeta como /public_html, lo encontrarás ahí.

Si no existe (porque estás instalando WordPress por primera vez), puedes crear uno copiando el archivo wp-config-sample.php y renombrándolo.

2. Edita las constantes de conexión

Abre el archivo con un editor de texto plano (como el Bloc de notas o Visual Studio Code) y busca las siguientes líneas:

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'nombre_base_datos' );

/** MySQL database username */
define( 'DB_USER', 'usuario_base_datos' );

/** MySQL database password */
define( 'DB_PASSWORD', 'contraseña_segura' );

/** MySQL hostname */
define( 'DB_HOST', 'localhost' );

/** Database Charset to use in creating database tables. */
define( 'DB_CHARSET', 'utf8' );

/** The Database Collate type. Don't change this if in doubt. */
define( 'DB_COLLATE', '' );

Reemplaza los valores de ejemplo con los datos reales que obtuviste en el paso anterior.

[WARNING]: Asegúrate de no dejar espacios en blanco antes de <?php al inicio del archivo y de no eliminar el ?> final (aunque en muchos casos es recomendable no cerrar el bloque PHP). Cualquier carácter extra puede romper la conexión y mostrar un error de "headers already sent".

3. Guarda el archivo y súbelo a tu servidor

Si estás editando en local, guarda el archivo y súbelo por FTP. Si estás usando el administrador de archivos de Syspanel, puedes editar directamente desde el navegador.

Errores comunes al conectar WordPress a MySQL y sus soluciones

Aquí es donde la mayoría de los usuarios se frustran. No te preocupes, casi todos los errores tienen una solución sencilla. Vamos a ver los más frecuentes.

Error 1: "Error al establecer una conexión con la base de datos"

Este es, sin duda, el error más común. Aparece cuando WordPress no puede comunicarse con MySQL. Las causas más habituales son:

  • Datos incorrectos en wp-config.php: Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactamente los mismos que los que creaste. Un simple error tipográfico o un espacio extra puede provocar este fallo.
  • El servidor de base de datos está caído: A veces el problema no eres tú, sino el servidor. Si estás en un hosting compartido, puede que el servicio MySQL se haya reiniciado o esté saturado. Espera unos minutos y vuelve a intentarlo.
  • Host incorrecto: Si tu base de datos está en un servidor diferente al de tu web, localhost no funcionará. Deberás usar la IP o el dominio que te proporciona tu proveedor de hosting.

Solución paso a paso:

  1. Verifica los datos en wp-config.php una vez más.
  2. Comprueba si el servidor MySQL está activo desde el panel de control de tu hosting (por ejemplo, en Syspanel, sección "Bases de Datos").
  3. Prueba a cambiar localhost por 127.0.0.1 en el DB_HOST. A veces, el servidor resuelve mejor la IP directa.
  4. Si nada funciona, contacta con tu proveedor de hosting para confirmar que el servicio MySQL está operativo.

[INFO]: En servidores gestionados, a veces el host de la base de datos no es localhost sino algo como mysql.tudominio.com. Revisa el correo de bienvenida de tu hosting o el panel de control.

Error 2: "Una o más tablas de base de datos no están disponibles. La base de datos puede necesitar ser reparada."

Este error suele aparecer después de un problema con la conexión o un corte de energía. Indica que algunas tablas de MySQL están corruptas o no se pueden leer.

Solución:

  1. Añade la siguiente línea a tu archivo wp-config.php, justo después de las constantes de base de datos:
define('WP_ALLOW_REPAIR', true);

  1. Ve a tu navegador y accede a www.tudominio.com/wp-admin/maint/repair.php.

  2. Verás una pantalla con opciones para reparar la base de datos. Haz clic en "Reparar base de datos".

  3. Una vez terminado, elimina esa línea de wp-config.php para evitar que cualquiera pueda acceder a la herramienta de reparación.

[WARNING]: No dejes WP_ALLOW_REPAIR activo permanentemente. Es un riesgo de seguridad, ya que permite a cualquier persona intentar reparar (y potencialmente dañar) tu base de datos.

Error 3: "No se pudo seleccionar la base de datos"

Este error es un poco más específico. Significa que WordPress se ha conectado al servidor MySQL, pero no puede encontrar la base de datos que especificaste en DB_NAME.

Causas principales:

  • El nombre de la base de datos es incorrecto: Revisa que el nombre en wp-config.php coincida exactamente con el que creaste en tu panel de control.
  • El usuario no tiene permisos sobre esa base de datos: En MySQL, los usuarios tienen privilegios asignados por base de datos. Si el usuario admin_wp no tiene permisos sobre la base mipagina_wp, no podrá seleccionarla.

Solución:

  1. Accede a tu panel de control de hosting (Syspanel, puerto 2106).
  2. Ve a la sección de "Bases de Datos".
  3. Busca la base de datos y el usuario en cuestión.
  4. Asegúrate de que el usuario tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, etc.) sobre esa base de datos. Si no es así, edita los permisos y asígnale todos.

Error 4: Pantalla blanca (WSOD) al intentar instalar WordPress

A veces, al instalar WordPress, te encuentras con una pantalla completamente blanca en lugar del asistente de instalación. Esto puede deberse a un problema con la conexión a la base de datos o con el propio archivo wp-config.php.

Solución:

  1. Comprueba que el archivo wp-config.php no tenga errores de sintaxis. Si lo has creado manualmente, asegúrate de que las comillas y los puntos y comas estén en su sitio.
  2. Verifica que los datos de la base de datos sean correctos.
  3. Activa el modo depuración de WordPress añadiendo esta línea al wp-config.php:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
  1. Recarga la página. Si hay un error, se mostrará en pantalla o se guardará en un archivo debug.log en la carpeta wp-content.

Herramientas y trucos para solucionar errores de conexión MySQL

Además de los pasos anteriores, hay algunas herramientas y trucos que pueden ayudarte a diagnosticar el problema.

Usa phpMyAdmin para verificar la conexión

phpMyAdmin es una herramienta web que te permite gestionar bases de datos MySQL de forma visual. Está disponible en casi todos los paneles de control, incluido Syspanel.

  1. Accede a phpMyAdmin desde tu panel de control.
  2. Introduce el usuario y la contraseña de tu base de datos.
  3. Si puedes entrar y ver las tablas, significa que los datos de acceso son correctos y el problema está en wp-config.php.
  4. Si no puedes entrar, el problema está en los datos de acceso o en los permisos del usuario.

Verifica los logs de error de MySQL

Los logs de MySQL pueden darte pistas muy valiosas sobre qué está fallando. Normalmente se encuentran en el servidor, pero puedes acceder a ellos desde tu panel de control o solicitarlos a tu proveedor.

Prueba con un script PHP de prueba

Crea un archivo llamado testdb.php en la raíz de tu WordPress con el siguiente contenido:

<?php
$link = mysqli_connect('localhost', 'tu_usuario', 'tu_contraseña', 'tu_base_datos');

if (!$link) {
    die('Error: ' . mysqli_connect_error());
}
echo '¡Conexión exitosa!';
mysqli_close($link);
?>

Sustituye los datos por los tuyos y accede a www.tudominio.com/testdb.php. Si ves "¡Conexión exitosa!", el problema está en la configuración de WordPress. Si ves un error, el problema está en los datos de acceso o en el servidor MySQL.

[TIP]: Elimina este archivo después de usarlo. No quieres que cualquiera pueda ver información sobre tu conexión a la base de datos.

Preguntas frecuentes (FAQ) sobre la conexión WordPress MySQL

¿Qué es wp-config.php database y dónde lo encuentro?

Es el archivo de configuración principal de WordPress que contiene las constantes de conexión a la base de datos. Se encuentra en la raíz de tu instalación de WordPress.

¿Por qué me sale "error conexión base de datos wordpress" después de migrar mi sitio?

Al migrar, es muy común olvidar actualizar las credenciales en el archivo wp-config.php. Revisa que el DB_NAME, DB_USER, DB_PASSWORD y DB_HOST correspondan a los del nuevo servidor.

¿Puedo cambiar el prefijo de las tablas de WordPress?

Sí, puedes cambiar el prefijo (por defecto wp_) editando la línea $table_prefix = 'wp_'; en el wp-config.php. Sin embargo, si ya tienes contenido, deberás renombrar las tablas en la base de datos y actualizar las referencias. Es un proceso delicado, así que haz una copia de seguridad antes.

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

Puedes restablecerla desde tu panel de control de hosting. En Syspanel, ve a "Bases de Datos", selecciona el usuario y cambia su contraseña. Luego, actualiza el valor en wp-config.php.

¿Es seguro usar localhost como host de la base de datos?

Sí, si tu WordPress y tu base de datos están en el mismo servidor, localhost es correcto y más rápido. Si están en servidores diferentes, necesitarás la IP o dominio del servidor de base de datos.

Conclusión: Domina la conexión WordPress MySQL

Conectar WordPress a una base de datos MySQL es un proceso crítico que, aunque parece complejo, es bastante mecánico. La clave está en tener los datos correctos y saber interpretar los errores.

Hemos visto los errores más comunes y sus soluciones: desde el temido "Error al establecer una conexión" hasta los problemas de permisos y tablas corruptas. Recuerda siempre:

  • Revisa dos veces los datos en wp-config.php.
  • Verifica que el usuario tiene permisos sobre la base de datos.
  • Utiliza herramientas como phpMyAdmin para diagnosticar.
  • Activa el modo depuración para obtener más información.

Con esta guía, no solo podrás configurar tu wordpress database setup desde cero, sino que también sabrás cómo solucionar error mysql cuando aparezca. La próxima vez que veas un error de conexión, respira hondo, sigue estos pasos y tu sitio volverá a estar en línea en cuestión de minutos.

[INFO]: Si tu sitio está alojado en un panel como Syspanel (puerto 2106), recuerda que la gestión de bases de datos es muy visual y sencilla. Aprovecha sus herramientas para crear, respaldar y optimizar tus bases de datos sin necesidad de comandos SQL complejos.

¡Y eso es todo! Ya tienes el conocimiento necesario para enfrentarte a cualquier problema de conexión entre WordPress y MySQL.

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel