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

Errores comunes al conectar WordPress con MySQL y soluciones

Actualizado el 7 de diciembre de 2025

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver uno de los problemas más comunes cuando montas una web con WordPress: el error de conexión con MySQL. Es frustrante, lo sé, pero no te preocupes: en esta guía te explico paso a paso los errores más frecuentes y, lo más importante, cómo solucionarlos. Vamos a ello.

¿Por qué aparece el error de conexión a la base de datos en WordPress?

Cuando instalas WordPress, este necesita comunicarse con una base de datos (normalmente MySQL) para guardar todo: entradas, usuarios, comentarios, configuraciones... Si esa comunicación falla, verás mensajes como "Error al conectar con la base de datos" o "Error establishing a database connection". Esto puede deberse a varias causas, desde un simple error tipográfico hasta un servidor caído.

En este artículo voy a detallarte los errores más comunes y cómo solucionarlos, para que tu sitio vuelva a funcionar en pocos minutos. Recuerda que si usas Syspanel (antes conocido como HestiaCP), el acceso a tu panel de control se hace por el puerto 2106 (por ejemplo: https://tudominio.com:2106). Allí podrás gestionar bases de datos, usuarios y contraseñas.

Error 1: Credenciales incorrectas en wp-config.php

Este es, con diferencia, el error más habitual. WordPress guarda los datos de conexión a la base de datos en el archivo wp-config.php. Si escribes mal el nombre de la base de datos, el usuario o la contraseña, no podrá conectar.

Síntomas

Ves el mensaje "Error al conectar con la base de datos" justo al cargar tu web o durante la instalación.

Solución paso a paso

  1. Accede a tu servidor por FTP o desde el administrador de archivos de tu hosting (en Syspanel puedes hacerlo desde la sección "Archivos").
  2. Localiza el archivo wp-config.php en la raíz de tu instalación de WordPress (normalmente en /public_html/ o /www/).
  3. Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.).
  4. Busca las siguientes líneas y verifica que los datos sean correctos: 
    define('DB_NAME', 'nombre_de_tu_base');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');
  5. Comprueba que:
    • El nombre de la base de datos (DB_NAME) existe y está bien escrito.
    • El usuario (DB_USER) tiene permisos sobre esa base.
    • La contraseña (DB_PASSWORD) es la correcta (a veces las contraseñas contienen caracteres especiales que se escapan mal).
    • El host (DB_HOST) suele ser localhost, pero en algunos hosting puede ser una IP o un nombre como mysql.tudominio.com. Pregunta a tu proveedor si no estás seguro.

[TIP] Si no recuerdas tus credenciales, en Syspanel ve a "Base de Datos" y selecciona la base que quieras. Allí verás el nombre, el usuario y podrás cambiar la contraseña.

Error 2: Base de datos o usuario no existen

A veces, el error no está en el archivo de configuración, sino que la base de datos o el usuario no se han creado en el servidor.

Síntomas

Mensaje de error similar al anterior, pero al revisar el panel de control ves que no hay ninguna base con ese nombre.

Solución paso a paso

  1. Accede a tu panel de control (en Syspanel usa el puerto 2106).
  2. Ve a la sección "Base de Datos" y haz clic en "Agregar base de datos".
  3. Crea una nueva base con el nombre que necesites (por ejemplo, miblog_db).
  4. Crea un usuario y asígnale una contraseña segura.
  5. Asigna el usuario a la base de datos (en Syspanel se hace automáticamente al crearla).
  6. Actualiza el archivo wp-config.php con esos nuevos datos.

[INFO] Si ya tenías una base de datos pero el usuario no tiene permisos, puedes editarla desde el mismo panel y "Agregar usuario" a la base.

Error 3: Servidor MySQL caído o sobrecargado

A veces el problema no es tuyo, sino del servidor. MySQL puede detenerse por falta de recursos, errores internos o mantenimiento.

Síntomas

El error aparece de repente, incluso sin haber modificado nada. Ocurre a menudo en horas punta o si tu web recibe mucho tráfico.

Solución paso a paso

  1. Reinicia el servidor MySQL. Si tienes acceso a la terminal (SSH), ejecuta: 
    sudo systemctl restart mysql
    (En algunos sistemas es mariadb o mysqld).
  2. **Si usas Syspanel, puedes reiniciar servicios desde "Servicios" en el panel. Busca "MySQL" y haz clic en "Reiniciar".
  3. Verifica el estado con: 
    sudo systemctl status mysql
    Deberías ver "active (running)".
  4. Si no se reinicia, revisa los logs de error: 
    sudo tail -f /var/log/mysql/error.log
    Allí verás pistas sobre el fallo (falta de disco, memoria, etc.).

[WARNING] Si el servidor se cae constantemente, puede que tu plan de hosting no tenga suficientes recursos. Considera migrar a un plan superior o a un hosting optimizado para WordPress.

Error 4: Puerto incorrecto o firewall bloqueando la conexión

MySQL por defecto usa el puerto 3306. Si tu hosting usa un puerto diferente o hay un firewall bloqueándolo, la conexión fallará.

Síntomas

El error aparece al instalar WordPress o al intentar conectar desde un plugin remoto. A veces el mensaje incluye "Can't connect to MySQL server on '...' (111)".

Solución paso a paso

  1. Revisa el archivo wp-config.php: a veces el host no es localhost sino una IP con puerto, por ejemplo 192.168.1.100:3307. Si es así, escríbelo como: 
    define('DB_HOST', '192.168.1.100:3307');
  2. Comprueba el firewall en tu servidor. Si tienes acceso SSH, verifica las reglas: 
    sudo ufw status
    Si el puerto 3306 no está permitido, agrégalo: 
    sudo ufw allow 3306
  3. **Si usas Syspanel, el firewall se gestiona desde "Configuración del servidor" > "Firewall". Asegúrate de que el puerto 3306 esté abierto para tu IP (o para todas si es necesario).
  4. Prueba la conexión manualmente desde la terminal: 
    mysql -u tu_usuario -p -h localhost
    Si te pide contraseña y entras, el problema no es el puerto.

Error 5: Archivo wp-config.php corrupto o con permisos incorrectos

El archivo wp-config.php puede dañarse por una mala edición o tener permisos que impidan su lectura.

Síntomas

La web muestra un error blanco o "Error de análisis" al cargar. O bien, el archivo no se puede leer.

Solución paso a paso

  1. Verifica los permisos del archivo. Deberían ser 644 (lectura para todos, escritura solo para el propietario). Puedes cambiarlos desde FTP o con: 
    chmod 644 wp-config.php
  2. Si el archivo está corrupto, descarga una copia de seguridad o crea uno nuevo. Puedes usar el asistente de WordPress:
    • Ve a la raíz de tu instalación.
    • Renombra wp-config.php a wp-config.php.old.
    • Visita tu web: WordPress te guiará para crear un nuevo archivo.
  3. Revisa que no haya caracteres extraños (espacios, saltos de línea) al principio o final del archivo. Ábrelo con un editor que muestre caracteres ocultos.

[TIP] Siempre haz una copia de wp-config.php antes de modificarlo. Así, si algo sale mal, puedes restaurarlo.

Error 6: Versiones incompatibles de PHP y MySQL

WordPress requiere versiones específicas de PHP y MySQL. Si tu servidor tiene una versión antigua o demasiado nueva, puede haber conflictos.

Síntomas

Errores de conexión intermitentes o mensajes de "incompatibilidad" en el panel de administración.

Solución paso a paso

  1. Revisa los requisitos de WordPress: actualmente necesita PHP 7.4 o superior y MySQL 5.6 o MariaDB 10.1+.
  2. **En Syspanel, ve a "Configuración del servidor" > "Versiones de PHP". Allí puedes cambiar la versión que usa tu sitio.
  3. Actualiza MySQL si es necesario. En Syspanel, desde "Servicios" puedes ver la versión instalada. Si es antigua, contacta a tu proveedor de hosting para actualizarla.
  4. Prueba con un plugin como "Health Check & Troubleshooting" para identificar incompatibilidades.

Error 7: Tablas de la base de datos corruptas

Con el tiempo, las tablas de MySQL pueden dañarse por cortes de energía, errores de escritura o plugins maliciosos.

Síntomas

Errores como "Table 'wp_options' is marked as crashed" o "repair table".

Solución paso a paso

  1. Accede a phpMyAdmin desde tu panel de control (en Syspanel está en "Base de Datos" > "phpMyAdmin").
  2. Selecciona tu base de datos y marca todas las tablas.
  3. En el menú desplegable "Con seleccionados", elige "Reparar tabla".
  4. Si no funciona, puedes usar la línea de comandos: 
    mysqlcheck -u tu_usuario -p --auto-repair nombre_base
  5. Otra opción es instalar el plugin "WP-DBManager" que permite reparar y optimizar tablas desde el panel de WordPress.

[INFO] La reparación de tablas es segura y no borra datos. Pero siempre es recomendable hacer una copia de seguridad antes.

Error 8: Límite de conexiones a MySQL alcanzado

En servidores compartidos o con mucho tráfico, MySQL puede tener un límite de conexiones simultáneas. Si se supera, nuevas conexiones son rechazadas.

Síntomas

Error "Too many connections" o "Cannot connect to MySQL server".

Solución paso a paso

  1. Aumenta el límite temporalmente desde la terminal: 
    sudo mysql -e "SET GLOBAL max_connections = 200;"
    (Sustituye 200 por un número mayor).
  2. Para hacerlo permanente, edita el archivo de configuración de MySQL (/etc/mysql/my.cnf o /etc/my.cnf) y busca la línea: 
    max_connections = 150
    Cámbiala a un valor más alto (por ejemplo, 300) y reinicia MySQL.
  3. Optimiza tu web para reducir conexiones: usa un plugin de caché, minimiza consultas a la base de datos y considera un hosting con más recursos.

[WARNING] Aumentar mucho el límite puede saturar el servidor. Hazlo con cuidado y monitorea el rendimiento.

Error 9: Plugins o temas que modifican la conexión

Algunos plugins de caché, seguridad o migración pueden alterar la configuración de la base de datos.

Síntomas

El error aparece después de instalar o actualizar un plugin/tema.

Solución paso a paso

  1. Desactiva todos los plugins renombrando la carpeta wp-content/plugins a wp-content/plugins_backup. Si la web funciona, el problema es de un plugin.
  2. Reactiva uno por uno hasta encontrar el culpable.
  3. Si el tema es el problema, cambia temporalmente a un tema por defecto (Twenty Twenty-Four) desde la base de datos o mediante FTP renombrando la carpeta del tema.
  4. Una vez identificado, actualiza o reemplaza el plugin/tema.

Error 10: Problemas con el certificado SSL o redirecciones

A veces el error de conexión se confunde con un problema de SSL, especialmente si usas HTTPS y la base de datos está configurada para HTTP.

Síntomas

La web carga pero muestra errores de conexión en el panel de administración o al enviar formularios.

Solución paso a paso

  1. Revisa las URLs en wp-config.php o en la base de datos (tabla wp_options). Deben coincidir con tu dominio actual.
  2. Si cambiaste de HTTP a HTTPS, actualiza las URLs con el plugin "Better Search Replace" o desde phpMyAdmin.
  3. Asegúrate de que el certificado SSL esté bien instalado y que no haya redirecciones en bucle.

Preguntas Frecuentes (FAQ)

¿Qué hago si no tengo acceso a wp-config.php?

Si no puedes acceder por FTP, usa el administrador de archivos de Syspanel (puerto 2106) o contacta a tu hosting.

¿Cómo sé si mi base de datos está caída?

Desde Syspanel, ve a "Servicios" y mira el estado de MySQL. También puedes probar con mysqladmin ping desde SSH.

¿Puedo evitar estos errores en el futuro?

Sí: mantén WordPress y plugins actualizados, haz copias de seguridad periódicas, usa un hosting de calidad y monitorea el rendimiento de tu web.

¿El error puede deberse a un ataque?

Es posible. Si sospechas de un ataque, cambia todas las contraseñas, revisa usuarios extraños en la base de datos y escanea tu web con un plugin de seguridad.

Conclusión

Los errores de conexión entre WordPress y MySQL pueden ser frustrantes, pero en la mayoría de los casos se solucionan con unos pocos pasos: revisar credenciales, verificar que la base exista, reiniciar servicios o reparar tablas. Recuerda que si usas Syspanel, tienes acceso a todas las herramientas necesarias desde el puerto 2106.

Si has seguido todos estos pasos y el problema persiste, no dudes en contactar con el soporte técnico de tu hosting. Ellos podrán revisar los logs del servidor y darte una solución personalizada.

¡Espero que esta guía te haya sido de ayuda! Si tienes más dudas, déjalas en los comentarios y estaré encantado de ayudarte.

¿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