Problemas conexión PrestaShop Syspanel | Soluciones

¿Tu tienda PrestaShop de repente dejó de cargar, muestra mensajes de error extraños o simplemente no se conecta a la base de datos? No te preocupes, es una situación más común de lo que parece y, por suerte, la mayoría de estos problemas tienen una solución clara y sencilla.

En esta guía completa, te explicaré paso a paso cómo diagnosticar y resolver los problemas de conexión PrestaShop Syspanel más habituales. Syspanel es el panel de control que utilizamos para gestionar tu servidor (basado en HestiaCP, con acceso por el puerto 2106). Aquí aprenderás a identificar el origen del fallo y aplicar la solución adecuada para que tu tienda vuelva a funcionar en minutos.

¿Por qué ocurren los errores de conexión en PrestaShop?

Los errores de conexión pueden deberse a múltiples factores, desde un simple cambio de contraseña hasta un problema de configuración del servidor. Los más comunes son:

Credenciales incorrectas en el archivo parameters.php o settings.inc.php.
El servidor de base de datos (MySQL/MariaDB) no responde o está caído.
El nombre del host de la base de datos no es el correcto (por ejemplo, usar localhost cuando debería ser una IP o un socket).
Firewall o permisos bloqueando la conexión desde PrestaShop al servidor de BD.
Archivos de configuración corruptos o con errores de sintaxis.
Problemas de caché o sesión tras una migración o cambio de servidor.

Vamos a solucionarlos uno por uno.

Paso 1: Accede a Syspanel (tu panel de control)

Lo primero es entrar a Syspanel para revisar el estado del servidor y acceder a las herramientas de gestión.

[INFO] Recuerda: Syspanel es el nombre de nuestro panel basado en HestiaCP. Siempre se accede por el puerto 2106. Por ejemplo: https://tudominio.com:2106 o https://tuip:2106.

Abre tu navegador y escribe la URL de acceso con el puerto 2106.
Inicia sesión con tus credenciales de administrador (usuario y contraseña que te proporcionamos).
Una vez dentro, busca la sección "Base de datos" o "DB" en el menú lateral.

Aquí verás todas las bases de datos asociadas a tu cuenta. Localiza la que usa tu PrestaShop (suele tener un nombre como usuario_prestashop).

Paso 2: Verifica el estado del servicio de base de datos

Un error típico de conexión PrestaShop Syspanel es que el servicio MySQL/MariaDB esté detenido. Para comprobarlo:

En Syspanel, ve a "Servicios" o "Service Status".
Busca MySQL o MariaDB.
Verás un indicador verde (activo) o rojo (detenido).

Si está rojo:

Haz clic en el botón "Reiniciar" o "Start".
Espera unos segundos y vuelve a cargar tu tienda PrestaShop.
Si no se inicia, puede haber un error de configuración más profundo. En ese caso, contacta con soporte técnico.

[TIP] Si el servicio se cae repetidamente, puede deberse a falta de memoria RAM o a un pico de conexiones. Revisa los logs del servidor en Syspanel > "Logs" > "MySQL error log".

Paso 3: Revisa y corrige las credenciales en PrestaShop

El archivo donde PrestaShop guarda los datos de conexión a la base de datos es app/config/parameters.php (en PrestaShop 1.7 y 8) o config/settings.inc.php (en PrestaShop 1.6). Un error común es que estos datos se hayan modificado accidentalmente.

Cómo acceder al archivo:

Conéctate a tu servidor vía FTP o mediante el administrador de archivos de Syspanel (sección "File Manager").
Navega hasta la carpeta raíz de tu tienda (normalmente public_html o web).
Busca el archivo parameters.php o settings.inc.php.

Qué revisar:

Abre el archivo con un editor de texto (nunca con Word o bloc de notas de Windows, usa un editor como Notepad++ o el editor integrado de Syspanel).

Busca las siguientes líneas (en parameters.php):

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Verifica que coincidan exactamente con los datos que ves en Syspanel:

database_host: Normalmente es localhost. Pero si tu servidor usa conexión remota o un socket, podría ser una IP o un nombre como 127.0.0.1 o mysql.tudominio.com.
database_port: Por defecto es 3306. Si lo cambiaste, debe coincidir.
database_name, database_user, database_password: Deben ser idénticos a los que aparecen en la sección "Base de datos" de Syspanel.

Si encuentras diferencias, corrígelas y guarda el archivo.

[WARNING] Nunca uses comillas dobles dentro de los valores si no es necesario. Asegúrate de que las comillas simples estén bien cerradas. Un solo carácter mal escrito puede romper toda la conexión.

Paso 4: Prueba la conexión desde la terminal (si tienes acceso SSH)

Si tienes acceso SSH, puedes hacer una prueba directa para confirmar que el problema no es de red o de permisos.

Conéctate por SSH a tu servidor.
Ejecuta el siguiente comando (reemplaza usuario y basedatos por los tuyos):

mysql -u usuario -p -h localhost basedatos

Te pedirá la contraseña. Escríbela y presiona Enter.

Si ves el prompt de MySQL (mysql>), la conexión funciona correctamente. El problema está en PrestaShop (archivo de configuración, caché, etc.).

Si recibes un error como:

ERROR 2002 (HY000): Can't connect to local MySQL server through socket → El servicio MySQL no está corriendo o el socket está mal configurado.
ERROR 1045 (28000): Access denied for user → Usuario o contraseña incorrectos.
ERROR 1049 (42000): Unknown database → El nombre de la base de datos no existe.

En estos casos, vuelve a Syspanel y verifica los datos en la sección de bases de datos.

Paso 5: Limpia la caché de PrestaShop

A veces, aunque los datos sean correctos, PrestaShop guarda en caché una configuración antigua. Limpiarla puede resolver el problema de errores conexión PrestaShop de inmediato.

Desde el back office (si puedes acceder):

Ve a Parámetros avanzados > Rendimiento.
Haz clic en "Limpiar caché" (tanto la de Smarty como la de Symfony).

Si no puedes acceder al back office, hazlo manualmente:

Conéctate por FTP o al administrador de archivos de Syspanel.
Elimina el contenido de las carpetas:
- /var/cache/ (todo su interior)
- /app/cache/ (en PrestaShop 1.6)
- /cache/smarty/compile/ (opcional)
También puedes renombrar el archivo .htaccess a .htaccess_old y luego regenerarlo desde el back office (cuando recuperes el acceso).

[INFO] Si no ves mejoría, prueba a desactivar temporalmente la caché de opcode (como OPcache) desde Syspanel > "PHP Settings" > desmarca "OPcache" y guarda. Luego vuelve a probar.

Paso 6: Revisa los logs de error de PrestaShop

Los logs te darán pistas muy precisas sobre el origen del fallo.

En Syspanel, ve a "Logs" > "Error log" o directamente al archivo /var/log/apache2/error.log (si usas Apache) o /var/log/nginx/error.log (si usas Nginx).
Busca entradas que contengan palabras como PrestaShop, database, connection, PDO, MySQL.
También puedes revisar el log específico de PrestaShop en la carpeta /log/ dentro de la raíz de tu tienda (archivo YYYY-MM-DD.log).

Errores comunes que verás:

SQLSTATE[HY000] [2002] Connection refused → El servidor MySQL no acepta conexiones (revisa el servicio).
SQLSTATE[HY000] [1045] Access denied for user → Credenciales incorrectas.
SQLSTATE[42S02] Base table or view not found → La base de datos está corrupta o faltan tablas (puede necesitar restauración).

Paso 7: Verifica los permisos de archivos y carpetas

Un error de conexión a veces es síntoma de que PrestaShop no puede escribir archivos temporales. Comprueba que los permisos sean correctos:

Carpetas: 755
Archivos: 644
La carpeta config/ y cache/ deben ser escribibles por el servidor web (a veces requieren 777 temporalmente, pero no lo dejes así).

En Syspanel, puedes cambiar permisos desde el administrador de archivos: selecciona la carpeta raíz, haz clic derecho > "Permisos" y ajústalos.

[WARNING] No pongas permisos 777 en todos los archivos. Solo en carpetas específicas como cache/, log/, upload/ y img/ si es necesario, y luego reviértelos a 755.

Paso 8: Restaura la base de datos desde una copia de seguridad

Si después de todo lo anterior el error persiste, es posible que la base de datos esté dañada. Lo mejor es restaurar una copia de seguridad reciente.

En Syspanel, ve a "Backups" o "Backup".
Busca la copia de seguridad de tu base de datos (suelen tener extensión .sql.gz o .sql).
Descárgala o restáurala directamente desde el panel (hay un botón "Restore").
Si la restauras manualmente, usa la herramienta phpMyAdmin (accesible desde Syspanel > "Base de datos" > "phpMyAdmin") y ejecuta el script SQL.

[TIP] Siempre ten activas las copias de seguridad automáticas en Syspanel. Así, ante cualquier problema, puedes volver a un estado anterior sin perder datos críticos.

Preguntas frecuentes (FAQ) sobre conexión PrestaShop Syspanel

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

Es muy común. Al cambiar la contraseña en Syspanel, no se actualiza automáticamente en el archivo parameters.php de PrestaShop. Debes editarlo manualmente (Paso 3) o usar la herramienta de reparación que ofrece Syspanel (si está disponible).

¿Qué hago si el servicio MySQL está activo pero PrestaShop sigue sin conectar?

Prueba a cambiar database_host de localhost a 127.0.0.1 o viceversa. A veces la resolución del socket falla. También verifica que el puerto 3306 esté abierto en el firewall de Syspanel (sección "Firewall").

¿Puedo usar una conexión remota a la base de datos desde PrestaShop?

Sí, pero no es recomendable por seguridad y rendimiento. Si lo haces, asegúrate de que en Syspanel hayas añadido la IP de tu servidor web a los hosts permitidos en la base de datos (sección "Base de datos" > "Añadir host").

¿Qué significa "SQLSTATE[HY000] [2002] Connection timed out"?

Significa que PrestaShop intentó conectarse a MySQL pero no recibió respuesta en el tiempo esperado. Suele deberse a que el servicio está muy sobrecargado o caído. Revisa el estado en Syspanel y, si es necesario, aumenta el wait_timeout en la configuración de MySQL.

Después de migrar mi tienda a un nuevo servidor Syspanel, la conexión falla. ¿Qué debo revisar?

Lo primero: actualiza el archivo parameters.php con los nuevos datos de la base de datos (nombre, usuario, contraseña, host). Luego limpia la caché. Si el problema persiste, comprueba que la base de datos se haya importado correctamente y que el usuario tenga todos los privilegios (en Syspanel > "Base de datos" > "Editar usuario").

Resumen final

Los problemas de conexión PrestaShop Syspanel suelen resolverse siguiendo estos pasos en orden:

Accede a Syspanel (puerto 2106) y verifica que el servicio MySQL esté activo.
Revisa las credenciales en parameters.php o settings.inc.php.
Prueba la conexión manualmente desde SSH o phpMyAdmin.
Limpia la caché de PrestaShop.
Revisa los logs para obtener pistas precisas.
Ajusta permisos de archivos y carpetas.
Restaura una copia de seguridad si todo falla.

Si después de todo esto el error continúa, no dudes en contactar a nuestro equipo de soporte. Proporciona los logs de error y los pasos que ya has seguido, y te ayudaremos a solucionarlo rápidamente.

[INFO] Recuerda que mantener tu PrestaShop y Syspanel actualizados reduce drásticamente la probabilidad de errores de conexión. Activa las actualizaciones automáticas siempre que sea posible.

¡Esperamos que esta guía te haya sido de gran ayuda! Ahora ya sabes cómo enfrentarte a cualquier error de conexión PrestaShop con confianza y herramientas claras.