Errores de conexión a base de datos | Soluciones WordPress y PrestaShop

¿Por qué aparecen los errores de conexión a la base de datos?

Si estás leyendo esto, probablemente te has encontrado con un mensaje de error que te impide acceder a tu web. Respira, es más común de lo que parece y, en la mayoría de los casos, tiene solución en pocos minutos.

Cuando hablamos de errores conexion base de datos, nos referimos a cualquier problema que impide que tu aplicación (WordPress o PrestaShop) se comunique con el servidor donde se almacena tu información. Sin esa comunicación, tu web no puede mostrar contenido ni procesar pedidos.

El mensaje típico en WordPress es: "Error al establecer una conexión con la base de datos" o "Error de conexión a la base de datos". En PrestaShop, verás algo como "PrestaShop error conexion mysql" o un pantallazo blanco con un mensaje técnico.

La buena noticia: el 90% de estos errores se deben a causas muy concretas que puedes revisar tú mismo sin ser un experto. Vamos a desglosarlas una por una.

Los 7 errores más habituales al conectar una base de datos

1. Credenciales incorrectas en el archivo de configuración

Este es el culpable número uno. Tanto WordPress como PrestaShop guardan los datos de conexión en archivos de texto plano. Si esos datos no coinciden exactamente con los que te proporcionó tu proveedor de hosting, la conexión falla.

En WordPress, el archivo se llama wp-config.php y está en la raíz de tu instalación. Busca estas líneas:

define('DB_NAME', 'tu_basededatos');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

En PrestaShop, el archivo es app/config/parameters.php e incluye:

'database_host' => 'localhost',
'database_name' => 'tu_basededatos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Cómo solucionarlo

Accede a tu panel de control de hosting (cPanel, Syspanel o similar).
Busca la sección de Bases de Datos MySQL.
Anota el nombre exacto de la base de datos, el usuario y la contraseña.
Compara con lo que tienes en el archivo de configuración.
Corrige cualquier diferencia y guarda.

[WARNING] La contraseña puede contener caracteres especiales como $, # o %. Si al copiarla y pegarla en el archivo de configuración usas comillas simples, algunos caracteres podrían interpretarse mal. Si tienes problemas, prueba a cambiar la contraseña desde el panel de hosting y usa una que solo contenga letras y números.

2. El servidor de base de datos no está disponible

A veces el problema no es tu configuración, sino que el servidor MySQL está caído o reiniciándose. Esto puede pasar por mantenimiento, sobrecarga o un fallo del proveedor.

Cómo solucionarlo

Espera unos minutos y recarga la página.
Consulta el estado del servicio en el panel de tu hosting.
Si usas un servicio como Syspanel (accesible por el puerto 2106), revisa si hay algún aviso de mantenimiento.
Contacta con el soporte técnico si el problema persiste más de 30 minutos.

[TIP] Si tu web es crítica, considera contratar un plan con monitorización 24/7 que te avise automáticamente cuando el servidor de base de datos tenga problemas.

3. El host de la base de datos es incorrecto

Muchas personas asumen que la base de datos siempre está en localhost, pero no siempre es así. En entornos de hosting compartido o VPS, el servidor de base de datos puede tener un nombre diferente como mysql.tudominio.com o db12345.hosting.com.

Cómo solucionarlo

Revisa la información que te dio tu proveedor de hosting.
Si usas cPanel, busca en la sección "Bases de datos MySQL" el nombre del servidor.
En Syspanel (recuerda, puerto 2106), la información suele estar en el panel de la base de datos.
Actualiza DB_HOST en WordPress o database_host en PrestaShop.

[INFO] Si tu hosting usa un servidor de bases de datos externo (por ejemplo, Amazon RDS o DigitalOcean Managed Database), el host será una URL larga tipo db-project-do-user-123456-0.b.db.ondigitalocean.com. No te asustes, es normal.

4. Permisos insuficientes del usuario de la base de datos

Aunque tengas el usuario y contraseña correctos, ese usuario necesita tener permisos para acceder a la base de datos. Si los permisos son limitados, la conexión fallará.

Cómo solucionarlo

Entra en el panel de gestión de bases de datos.
Localiza el usuario que estás usando.
Verifica que tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP).
Si no los tiene, asígnalos. En cPanel es tan fácil como marcar "TODOS LOS PRIVILEGIOS" y pulsar "Aplicar".
En Syspanel (puerto 2106), busca la opción de "Gestión de usuarios" dentro de la base de datos.

[WARNING] Si acabas de crear un usuario y una base de datos, también debes asignar el usuario a la base de datos. Es un paso que se olvida con frecuencia y causa exactamente este error.

5. Archivos de configuración corruptos o incompletos

A veces, durante una actualización o una edición manual, el archivo de configuración se corrompe. Puede que falte una coma, que haya una línea duplicada o que el archivo se haya guardado con codificación incorrecta.

Cómo solucionarlo

En WordPress:

Haz una copia de seguridad de tu wp-config.php actual.
Descarga una copia limpia desde wordpress.org.
Renombra el archivo wp-config-sample.php a wp-config.php.
Rellena los datos de conexión.
Añade las claves de seguridad (puedes generarlas en https://api.wordpress.org/secret-key/1.1/salt/).

En PrestaShop:

Copia el archivo app/config/parameters.php actual.
Consulta la documentación oficial para regenerarlo.
Reemplaza solo los valores de conexión, no borres el resto de parámetros (como las claves secretas).

[TIP] Si no te sientes cómodo editando archivos manualmente, usa un cliente FTP como FileZilla para descargar el archivo, editarlo con un editor de texto plano (nada de Word) y subirlo de nuevo.

6. El puerto de conexión MySQL es incorrecto

Por defecto, MySQL usa el puerto 3306. Sin embargo, algunos proveedores usan puertos diferentes por seguridad o porque tienen varios servidores en la misma máquina.

Cómo solucionarlo

En WordPress, puedes añadir el puerto al host: localhost:3307 o mysql.tudominio.com:3307.
En PrestaShop, el parámetro database_port debe coincidir con el puerto correcto.
Consulta la documentación de tu hosting o el panel de Syspanel (puerto 2106) para ver si especifican un puerto distinto.

[INFO] Si ves el error "Connection refused" o "No se puede conectar al servidor MySQL", sospecha del puerto.

7. Saturación de la base de datos o límites de conexión

Si tu web tiene mucho tráfico o algún plugin/script está haciendo consultas excesivas, el servidor de base de datos puede rechazar nuevas conexiones. Verás errores como "Too many connections" o "User already has more than 'max_user_connections' active connections".

Cómo solucionarlo

Desactiva temporalmente los plugins que puedan estar causando consultas masivas.
Optimiza las tablas de la base de datos (puedes hacerlo desde phpMyAdmin marcando todas las tablas y eligiendo "Optimizar").
Aumenta el límite de conexiones si tu plan de hosting lo permite.
Revisa los logs del servidor para identificar qué consultas están saturando el sistema.
Considera contratar un plan superior si el problema es recurrente.

[WARNING] Si tienes un plugin de caché mal configurado, puede generar un bucle de consultas infinitas. Desactiva la caché mientras investigas.

Guía de diagnóstico paso a paso

Si no sabes por dónde empezar, sigue este orden lógico. Te llevará menos de 15 minutos.

Comprueba si el servidor está caído (usa herramientas como downforeveryoneorjustme.com).
Entra en el panel de hosting y verifica que la base de datos existe y está activa.
Revisa las credenciales en el archivo de configuración.
Prueba la conexión manualmente desde phpMyAdmin o la herramienta que te ofrezca tu hosting.
Desactiva plugins o módulos recientes si el error apareció tras una actualización.
Revisa los logs de error (en WordPress, activa el modo debug; en PrestaShop, revisa var/logs/).
Contacta con el soporte si nada funciona.

Preguntas frecuentes (FAQ)

¿Por qué me aparece el error solo en el móvil?

Es poco probable que el error sea específico del dispositivo. Lo que ocurre es que tu móvil puede tener una caché más agresiva o estar conectado a una red con restricciones. Prueba a borrar la caché del navegador o usar datos móviles en lugar de WiFi.

¿Puedo perder datos si intento solucionar el error?

No, mientras no borres la base de datos ni modifiques tablas, tus datos están seguros. Editar el archivo de configuración no afecta a la información almacenada.

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

Solo si sospechas que ha sido comprometida o si no la recuerdas. Si la cambias, asegúrate de actualizar también el archivo de configuración.

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

Contacta con tu proveedor de hosting. Si usas Syspanel, recuerda que el acceso es por el puerto 2106 y su soporte puede ayudarte a verificar la configuración del servidor. A veces el problema está en el firewall o en las reglas de acceso remoto.

¿Cada cuánto debo revisar mi base de datos?

Te recomendamos hacer una comprobación mensual de la salud de la base de datos: tamaño, tablas corruptas, y permisos. La mayoría de paneles de control ofrecen herramientas de diagnóstico automáticas.

Consejos finales para evitar futuros errores

Haz copias de seguridad semanales de tu base de datos.
Mantén actualizados WordPress, PrestaShop y sus plugins/módulos.
No compartas las credenciales de acceso a la base de datos.
Usa contraseñas fuertes y cámbialas cada 6 meses.
Configura alertas en tu panel de hosting para que te avisen si el servidor de base de datos se cae.
Documenta los cambios que haces en la configuración para poder revertirlos fácilmente.

Recuerda que solucionar conexion base de datos es una habilidad que se aprende con la práctica. La próxima vez que veas un error, ya sabrás por dónde empezar a buscar. Y si te quedas atascado, no dudes en pedir ayuda profesional: a veces una segunda opinión (o un soporte técnico competente) es la solución más rápida.

Con paciencia y método, tu web volverá a estar operativa en poco tiempo. ¡Ánimo!