Error de base de datos en PrestaShop: Causas y soluciones

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí es porque seguramente te has topado con un mensaje de error al intentar instalar PrestaShop, y lo más probable es que tenga que ver con la base de datos. No te preocupes, es un problema muy común, especialmente cuando se usa un panel de control como cPanel o Syspanel (antes conocido como HestiaCP). En esta guía extensa y paso a paso, vamos a desglosar todas las causas posibles y, lo más importante, cómo solucionar el error de base de datos en la instalación de PrestaShop.

Vamos a empezar desde lo más básico: entender qué es una base de datos y por qué PrestaShop la necesita para funcionar. Luego, veremos los errores más frecuentes, sus causas y, por supuesto, las soluciones prácticas que puedes aplicar tú mismo, sin necesidad de ser un experto en programación.

¿Por qué aparece un error de base de datos en la instalación de PrestaShop?

Cuando instalas PrestaShop, el proceso de instalación intenta conectar con un servidor de base de datos (normalmente MySQL o MariaDB) para crear las tablas donde se guardará toda la información de tu tienda: productos, clientes, pedidos, configuraciones, etc. Si algo falla en esa conexión, el instalador se detiene y muestra un mensaje de error.

Los errores más comunes que verás son:

"Error de conexión a la base de datos"
"No se puede crear la base de datos"
"El usuario no tiene permisos suficientes"
"Nombre de base de datos o usuario incorrecto"

No te asustes por los mensajes técnicos. Cada uno tiene una solución sencilla que vamos a ver a continuación.

Requisitos previos antes de empezar la instalación

Antes de lanzarte a instalar PrestaShop, asegúrate de tener todo lo necesario. Esto te ahorrará muchos dolores de cabeza.

1. Acceso a tu panel de control (cPanel o Syspanel)

Necesitarás entrar a tu panel de hosting. Dependiendo de tu proveedor, será:

cPanel: El más común. Accedes normalmente a través de tudominio.com/cpanel o tudominio.com:2083.
Syspanel (antes HestiaCP): Accedes a través de tudominio.com:2106. Recuerda que el puerto es el 2106, no el 2083.

2. Datos de la base de datos que debes tener a mano

Para que la instalación funcione, necesitas cuatro datos clave:

Nombre de la base de datos: Ejemplo: miusuario_mi_tienda
Nombre de usuario de la base de datos: Ejemplo: miusuario_admin
Contraseña del usuario: La que hayas definido al crear el usuario.
Servidor de la base de datos: Normalmente es localhost, pero a veces tu hosting te da una dirección como mysql.tudominio.com.

[TIP] Antes de empezar la instalación de PrestaShop, abre el panel de control y crea la base de datos y el usuario. No esperes a que el instalador lo haga por ti, porque a veces no tiene permisos para hacerlo.

Paso a paso: Cómo crear la base de datos correctamente (cPanel y Syspanel)

Vamos a ver cómo crear la base de datos en los dos paneles más habituales. Sigue estos pasos al pie de la letra.

En cPanel

Inicia sesión en tu cPanel.
Busca la sección "Bases de Datos" y haz clic en "MySQL Databases" (o "Bases de datos MySQL").
En "Create New Database", escribe un nombre para tu base de datos (por ejemplo, prestashop). cPanel añadirá automáticamente tu nombre de usuario al inicio. Ejemplo: tunombre_prestashop.
Haz clic en "Create Database".
Baja a la sección "Add New User". Crea un nombre de usuario (ejemplo: adminpresta) y una contraseña segura. Anótala.
En "Add User to Database", selecciona el usuario que acabas de crear y la base de datos que creaste. Luego, en "Privileges", marca "ALL PRIVILEGES" (todos los privilegios). Haz clic en "Make Changes".

¡Listo! Ya tienes tu base de datos y usuario creados.

En Syspanel (HestiaCP, puerto 2106)

Accede a tu panel Syspanel a través de tudominio.com:2106.
Ve a la pestaña "Base de datos" en el menú lateral izquierdo.
Haz clic en "Añadir base de datos".
Completa los campos:
- Base de datos: Pon un nombre descriptivo, por ejemplo, prestashop.
- Usuario: El sistema te sugerirá uno, pero puedes cambiarlo. Ejemplo: presta_user.
- Contraseña: Genera una segura o escríbela tú. Guárdala bien.
Haz clic en "Guardar".

Syspanel crea automáticamente la base de datos, el usuario y asigna los permisos necesarios. Más fácil, imposible.

[INFO] En Syspanel, el nombre de la base de datos y el usuario suelen ser los mismos que el de tu cuenta de hosting, a menos que lo cambies manualmente. No te confundas.

Errores comunes y sus soluciones

Ahora vamos a lo que te interesa: solucionar el error. He clasificado los problemas más frecuentes con sus respectivas soluciones.

Error 1: "Nombre de base de datos o usuario incorrecto"

Este es el error más común. El instalador de PrestaShop no encuentra la base de datos o el usuario que le estás indicando.

Causas posibles:

Escribiste mal el nombre (mayúsculas, minúsculas, guiones bajos).
En cPanel, el nombre real incluye el prefijo de tu cuenta (por ejemplo, tuusuario_prestashop), pero tú pusiste solo prestashop.
El usuario no tiene permisos sobre esa base de datos.

Solución:

Vuelve a tu panel de control y verifica exactamente cómo se llama la base de datos y el usuario. En cPanel, el nombre completo aparece en la lista de bases de datos. Copia y pega, no escribas a mano.
Asegúrate de que el usuario esté vinculado a la base de datos y tenga todos los privilegios. Si no, repite el paso de añadir usuario a la base de datos.
En la instalación de PrestaShop, en el campo "Servidor de base de datos", prueba con localhost. Si no funciona, consulta con tu hosting la dirección exacta.

Error 2: "No se puede conectar al servidor de base de datos"

Este error indica que PrestaShop no puede contactar con el servidor MySQL.

Causas posibles:

El servidor de base de datos no es localhost (en algunos hostings compartidos usan un nombre como mysql.tudominio.com).
El servicio MySQL está caído (raro, pero puede pasar).
El firewall del servidor bloquea la conexión en el puerto 3306.

Solución:

Pregunta a tu proveedor de hosting cuál es el servidor de base de datos. Normalmente lo indican en el panel de control o en el correo de bienvenida.
Si usas cPanel, en la sección "MySQL Databases" suele aparecer la dirección del servidor. Si no, escribe localhost.
Si nada funciona, contacta al soporte técnico de tu hosting y diles que necesitas la dirección del servidor MySQL para una instalación de PrestaShop.

Error 3: "El usuario no tiene permisos para crear la base de datos"

Esto ocurre cuando intentas que el instalador de PrestaShop cree la base de datos automáticamente, pero el usuario que usas no tiene permisos para hacerlo.

Solución:

Nunca le pidas al instalador que cree la base de datos. Siempre créala tú primero desde el panel de control (como te expliqué arriba).
Durante la instalación de PrestaShop, en el paso de la base de datos, selecciona la opción "Ya he creado la base de datos" (o similar). Luego solo rellena el nombre, usuario y contraseña.

Error 4: "Error al crear las tablas de la base de datos"

Este error suele aparecer después de que la conexión es exitosa, pero al intentar crear las tablas de PrestaShop falla.

Causas posibles:

La base de datos ya existe y tiene tablas de una instalación anterior.
El motor de base de datos (InnoDB) no está disponible o está deshabilitado.
El usuario no tiene permisos para crear tablas (aunque tenga "todos", a veces falta alguno).

Solución:

Limpia la base de datos: Si ya habías intentado instalar antes, es probable que queden tablas. Desde tu panel de control, entra a phpMyAdmin (en cPanel está en "Bases de Datos" > "phpMyAdmin"). Selecciona la base de datos y, en la pestaña "Operaciones", elige "Vaciar la base de datos" (DROP). Luego créala de nuevo.
Verifica el motor: En phpMyAdmin, ve a la pestaña "Base de datos" y mira que el cotejamiento sea utf8_general_ci o utf8mb4_general_ci. Si no, puedes cambiarlo desde "Operaciones".
Asegura los permisos: En cPanel, ve a "MySQL Databases", busca la sección "Current Users" y verifica que tu usuario tenga marcado ALL PRIVILEGES. Si no, selecciona la base de datos y el usuario, y asígnalos de nuevo.

Error 5: "Versión de PHP incompatible"

Aunque no es un error directo de base de datos, es muy frecuente durante la instalación. PrestaShop requiere una versión específica de PHP (normalmente 7.4, 8.0 o 8.1, según la versión de PrestaShop).

Solución:

En cPanel, busca la sección "Software" y haz clic en "Select PHP Version". Elige la versión recomendada por PrestaShop (por ejemplo, 8.0).
En Syspanel, ve a la pestaña "Web", selecciona tu dominio y en "Opciones avanzadas" puedes cambiar la versión de PHP.

[WARNING] No elijas una versión de PHP demasiado nueva (como 8.2 o 8.3) a menos que tu versión de PrestaShop la soporte oficialmente. Revisa los requisitos del sistema en la web oficial de PrestaShop.

Solución rápida: Script de verificación de requisitos

Antes de instalar, PrestaShop incluye un script que verifica si tu servidor cumple con todos los requisitos (PHP, extensiones, permisos, etc.). Si el error de base de datos persiste, puede que sea por algo más.

Descarga PrestaShop desde la web oficial.
Sube la carpeta prestashop a tu servidor (normalmente en public_html).
En tu navegador, ve a tudominio.com/prestashop/install/.
El instalador te mostrará una pantalla con los requisitos. Si algo está en rojo, sabrás por dónde empezar.

Preguntas frecuentes (FAQ)

¿Qué hago si no encuentro la opción de crear base de datos en cPanel?

Busca en la sección "Bases de Datos" y haz clic en "MySQL Databases". Si no aparece, contacta a tu hosting, ya que puede que tu plan no incluya bases de datos.

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

No, cada instalación necesita su propia base de datos. Si usas la misma, los datos se mezclarán y dará errores.

¿Qué es el "cotejamiento" de la base de datos y por qué importa?

El cotejamiento define cómo se ordenan y comparan los caracteres. Para PrestaShop, usa utf8_general_ci o utf8mb4_general_ci. Si usas otro, pueden aparecer problemas con caracteres especiales (acentos, eñes).

¿Por qué me pide el "puerto de la base de datos"?

Normalmente es el 3306, pero algunos hostings usan puertos diferentes. Si no estás seguro, déjalo en blanco o escribe 3306. El instalador lo detectará automáticamente.

¿Syspanel es lo mismo que HestiaCP?

Sí, Syspanel es la versión moderna de HestiaCP, con una interfaz más limpia. El acceso sigue siendo por el puerto 2106.

Consejos finales para una instalación sin problemas

Lee los mensajes de error: A veces el instalador te da pistas muy claras. No los ignores.
Usa contraseñas seguras: Para la base de datos, combina letras, números y símbolos. Guárdalas en un gestor de contraseñas.
Haz una copia de seguridad: Antes de instalar, si ya tienes algo en el servidor, respáldalo.
Actualiza todo: Asegúrate de que tu PrestaShop, PHP y el panel de control estén actualizados.
Prueba con un instalador manual: Si el instalador web falla, puedes descargar el archivo ZIP de PrestaShop, descomprimirlo en tu PC y subir los archivos por FTP. Luego ejecutas la instalación desde el navegador.

Resumen: Lo que debes recordar

Si te encuentras con el temido error base de datos PrestaShop, no entres en pánico. Sigue esta lista de verificación:

✅ Crea la base de datos y el usuario desde tu panel (cPanel o Syspanel).
✅ Asigna todos los privilegios al usuario sobre la base de datos.
✅ Usa localhost como servidor, a menos que tu hosting te indique otra cosa.
✅ Durante la instalación, selecciona "Ya tengo la base de datos creada".
✅ Verifica que la versión de PHP sea la correcta.
✅ Si el error persiste, usa phpMyAdmin para limpiar la base de datos e intenta de nuevo.

Y recuerda, siempre puedes contactar con el soporte técnico de tu hosting si algo no funciona. Ellos tienen acceso directo al servidor y pueden ayudarte en segundos.

Espero que esta guía te haya sido de gran ayuda. ¡Ahora ya puedes instalar PrestaShop sin miedo a los errores de base de datos! Si tienes más dudas, no dudes en escribirme. ¡Buena suerte con tu tienda online!