Solución a problemas de conexión a base de datos en PrestaShop con cPanel

¿Por qué aparece un error de base de datos en PrestaShop?

Si estás leyendo esto, es probable que hayas visto un mensaje como “Error de conexión a la base de datos” o “No se puede conectar con el servidor de base de datos” en tu tienda PrestaShop. No te preocupes: es un problema muy común y, en la mayoría de los casos, se soluciona en pocos minutos.

Este error suele ocurrir cuando PrestaShop no puede comunicarse con MySQL (o MariaDB), que es donde se almacenan todos los datos de tu tienda (productos, pedidos, clientes, etc.). Como anfitrión, usamos cPanel para gestionar tu hosting, y desde ahí podrás revisar y arreglar la conexión.

Causas más frecuentes del error base de datos

Antes de lanzarnos a las soluciones, es útil saber qué puede estar fallando. Estas son las causas más habituales:

• Credenciales incorrectas: El nombre de usuario, contraseña o nombre de la base de datos no coinciden con los del archivo de configuración de PrestaShop.
• Base de datos corrupta: Un cierre inesperado o un plugin malicioso puede dañar las tablas.
• Usuario sin permisos: El usuario de la base de datos no tiene acceso completo.
• Servidor MySQL caído o sobrecargado: A veces el servicio se detiene o está saturado.
• Límite de conexiones excedido: Demasiadas conexiones simultáneas pueden bloquear nuevas peticiones.
• Archivo de configuración mal editado: Si modificaste parameters.php o settings.inc.php manualmente, puede haber errores.

Solución paso a paso: cómo arreglar la conexión a base de datos en PrestaShop con cPanel

Vamos a resolverlo. Sigue estos pasos en orden. No te saltes ninguno, incluso si crees que no aplica.

Paso 1: Verifica que el servicio MySQL esté activo en tu hosting

A veces el problema es tan simple como que el motor de base de datos se ha detenido. Desde cPanel:

1. Inicia sesión en tu cPanel (normalmente tudominio.com/cpanel).
2. Busca la sección "Base de Datos" y haz clic en "MySQL® Databases".
3. Revisa si aparece algún mensaje de error o si las bases de datos listadas se ven normales.
4. Si todo parece correcto, ve a "MySQL® Remote Access" y asegúrate de que tu IP esté permitida (si trabajas desde casa, añade tu IP pública).

[TIP] Si no ves nada raro, no asumas que todo está bien. Continúa con el siguiente paso.

Paso 2: Revisa las credenciales en el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión en un archivo llamado app/config/parameters.php (en versiones modernas) o config/settings.inc.php (en versiones antiguas). Si has cambiado la contraseña de la base de datos o has movido la tienda, este archivo puede estar desactualizado.

Para revisarlo:

1. Accede a tu cPanel y abre el Administrador de Archivos (File Manager).
2. Navega hasta la carpeta donde está instalado PrestaShop (normalmente public_html o una subcarpeta).
3. Busca el archivo parameters.php (si usas PrestaShop 1.7+). Si no lo encuentras, busca settings.inc.php.
4. Haz clic derecho sobre el archivo y selecciona "Editar".
5. Busca las líneas que contienen:
   • 'database_host' (normalmente localhost o 127.0.0.1)
   • 'database_name'
   • 'database_user'
   • 'database_password'
6. Compara estos valores con los que aparecen en cPanel en "MySQL® Databases". Deben coincidir exactamente.

[WARNING] No cambies nada si no estás seguro. Si modificas mal el archivo, la tienda dejará de funcionar por completo. Si tienes dudas, contacta con soporte.

Paso 3: Verifica los permisos del usuario de la base de datos

Incluso si las credenciales son correctas, el usuario puede no tener permisos suficientes. Para asegurarte:

1. En cPanel, ve a "MySQL® Databases".
2. Baja hasta la sección "Añadir usuario a la base de datos".
3. Verás una lista de usuarios y bases de datos. Asegúrate de que el usuario correcto esté vinculado a la base de datos correcta.
4. Si no lo está, selecciona el usuario y la base de datos y haz clic en "Añadir".
5. Luego, marca "TODOS LOS PRIVILEGIOS" y haz clic en "Realizar cambios".

[INFO] Si tu base de datos tiene un prefijo (ej. tienda_bd), el usuario debe tener ese prefijo exacto (ej. tienda_user). cPanel suele asignarlo automáticamente.

Paso 4: Repara la base de datos si está corrupta

Una base de datos dañada puede dar errores intermitentes. Para repararla:

1. En cPanel, ve a "phpMyAdmin" (dentro de la sección Base de Datos).
2. Selecciona tu base de datos en el panel izquierdo.
3. Marca la casilla "Seleccionar todo" (abajo, en la lista de tablas).
4. En el menú desplegable "Con seleccionados:", elige "Reparar tabla".
5. Espera a que termine. Si hay tablas corruptas, phpMyAdmin las reparará automáticamente.

Si el error persiste, también puedes usar "Optimizar tabla" para mejorar el rendimiento.

Paso 5: Comprueba el límite de conexiones a MySQL

Si tu tienda recibe mucho tráfico, podrías estar alcanzando el límite de conexiones simultáneas. Esto no es común en hosting compartido, pero puede pasar.

Para verificarlo:

1. En cPanel, busca la sección "Estadísticas" o "Recursos" (puede variar según el tema).
2. Revisa el uso de "Conexiones MySQL".
3. Si ves que está cerca del límite (normalmente 30 o 50), considera optimizar tu tienda o contactar a soporte para aumentarlo.

Paso 6: Reinicia el servicio MySQL desde cPanel (si tienes acceso)

Algunos planes de hosting permiten reiniciar servicios. Si tienes la opción:

1. En cPanel, busca "Administrador de servicios" o "Restart Services".
2. Selecciona "MySQL" y haz clic en "Reiniciar".
3. Espera unos segundos y vuelve a cargar tu tienda.

[TIP] Si no ves esta opción, no te preocupes. El soporte técnico puede hacerlo por ti.

Paso 7: Revisa el archivo .htaccess (si usas redirecciones o reglas especiales)

Un .htaccess mal configurado puede interferir con la conexión a la base de datos, especialmente si usas redirecciones o protecciones con contraseña. Para descartarlo:

1. En el Administrador de Archivos, busca el archivo .htaccess en la raíz de PrestaShop.
2. Renómbralo temporalmente a .htaccess_backup.
3. Prueba tu tienda. Si funciona, el problema estaba ahí. Puedes regenerarlo desde el backoffice de PrestaShop (Parámetros de la tienda > Tráfico y SEO > URL amigables > Guardar).

Soluciones avanzadas si nada funciona

Si después de todos estos pasos el error persiste, prueba lo siguiente:

1. Cambia el host de la base de datos de "localhost" a "127.0.0.1"

A veces el DNS interno falla. Edita parameters.php y cambia 'database_host' => 'localhost' por 'database_host' => '127.0.0.1'.

2. Aumenta el tiempo de espera de conexión

Si tu base de datos es grande o el servidor está lento, añade esta línea al archivo config/defines.inc.php (en PrestaShop 1.6) o app/config/parameters.php (en 1.7):

define('_DB_SERVER_', '127.0.0.1');
define('_DB_PORT_', 3306);

3. Contacta con soporte técnico

Si todo lo anterior falla, puede ser un problema del servidor (MySQL caído, firewall bloqueando, etc.). Abre un ticket de soporte indicando:

• El mensaje de error exacto.
• Los pasos que ya has probado.
• Tu dominio y usuario de cPanel.

[WARNING] No compartas tu contraseña de base de datos en el ticket. El soporte puede acceder a ella de forma segura.

Preguntas frecuentes (FAQ)

¿Por qué veo "Error de conexión a la base de datos" después de mover mi tienda?

Al migrar PrestaShop a otro hosting, las credenciales cambian. Debes editar parameters.php o settings.inc.php con los nuevos datos de cPanel.

¿Puedo perder datos si reparo la base de datos?

No, reparar tablas no borra información. Solo corrige errores internos. Optimizar tampoco elimina datos.

¿Qué hago si no encuentro el archivo parameters.php?

En PrestaShop 1.6, el archivo se llama settings.inc.php y está en config/. En versiones 1.7+, está en app/config/parameters.php. Si no lo ves, activa la opción "Mostrar archivos ocultos" en el Administrador de Archivos.

¿El error puede deberse a un módulo o tema?

Sí, un módulo mal codificado puede saturar la base de datos. Si el error apareció tras instalar algo nuevo, desactívalo desde el backoffice (si puedes acceder) o renombrando la carpeta del módulo en /modules/.

¿Cómo sé si mi base de datos está corrupta?

En phpMyAdmin, si ves tablas con el estado "in use" o "error", están corruptas. También puedes ejecutar CHECK TABLE desde la pestaña SQL.

Consejos finales para evitar futuros errores de conexión

• Haz copias de seguridad periódicas de tu base de datos desde cPanel (sección "Backup").
• Actualiza PrestaShop y sus módulos regularmente.
• No edites archivos de configuración sin hacer un respaldo.
• Usa contraseñas seguras para el usuario de la base de datos.

Si sigues estos pasos, en la mayoría de los casos resolverás el problema de conexión a la base de datos en PrestaShop con cPanel. Recuerda que estamos aquí para ayudarte: si algo no queda claro, no dudes en contactar con nuestro equipo de soporte. ¡Tu tienda online volverá a funcionar en poco tiempo!