Error base de datos PrestaShop en Syspanel | Guía rápida

¡Hola! Soy el técnico de soporte amigable. ¿Has abierto tu tienda PrestaShop y te has encontrado con un mensaje de error de conexión a la base de datos? No te preocupes, es uno de los problemas más comunes, pero también de los que tienen solución más a mano. En esta guía completa, te explicaré paso a paso cómo diagnosticar y solucionar el error base datos PrestaShop Syspanel, para que tu tienda vuelva a funcionar en minutos.

Vamos a empezar desde lo más básico, entendiendo qué significa este error y cómo abordarlo sin necesidad de ser un experto en programación. Presta atención, porque te daré trucos y alertas que te ahorrarán tiempo y dolores de cabeza.

¿Qué significa el error de conexión a base de datos en PrestaShop?

Cuando ves un mensaje como "Error de conexión a la base de datos" o "No se puede conectar con la base de datos", significa que tu tienda PrestaShop no puede comunicarse con el servidor donde se almacena toda la información de tu tienda (productos, clientes, pedidos, etc.). Es como si intentaras abrir una caja fuerte pero la llave no encaja o la cerradura está rota.

Las causas más frecuentes son:

Credenciales incorrectas: El nombre de usuario, contraseña o nombre de la base de datos han cambiado.
Servidor de base de datos caído: El servicio MySQL o MariaDB no está funcionando.
Archivo de configuración dañado: El archivo app/config/parameters.php contiene datos erróneos.
Problemas de permisos: El usuario de la base de datos no tiene acceso a la base de datos correcta.
Firewall o puertos bloqueados: El servidor donde está alojada la base de datos no permite conexiones desde tu servidor web.

Vamos a solucionarlo desde el panel de control de tu hosting, que en este caso es Syspanel (recuerda que el acceso es a través del puerto 2106).

Paso 1: Acceder a Syspanel para revisar el estado de la base de datos

Lo primero es entrar a tu panel de control Syspanel. Abre tu navegador y escribe la dirección de tu servidor seguida de :2106. Por ejemplo: https://tudominio.com:2106 o https://tu-ip:2106. Inicia sesión con tu usuario y contraseña de administrador.

[TIP] Si no recuerdas tus credenciales de Syspanel, contacta a tu proveedor de hosting. Sin acceso al panel no podrás continuar.

Una vez dentro, busca la sección de Base de datos o MySQL. Dependiendo de la versión de Syspanel, puede estar en el menú lateral o en un icono. Aquí verás todas las bases de datos que tienes creadas.

### Verificar que el servicio MySQL está activo

En Syspanel, busca una opción que diga Servicios o Estado del servidor. Deberías ver una lista con servicios como Apache, Nginx, MySQL, etc. Asegúrate de que MySQL (o MariaDB) aparezca como activo (running). Si está detenido, haz clic en el botón Iniciar o Reiniciar.

[WARNING] Si el servicio no se inicia, puede haber un problema más grave (falta de espacio en disco, archivos corruptos). En ese caso, contacta a soporte técnico.

Paso 2: Obtener las credenciales correctas desde Syspanel

Ahora necesitas las credenciales exactas de tu base de datos. En Syspanel, ve a la sección Base de datos y localiza el nombre de la base de datos que usa tu PrestaShop. Haz clic en Editar o Ver detalles. Allí encontrarás:

Nombre de la base de datos (por ejemplo: tienda_prestashop)
Usuario de la base de datos (por ejemplo: usuario_tienda)
Contraseña (si no la ves, puedes generar una nueva, pero cuidado: tendrás que actualizarla en PrestaShop)

[INFO] Anota estos tres datos en un bloc de notas. Son los que usaremos en el siguiente paso.

Paso 3: Revisar y corregir el archivo de configuración de PrestaShop

PrestaShop guarda la configuración de la base de datos en el archivo app/config/parameters.php. Si este archivo tiene datos incorrectos, tu tienda no podrá conectar.

Accede a tu servidor mediante FTP o Gestor de archivos de Syspanel (suele estar en la sección Archivos). Navega hasta la carpeta raíz de tu tienda (normalmente public_html o www). Luego entra en app/config/ y busca el archivo parameters.php.

Descarga una copia de seguridad por si acaso, y luego edítalo con un editor de texto plano (como Notepad++, Sublime Text o incluso el bloc de notas). Busca las siguientes líneas:

'database_host' => 'localhost',
'database_port' => '',
'database_name' => 'nombre_base_datos',
'database_user' => 'usuario_base_datos',
'database_password' => 'contraseña_base_datos',

Asegúrate de que coincidan exactamente con los datos que obtuviste en Syspanel. Presta especial atención:

database_host: Normalmente es localhost, pero si tu base de datos está en otro servidor, puede ser una IP o nombre de dominio. En Syspanel, suele ser localhost a menos que uses un servicio externo.
database_port: Déjalo vacío o pon 3306 (puerto por defecto de MySQL). Si tu hosting usa otro puerto, te lo habrán indicado.
database_name: El nombre exacto que viste en Syspanel.
database_user: El usuario exacto.
database_password: La contraseña exacta. Si la has cambiado en Syspanel, actualízala aquí.

Guarda el archivo y súbelo de nuevo al servidor, reemplazando el original.

[WARNING] No uses comillas dobles o simples incorrectas. El archivo debe tener sintaxis PHP válida. Si no estás seguro, pide ayuda.

Paso 4: Probar la conexión manualmente desde Syspanel

Para asegurarte de que las credenciales funcionan, puedes probar la conexión directamente desde Syspanel. En la sección de Base de datos, busca una opción que diga phpMyAdmin o Acceso a base de datos. Haz clic y se abrirá una herramienta web. Introduce el usuario y contraseña que tienes en el archivo parameters.php.

Si puedes entrar y ver las tablas de PrestaShop (como ps_product, ps_customer, etc.), entonces la conexión es correcta. Si no puedes acceder, el problema está en las credenciales o en los permisos del usuario.

### Solucionar problemas de permisos en Syspanel

Si las credenciales son correctas pero no puedes acceder, es posible que el usuario no tenga permisos sobre la base de datos. En Syspanel, ve a la sección Base de datos y edita la base de datos. Deberías ver una opción para Añadir usuario o Gestionar permisos. Asegúrate de que el usuario que usa PrestaShop tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si no, asígnaselos.

[TIP] Si creaste una nueva contraseña en Syspanel, asegúrate de que el usuario esté vinculado a la base de datos correcta. A veces se crean usuarios independientes.

Paso 5: Verificar el archivo .htaccess y la caché

A veces, un archivo .htaccess corrupto o una caché de PrestaShop puede causar errores de conexión aunque la base de datos esté bien.

Desde el gestor de archivos de Syspanel, busca en la raíz de tu tienda el archivo .htaccess. Si existe, renómbralo a .htaccess_old para desactivarlo temporalmente. Luego, desde el panel de administración de PrestaShop (si puedes acceder), ve a Parámetros de la tienda > Tráfico y SEO > URL amigables y regenera el .htaccess.

Si no puedes acceder al panel, borra manualmente la carpeta var/cache/ dentro de la raíz de PrestaShop (o su contenido). Esto limpiará la caché y forzará a PrestaShop a leer la configuración nueva.

[WARNING] Al borrar la caché, tu tienda puede cargar un poco más lento la primera vez, pero se regenerará automáticamente.

Paso 6: Comprobar el firewall y los puertos (casos avanzados)

Si todo lo anterior falla, puede que el firewall del servidor esté bloqueando la conexión a la base de datos. En Syspanel, ve a Servicios > Firewall o Seguridad. Asegúrate de que el puerto 3306 (MySQL) esté permitido para conexiones locales (desde el mismo servidor). Si tu base de datos está en un servidor externo, necesitarás que el puerto esté abierto para la IP de tu servidor web.

[INFO] En la mayoría de los casos, con hosting compartido, la base de datos está en el mismo servidor (localhost) y no necesitas abrir puertos. Pero si usas un servicio como Amazon RDS o similar, verifica las reglas de seguridad.

Paso 7: Restaurar desde una copia de seguridad (último recurso)

Si después de todos estos pasos el error persiste, es posible que la base de datos esté corrupta. En Syspanel, busca la opción Backup o Copias de seguridad. Restaura la última copia de seguridad de tu base de datos. Esto sobrescribirá los datos actuales, pero puede solucionar problemas de tablas dañadas.

Antes de restaurar, asegúrate de tener una copia reciente. Si no tienes, contacta a tu hosting para ver si ellos tienen una.

[WARNING] Restaurar una base de datos borrará los cambios realizados después de la copia. Úsalo solo si no hay otra opción.

Preguntas frecuentes (FAQ)

¿Por qué aparece el error "conexión DB PrestaShop" después de cambiar la contraseña en Syspanel?

Porque el archivo parameters.php sigue teniendo la contraseña antigua. Actualízala como expliqué en el Paso 3.

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

Puede que esté en otra ruta si tu PrestaShop es muy antiguo. Busca en config/settings.inc.php (versiones 1.6 o anteriores). En PrestaShop 1.7 y 8.x, siempre es app/config/parameters.php.

¿El error puede deberse a un plugin o tema?

Sí, aunque es menos común. Prueba a desactivar temporalmente todos los módulos no esenciales desde el panel de administración (si puedes acceder). Si no, renombra la carpeta modules a modules_old para desactivarlos todos, y luego ve activándolos uno a uno.

¿Syspanel me permite cambiar el puerto de la base de datos?

Sí, en la configuración de la base de datos puedes ver el puerto. Si no es el 3306, asegúrate de ponerlo en database_port en el archivo parameters.php.

¿Necesito reiniciar algo después de cambiar la configuración?

No es necesario, pero puedes reiniciar el servicio MySQL desde Syspanel para asegurarte de que los cambios surtan efecto. También limpia la caché de PrestaShop como mencioné antes.

Conclusión

El error base datos PrestaShop Syspanel puede ser frustrante, pero como has visto, la mayoría de las veces se soluciona revisando las credenciales, el estado del servicio y el archivo de configuración. Recuerda siempre:

Accede a Syspanel por el puerto 2106.
Verifica que MySQL esté activo.
Anota las credenciales exactas.
Edita app/config/parameters.php con esos datos.
Prueba la conexión con phpMyAdmin.
Limpia la caché y regenera el .htaccess.

Si después de todo esto sigues teniendo problemas, no dudes en contactar a tu proveedor de hosting o a un técnico especializado. Pero confío en que con esta guía podrás resolverlo tú mismo. ¡Tu tienda volverá a estar online en poco tiempo!

¿Te ha funcionado? ¿Tienes alguna otra duda? Déjamela en los comentarios o consulta con nuestro equipo de soporte. ¡Estamos aquí para ayudarte!