Error de conexión base de datos en PrestaShop: FAQ y solución

¡Hola! Soy el técnico de soporte amigable. Entiendo perfectamente la frustración de intentar instalar o conectar PrestaShop y encontrarte con ese temido mensaje de error de base de datos. Es como si la llave no encajara en la cerradura. Pero no te preocupes, es un problema muy común y, en la mayoría de los casos, tiene una solución sencilla. Vamos a desglosarlo paso a paso para que puedas tener tu tienda online funcionando en un santiamén.

Este artículo está diseñado para ser tu guía definitiva. Vamos a explorar las causas más frecuentes del error conexión base de datos en PrestaShop, y te daré soluciones prácticas que puedes aplicar incluso si no eres un experto en MySQL. Al final, tendrás un FAQ PrestaShop que resolverá tus dudas más comunes.

¿Qué significa realmente este error?

Cuando PrestaShop te dice que no puede conectar a la base de datos, significa que el archivo de configuración de tu tienda (el famoso settings.inc.php o parameters.php en versiones modernas) tiene datos incorrectos o la base de datos no está accesible. Es como darle a tu coche una dirección equivocada. Los datos que necesita son:

Servidor de base de datos: Normalmente es localhost o una dirección IP.
Nombre de la base de datos: El nombre que le diste al crear la base de datos.
Usuario de la base de datos: El usuario que tiene permisos para acceder a esa base.
Contraseña: La contraseña de ese usuario.
Puerto: Aunque no siempre se muestra, a veces el puerto por defecto (3306) está cambiado.

Si alguno de estos datos es incorrecto, PrestaShop se queda en la puerta sin poder entrar.

Causa #1: El error más común: Datos de conexión incorrectos

Esta es, con diferencia, la razón número uno. Es muy fácil equivocarse al escribir el nombre de la base de datos, el usuario o la contraseña. Vamos a verificarlos.

Paso 1: Revisa los datos en tu panel de control (Hosting)

Accede a tu panel de hosting. Si usas Syspanel (recuerda, el puerto de acceso es el 2106), busca la sección de Bases de Datos o MySQL.

Localiza el nombre de la base de datos: Suele tener un prefijo, por ejemplo, usuario_mi_tienda.
Localiza el usuario de la base de datos: A menudo es el mismo que el nombre o uno similar, como usuario_mi_user.
Contraseña: Si no la recuerdas, puedes cambiarla desde el mismo panel. Anótala en un bloc de notas para no equivocarte.
Servidor: Normalmente es localhost. Si tu hosting te da una dirección específica, como localhost:3306 o sql.tudominio.com, usa esa.

[WARNING] ¡Cuidado! No confundas el usuario de la base de datos con el usuario de tu panel de control o FTP. Son cuentas diferentes.

Paso 2: Verifica los datos en el archivo de configuración de PrestaShop

Durante la instalación, PrestaShop te pide estos datos. Si ya lo instalaste y no funciona, puedes modificar el archivo directamente.

Conéctate a tu hosting por FTP (usando un programa como FileZilla).
Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html o www).
Busca el archivo app/config/parameters.php (para PrestaShop 1.7 y 8.x) o config/settings.inc.php (para PrestaShop 1.6 y anteriores).
Ábrelo con un editor de texto (como Notepad++ o Sublime Text).
Busca las líneas que contienen:
- 'database_host' => 'localhost'
- 'database_name' => 'tu_nombre_base_datos'
- 'database_user' => 'tu_usuario_base_datos'
- 'database_password' => 'tu_contraseña'
- 'database_port' => '3306' (a veces no aparece)

Compara estos valores exactamente con los que tienes en tu panel de hosting. Un simple error de tipeo, una mayúscula donde no debe, o un guion bajo mal puesto, y la conexión fallará.

[TIP] Si tu contraseña contiene caracteres especiales como $, %, &, #, es posible que estén causando problemas. Cámbiala por una más simple (solo letras y números) desde tu panel de hosting y actualiza el archivo.

Causa #2: El usuario no tiene permisos sobre la base de datos

Imagina que tienes la llave correcta, pero el dueño de la casa no te ha dado permiso para entrar. En MySQL, cada usuario tiene permisos específicos.

Solución: Asignar todos los privilegios al usuario

Desde tu panel de hosting (Syspanel, puerto 2106):

Ve a la sección de Bases de Datos.
Busca la opción Añadir usuario a base de datos o Gestionar privilegios.
Asegúrate de que tu usuario esté vinculado a la base de datos correcta.
Marca TODOS los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). A veces se llama "Todos los privilegios" o "All Privileges".
Guarda los cambios.

[INFO] PrestaShop necesita crear tablas, modificarlas y eliminarlas durante la instalación y las actualizaciones. Sin todos los permisos, fallará.

Causa #3: El servidor de base de datos no responde (problemas de host)

A veces el problema no son tus datos, sino que el servidor donde está alojada la base de datos no es accesible.

¿Cómo saber si es un problema del servidor?

Prueba con localhost: Si tu hosting te da un servidor específico (como sql.tudominio.com), prueba cambiándolo a localhost. Muchos hosts lo usan internamente.
Prueba con la IP del servidor: Pregunta a tu soporte técnico cuál es la IP del servidor MySQL. A veces, por configuraciones de seguridad, no se permite la conexión por nombre de dominio.
Verifica si el puerto es el correcto: El puerto por defecto de MySQL es el 3306. Si tu hosting usa otro (como el 3307), debes especificarlo. En el archivo parameters.php, busca 'database_port' => '3306' y cámbialo si es necesario.

[WARNING] Si cambias el puerto, asegúrate de que tu hosting lo permita. Algunos hosts bloquean ciertos puertos por seguridad.

Causa #4: El archivo de configuración está corrupto o con permisos incorrectos

A veces, al editar el archivo parameters.php, podemos dañarlo sin querer (por ejemplo, al borrar una coma o una comilla).

Solución: Restaurar o reescribir el archivo

Haz una copia de seguridad del archivo actual (por si acaso).
Descarga una instalación limpia de PrestaShop desde la web oficial.
Extrae el archivo parameters.php de la carpeta app/config de la instalación limpia.
Súbelo a tu servidor, reemplazando el antiguo.
Vuelve a intentar la instalación desde cero. Te pedirá los datos de la base de datos otra vez.

Permisos de archivos

Los archivos de configuración deben tener permisos de lectura para el servidor web. Normalmente, 644 es el permiso correcto para archivos. Si no estás seguro, desde tu cliente FTP, haz clic derecho en el archivo, selecciona "Permisos de archivo" y pon 644.

Causa #5: La base de datos ya existe y tiene tablas de una instalación anterior

Si estás reinstalando PrestaShop en la misma base de datos, puede que las tablas antiguas estén causando conflictos.

Solución: Crear una base de datos nueva o limpiar la existente

Opción A (Recomendada): Crear una nueva base de datos

Desde tu panel de hosting, crea una nueva base de datos (por ejemplo, mi_tienda_nueva).
Crea un nuevo usuario y asígnale todos los privilegios sobre esa base.
Durante la instalación de PrestaShop, usa los datos de esta nueva base de datos.

Opción B: Vaciar la base de datos existente

Usa una herramienta como phpMyAdmin (suele estar en tu panel de hosting).
Selecciona la base de datos antigua.
Haz clic en Marcar todas las tablas.
En el menú desplegable, selecciona Eliminar (Drop).
Confirma la eliminación. La base de datos quedará vacía y lista para una nueva instalación.

[TIP] Si no te sientes cómodo usando phpMyAdmin, pide a tu soporte técnico que te ayude a limpiar la base de datos.

FAQ PrestaShop: Preguntas Frecuentes sobre el Error de Conexión

Para terminar, aquí tienes un FAQ rápido con las dudas más habituales:

¿Por qué me sale "Fatal error: Uncaught PDOException" en PrestaShop?

Este error suele indicar que los datos de conexión en parameters.php son incorrectos o que el servidor MySQL no está funcionando. Sigue los pasos de la Causa #1 y #3.

¿Qué hago si no recuerdo mi contraseña de MySQL?

Desde tu panel de hosting (Syspanel, puerto 2106), busca la opción de Cambiar contraseña para el usuario de la base de datos. Luego, actualiza el archivo parameters.php con la nueva contraseña.

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

No directamente. El error de conexión a la base de datos ocurre antes de que cualquier módulo se cargue. Sin embargo, si la base de datos está corrupta por un módulo malo, podrías ver errores, pero no el típico "no se puede conectar".

¿Puedo usar la misma base de datos para dos instalaciones de PrestaShop?

No es recomendable. Cada instalación debe tener su propia base de datos para evitar conflictos de tablas y datos. Si lo haces, terminarás con una mezcla de información de ambas tiendas.

Mi hosting usa "localhost", pero sigo sin poder conectar. ¿Qué más puede ser?

Puede que el servidor MySQL esté caído o que tu proveedor de hosting tenga restricciones de seguridad. Contacta con su soporte técnico y diles que no puedes conectar PrestaShop a la base de datos. Ellos podrán verificar el estado del servidor y darte los datos exactos de conexión.

Espero que esta guía te haya sido de gran ayuda. Recuerda, la paciencia es clave. Revisa cada punto con calma y seguro que encuentras la solución. Si después de todo esto el problema persiste, no dudes en contactar con el soporte de tu hosting. ¡Estamos aquí para ayudarte a que tu tienda online despegue!