Solucionar error de conexión a BD en PrestaShop | FAQ

¡Hola! Soy el soporte técnico de tu hosting. Si estás leyendo esto, seguramente te has encontrado con el temido mensaje de error base datos PrestaShop o un conexión BD PrestaShop fallo. No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. Vamos a ver paso a paso cómo solucionar error MySQL PrestaShop para que tu tienda vuelva a funcionar en unos minutos.

Imagina que tu tienda PrestaShop es una biblioteca: los libros (productos, pedidos, clientes) están guardados en un almacén (la base de datos). Cuando la conexión falla, es como si la puerta del almacén estuviera cerrada o la llave no encajara. Vamos a abrir esa puerta.

¿Por qué ocurre este error? Causas más comunes

Antes de lanzarnos a solucionarlo, es útil entender qué lo provoca. El error base datos PrestaShop suele deberse a una de estas razones:

Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos han cambiado o están mal escritos en el archivo de configuración.
Servidor MySQL caído o sobrecargado: El motor de base de datos se ha detenido o está saturado.
Permisos de usuario revocados: El usuario de la base de datos ha perdido los permisos para acceder a ella.
Archivo de configuración dañado: El archivo settings.inc.php (o parameters.php en versiones recientes) está corrupto o tiene errores de sintaxis.
Migración o cambio de hosting: Al mover la tienda, los datos de conexión no se actualizaron correctamente.
Actualización de PHP o PrestaShop: A veces, una actualización rompe la compatibilidad con la versión de MySQL.

Vamos a solucionarlo de forma ordenada, desde lo más simple a lo más complejo.

Paso 1: Verifica las credenciales en el archivo de configuración

Este es el primer lugar donde mirar. PrestaShop guarda los datos de conexión en un archivo de texto. Si has cambiado la contraseña de la base de datos recientemente o has migrado el sitio, aquí estará el error.

Localiza el archivo correcto

Para PrestaShop 1.6 y anteriores: busca el archivo config/settings.inc.php en la raíz de tu instalación.
Para PrestaShop 1.7 y 8.x: busca el archivo app/config/parameters.php.

¿Qué debes buscar?

Abre el archivo con un editor de texto plano (como Notepad++ o el bloc de notas). Busca estas líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_de_tu_bd');
define('_DB_USER_', 'usuario_de_tu_bd');
define('_DB_PASSWD_', 'contraseña_de_tu_bd');

[WARNING] ¡Cuidado! No subas este archivo a foros ni lo compartas. Contiene las credenciales de tu base de datos.

Comprueba que los datos sean correctos

Servidor: Normalmente es localhost, pero si tu hosting usa servidores remotos, puede ser una IP o un nombre como mysql.tudominio.com.
Nombre de la BD: Debe coincidir exactamente con el que ves en el panel de control de tu hosting.
Usuario: El usuario que tiene acceso a esa base de datos.
Contraseña: Asegúrate de que no tenga espacios al principio o al final.

Si no estás seguro de estos datos, puedes consultarlos en el panel de control de tu hosting. Por ejemplo, si usas Syspanel (el panel de control de HestiaCP, accesible por el puerto 2106), ve a la sección de Bases de Datos y allí verás el nombre, usuario y podrás cambiar la contraseña.

[TIP] Si cambias la contraseña desde el panel, recuerda actualizarla también en este archivo de configuración.

Paso 2: Reinicia el servicio MySQL (si tienes acceso al servidor)

A veces el problema es que el motor de base de datos simplemente se ha detenido. Si tienes acceso a la terminal del servidor (por SSH) o a un panel como Syspanel, puedes reiniciarlo.

Desde Syspanel (HestiaCP, puerto 2106)

Inicia sesión en tu Syspanel (ejemplo: https://tudominio.com:2106).
Ve a la sección de Servicios o Services.
Busca el servicio mysql o mariadb.
Haz clic en Reiniciar.

Desde la terminal (SSH)

Si tienes acceso por SSH, ejecuta:

sudo systemctl restart mysql
# o si usas MariaDB:
sudo systemctl restart mariadb

[INFO] No todos los hostings permiten acceso SSH. Si no, contacta con el soporte técnico para que lo hagan ellos.

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

Aunque el usuario y la contraseña sean correctos, es posible que el usuario no tenga permisos para acceder a la base de datos desde el servidor web. Esto pasa a menudo después de restaurar una copia de seguridad o migrar.

Cómo comprobarlo desde Syspanel

En Syspanel, ve a Bases de Datos.
Busca tu base de datos y haz clic en Editar o Permisos.
Asegúrate de que el usuario tenga marcados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.) o al menos los básicos para que PrestaShop funcione.
También verifica que el host del usuario sea localhost o % (todos los hosts). Si pusiste una IP específica, el servidor web podría no coincidir.

[WARNING] Si no ves la opción de permisos, es posible que necesites crear un nuevo usuario y asignarlo a la base de datos. En Syspanel puedes hacerlo fácilmente desde la misma sección.

Paso 4: Revisa el archivo .htaccess (solo si es un problema de redirección)

A veces, un .htaccess corrupto puede causar que PrestaShop no pueda conectar con la base de datos porque redirige mal las peticiones. Esto es menos común, pero vale la pena comprobarlo.

Conéctate a tu servidor por FTP o desde el administrador de archivos de Syspanel.
Renombra el archivo .htaccess en la raíz de tu tienda a .htaccess_old.
Ve al back office de PrestaShop (si puedes acceder) y regenera el .htaccess desde Configuración > Tráfico y SEO > URL amigables. Si no puedes acceder al back office, prueba a entrar a la tienda de nuevo. Si funciona, el .htaccess estaba dañado.

[TIP] Si no puedes acceder al back office, no te preocupes. A veces solo renombrar el archivo ya soluciona el error de conexión.

Paso 5: Comprueba la versión de PHP y MySQL

PrestaShop es exigente con las versiones. Por ejemplo, PrestaShop 1.7 necesita PHP 7.1 o superior y MySQL 5.6 o superior. Si tu hosting actualizó PHP o MySQL y tu versión de PrestaShop es antigua, puede que la conexión falle.

Cómo verificarlo

En Syspanel, ve a la sección de PHP o Configuración del sitio.
Allí podrás cambiar la versión de PHP. Prueba con una versión compatible con tu PrestaShop (por ejemplo, PHP 7.4 para PrestaShop 1.7.8).
Para MySQL, contacta con el soporte de tu hosting para saber la versión.

[INFO] Si tu PrestaShop es muy antiguo (1.6 o anterior), considera actualizarlo. Las versiones viejas ya no reciben soporte y son vulnerables.

Paso 6: Restaura una copia de seguridad de la base de datos

Si todo lo anterior falla, es posible que la base de datos esté corrupta. Si tienes una copia de seguridad reciente, restaurarla puede ser la solución más rápida.

Desde Syspanel (HestiaCP, puerto 2106)

Ve a Bases de Datos y selecciona tu base de datos.
Busca la opción Restaurar o Importar.
Sube el archivo .sql de tu copia de seguridad.
Asegúrate de que el nombre de la base de datos y el usuario coincidan con los del archivo parameters.php o settings.inc.php.

[WARNING] Al restaurar, perderás los datos creados después de la copia de seguridad (pedidos, clientes, etc.). Hazlo solo si es necesario.

Paso 7: Contacta con el soporte técnico de tu hosting

Si después de todos estos pasos el conexión BD PrestaShop fallo persiste, es hora de pedir ayuda profesional. El problema podría estar en el servidor (como un firewall bloqueando el puerto 3306 de MySQL) o en una configuración interna que solo el equipo de hosting puede ver.

[TIP] Cuando contactes al soporte, diles exactamente qué has probado: "He verificado las credenciales en parameters.php, reiniciado MySQL desde Syspanel, y revisado los permisos. El error sigue apareciendo". Esto les ahorrará tiempo y te ayudarán más rápido.

Preguntas Frecuentes (FAQ)

¿Por qué veo el error después de cambiar la contraseña de la base de datos?

Porque no actualizaste el archivo de configuración de PrestaShop. Ve a app/config/parameters.php (o config/settings.inc.php) y cambia la línea _DB_PASSWD_ por la nueva contraseña.

¿El error puede deberse a un plugin de PrestaShop?

Sí, algunos módulos mal codificados pueden saturar la base de datos o cambiar su estructura. Si el error apareció tras instalar un módulo, desactívalo desde el back office (si puedes acceder) o renombra su carpeta en /modules.

¿Cómo sé si mi hosting usa Syspanel (HestiaCP)?

Normalmente te lo indican al contratar el servicio. Si tienes acceso a través del puerto 2106 (ejemplo: https://tudominio.com:2106), estás usando Syspanel.

¿Puedo solucionar el error desde el back office de PrestaShop?

No directamente, porque si la base de datos no conecta, el back office tampoco cargará. Debes solucionarlo desde los archivos o el panel de hosting.

¿Qué hago si el error dice "Too many connections"?

Significa que hay demasiadas conexiones abiertas a la base de datos. Puedes aumentar el límite desde la configuración de MySQL (si tienes acceso) o contactar al soporte. También revisa si tienes algún script malicioso o un plugin que haga muchas consultas.

Resumen final

El error base datos PrestaShop suele tener solución en pocos minutos si sigues estos pasos en orden:

Revisa las credenciales en el archivo de configuración.
Reinicia el servicio MySQL desde Syspanel (puerto 2106) o SSH.
Verifica los permisos del usuario de la base de datos.
Prueba renombrando el .htaccess.
Comprueba la compatibilidad de versiones PHP/MySQL.
Restaura una copia de seguridad si es necesario.
Pide ayuda al soporte técnico.

Recuerda que siempre puedes contar conmigo para resolver dudas. ¡Tu tienda online volverá a funcionar en nada!