Solucionar errores de conexión PrestaShop en Syspanel

Introducción: ¿Por qué aparece un error de conexión en PrestaShop?

Si estás leyendo esta guía, probablemente te has encontrado con un mensaje de error como "Error de conexión a la base de datos" o "No se puede conectar con el servidor de base de datos" al intentar acceder a tu tienda PrestaShop. No te preocupes, es uno de los problemas más comunes y, en la mayoría de los casos, tiene una solución sencilla.

El error conexión PrestaShop Syspanel suele deberse a cambios en la configuración de tu servidor, contraseñas incorrectas o problemas con el archivo de configuración de PrestaShop. En esta guía te explicaremos paso a paso cómo diagnosticar y solucionar estos errores, incluso si no tienes experiencia técnica.

¿Qué es Syspanel y cómo acceder?

Syspanel (anteriormente conocido como HestiaCP) es el panel de control de tu hosting. Desde aquí puedes gestionar bases de datos, dominios, usuarios FTP y mucho más. Para acceder a Syspanel, abre tu navegador y escribe:

https://tudominio.com:2106

[INFO] El puerto 2106 es el estándar para acceder a Syspanel. Si no recuerdas tu contraseña, contacta con tu proveedor de hosting para restablecerla.

Paso 1: Identificar el tipo de error de conexión

Antes de solucionar el error conexión PrestaShop Syspanel, es importante saber qué tipo de error estás viendo. Los más comunes son:

"Error de conexión a la base de datos": Aparece al cargar la tienda o el panel de administración.
"No se puede conectar con el servidor MySQL": Indica que PrestaShop no encuentra el servidor de base de datos.
"Acceso denegado para el usuario": Problema con el nombre de usuario o contraseña de la base de datos.

Cada uno tiene una causa diferente, pero todos se solucionan revisando la configuración de tu PrestaShop base de datos.

Paso 2: Localizar el archivo de configuración de PrestaShop

El archivo que contiene los datos de conexión a la base de datos se llama settings.inc.php y está en la carpeta config de tu instalación de PrestaShop. Para acceder a él:

Conéctate a tu servidor vía FTP (puedes usar FileZilla o el administrador de archivos de Syspanel).
Navega hasta la carpeta raíz de tu tienda (normalmente public_html o www).
Abre la carpeta config.
Busca el archivo settings.inc.php.

[WARNING] Antes de modificar cualquier archivo, haz una copia de seguridad. Si algo sale mal, podrás restaurarlo fácilmente.

Paso 3: Revisar los datos de conexión en settings.inc.php

Abre settings.inc.php con un editor de texto (como Notepad++ o el editor de Syspanel). Busca las siguientes líneas:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_base_datos');
define('_DB_USER_', 'usuario_base_datos');
define('_DB_PASSWD_', 'contraseña_base_datos');

Verifica que estos datos coincidan exactamente con los que tienes en Syspanel. Los errores más comunes son:

Servidor incorrecto: Si tu base de datos está en un servidor remoto, _DB_SERVER_ debe tener la IP o el nombre del servidor (no siempre es localhost).
Nombre de base de datos mal escrito: PrestaShop distingue entre mayúsculas y minúsculas.
Usuario o contraseña incorrectos: Asegúrate de que no haya espacios al principio o al final.

Paso 4: Verificar la base de datos en Syspanel

Ahora vamos a Syspanel para confirmar que la base de datos existe y está activa:

Inicia sesión en Syspanel (recuerda: https://tudominio.com:2106).
Ve a la sección Bases de datos (o Databases).
Busca el nombre de la base de datos que aparece en settings.inc.php.
Haz clic en el nombre para ver los detalles: usuario, contraseña y servidor.

Si no ves la base de datos, puede que haya sido eliminada por error. En ese caso, deberás crearla de nuevo (más adelante te explicamos cómo).

Paso 5: Probar la conexión manualmente

Para asegurarte de que los datos son correctos, puedes probar la conexión desde el propio servidor. Si tienes acceso SSH (o desde el administrador de archivos de Syspanel), puedes crear un archivo PHP de prueba:

Crea un archivo llamado test_db.php en la carpeta raíz de tu tienda.
Pega este código:

<?php
$servername = "localhost";
$username = "tu_usuario";
$password = "tu_contraseña";
$dbname = "tu_base_datos";

$conn = new mysqli($servername, $username, $password, $dbname);

if ($conn->connect_error) {
    die("Error de conexión: " . $conn->connect_error);
} else {
    echo "Conexión exitosa a la base de datos";
}
$conn->close();
?>

Reemplaza localhost, tu_usuario, tu_contraseña y tu_base_datos con los datos reales.
Accede a https://tudominio.com/test_db.php desde tu navegador.

Si ves "Conexión exitosa", el problema está en otra parte (quizás en la configuración de PrestaShop). Si ves un error, sabrás que los datos son incorrectos.

[TIP] Después de la prueba, elimina el archivo test_db.php por seguridad.

Paso 6: Solucionar errores comunes de conexión

Error: "Acceso denegado para el usuario"

Esto significa que el usuario no tiene permisos para acceder a la base de datos. En Syspanel:

Ve a Bases de datos y selecciona la base de datos problemática.
En la sección Usuarios, asegúrate de que el usuario que usas en PrestaShop esté añadido.
Si no aparece, añádelo con todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).
Guarda los cambios y prueba de nuevo.

Error: "No se puede conectar con el servidor MySQL"

Este error suele ocurrir cuando el servidor de base de datos no está funcionando. En Syspanel:

Ve a Servicios (o Services).
Busca MySQL o MariaDB.
Si está detenido, haz clic en Iniciar (Start).
Si ya está iniciado, reinícialo (Restart).

Si el servicio se detiene constantemente, puede haber un problema de recursos o configuración. Contacta con tu proveedor de hosting.

Error: "Tabla 'ps_xxx' no existe"

Esto indica que la base de datos está dañada o faltan tablas. Puedes repararla desde Syspanel:

Ve a Bases de datos y selecciona la base de datos.
Busca la opción Reparar (Repair) o Optimizar (Optimize).
Ejecuta la reparación.

Si el problema persiste, necesitarás restaurar una copia de seguridad de la base de datos.

Paso 7: Restaurar una copia de seguridad de la base de datos

Si después de todos los pasos anteriores el error conexión PrestaShop Syspanel continúa, es posible que necesites restaurar una copia de seguridad. Sigue estos pasos:

En Syspanel, ve a Bases de datos y selecciona la base de datos.
Haz clic en Copias de seguridad (Backups).
Elige una copia de seguridad reciente y haz clic en Restaurar.
Confirma la acción.

[WARNING] Restaurar una copia de seguridad sobrescribirá todos los datos actuales. Asegúrate de que sea la copia correcta.

Si no tienes copia de seguridad, deberás recrear la base de datos desde cero. Esto implica:

Crear una nueva base de datos en Syspanel.
Importar un archivo SQL de tu tienda (si lo tienes guardado).
Actualizar settings.inc.php con los nuevos datos.

Paso 8: Actualizar la configuración de PrestaShop

Después de corregir los datos de conexión, es posible que PrestaShop haya almacenado en caché la configuración antigua. Para forzar una actualización:

Accede a tu panel de administración de PrestaShop (si puedes).
Ve a Parámetros avanzados > Rendimiento.
Haz clic en Limpiar caché (Clear cache).
También puedes eliminar manualmente la carpeta var/cache de tu instalación de PrestaShop (vía FTP).

Si no puedes acceder al panel de administración, elimina la carpeta cache desde FTP o el administrador de archivos de Syspanel.

Preguntas frecuentes (FAQ)

¿Por qué aparece "Error de conexión a la base de datos" después de cambiar la contraseña en Syspanel?

Al cambiar la contraseña de la base de datos en Syspanel, debes actualizar también el archivo settings.inc.php de PrestaShop con la nueva contraseña. De lo contrario, el sistema no podrá conectar.

¿Puedo usar el mismo usuario para varias bases de datos?

Sí, pero asegúrate de que el usuario tenga permisos específicos para cada base de datos. En Syspanel, puedes asignar un usuario a varias bases de datos.

¿Qué hago si el servidor de base de datos no es "localhost"?

Si tu hosting usa un servidor de base de datos remoto (por ejemplo, un servicio como Amazon RDS), en _DB_SERVER_ debes poner la dirección IP o el nombre del servidor, no "localhost". Consulta con tu proveedor de hosting.

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

Los síntomas incluyen errores como "Table 'ps_product' doesn't exist" o páginas en blanco. Puedes verificar la integridad desde Syspanel usando la opción Reparar en la base de datos.

¿Es seguro modificar el archivo settings.inc.php?

Sí, siempre que tengas cuidado de no borrar otras líneas. Haz una copia de seguridad antes de editarlo y usa un editor de texto sin formato (como Notepad++ o el editor de Syspanel).

Conclusión

Solucionar el error conexión PrestaShop Syspanel puede parecer complicado al principio, pero siguiendo estos pasos podrás resolverlo en la mayoría de los casos. Recuerda siempre:

Verificar los datos de conexión en settings.inc.php.
Comprobar que la base de datos y el usuario existan en Syspanel.
Probar la conexión manualmente con un script PHP.
Reparar o restaurar la base de datos si es necesario.

Si después de todo esto el problema persiste, no dudes en contactar al soporte técnico de tu hosting. Ellos pueden revisar los logs del servidor y ayudarte con problemas más complejos.

[INFO] Guarda esta guía en tus favoritos para futuras referencias. Los errores de conexión pueden repetirse, y tener los pasos a mano te ahorrará tiempo y estrés.

¡Esperamos que tu tienda PrestaShop vuelva a funcionar sin problemas!