Error de conexión base de datos PrestaShop en DirectAdmin | Solución

¡Hola! Soy el soporte técnico de confianza. Si estás viendo un mensaje de error de conexión a base de datos en tu tienda PrestaShop alojada en un servidor con DirectAdmin, no te preocupes. Es uno de los problemas más comunes y, por lo general, tiene una solución sencilla. En esta guía extensa y paso a paso, te explicaré cómo diagnosticar y solucionar el error base de datos PrestaShop cuando trabajas con DirectAdmin PrestaShop. Al final, tendrás tu tienda funcionando de nuevo.

Este artículo está pensado para que cualquier persona, incluso sin conocimientos técnicos profundos, pueda seguirlo. Vamos a ello.

¿Qué significa este error y por qué ocurre?

Cuando ves un mensaje como "Error de conexión a la base de datos" o "No se puede conectar a la base de datos" en PrestaShop, significa que tu tienda no puede comunicarse con el servidor de bases de datos (normalmente MySQL o MariaDB). Es como si intentaras llamar a alguien, pero el teléfono estuviera desconectado. Sin esa conexión, PrestaShop no puede cargar productos, clientes, pedidos ni nada.

Las causas más habituales en un entorno DirectAdmin PrestaShop son:

Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos en el archivo de configuración de PrestaShop (app/config/parameters.php) no coinciden con los que realmente existen en DirectAdmin.
Base de datos o usuario eliminados: Alguien pudo haber borrado la base de datos o el usuario asociado desde el panel de control.
Servidor de bases de datos caído o sobrecargado: El servicio MySQL/MariaDB puede estar detenido o tener problemas de rendimiento.
Permisos incorrectos: El usuario de la base de datos puede no tener los permisos necesarios (SELECT, INSERT, UPDATE, DELETE) sobre la base de datos.
Archivo de configuración corrupto: El archivo parameters.php puede estar dañado o tener errores de sintaxis.
Cambio de servidor o migración: Si has movido tu tienda a otro servidor o has cambiado de hosting, es muy probable que las credenciales hayan cambiado.

Paso 1: Identificar el error exacto

Antes de lanzarnos a hacer cambios, es importante saber qué tipo de error estamos viendo. PrestaShop suele mostrar varios mensajes. Fíjate bien:

"Error de conexión a la base de datos" (genérico): Lo más probable es que sea un problema de credenciales o de servicio.
"Link to database cannot be established": Muy similar al anterior.
"Table 'xxxx' doesn't exist": Puede que la base de datos esté corrupta o que falten tablas (por ejemplo, tras una mala migración).
"Access denied for user 'xxxx'@'localhost'": Indica que el usuario o la contraseña son incorrectos, o que el usuario no tiene permiso para conectarse desde esa dirección IP.

[INFO] Si el error es muy grave y no puedes acceder ni al back office ni al front office, tendrás que solucionarlo a través del panel de control de DirectAdmin o mediante FTP.

Paso 2: Acceder a DirectAdmin y verificar el estado del servicio

Lo primero es comprobar que el servicio de base de datos (MySQL/MariaDB) está funcionando. En DirectAdmin PrestaShop, haz lo siguiente:

Inicia sesión en tu panel de DirectAdmin.
Busca la sección "Administración de servicios" o "Servicios del sistema". Puede estar en un menú llamado "Extra Features" o "Account Manager".
Verás una lista de servicios. Busca "mysqld" o "mariadb". Debería aparecer con un icono verde y el estado "Running" (en ejecución).
Si está en rojo o "Stopped", haz clic en el botón "Start" o "Restart" para reiniciarlo.

[WARNING] Si no encuentras la opción de administrar servicios, es posible que tu plan de hosting no te permita hacerlo. En ese caso, contacta con tu proveedor de hosting y pídeles que verifiquen que MySQL esté activo.

Paso 3: Verificar las credenciales en DirectAdmin

Este es el paso más común y donde suele estar el fallo. Vamos a comprobar que los datos de la base de datos y el usuario sean correctos.

En tu panel de DirectAdmin, ve a la sección "MySQL Management" (o "Administración de MySQL").
Verás una lista de tus bases de datos. Busca la que utiliza tu PrestaShop. Normalmente se llama algo como usuario_nombrebasededatos.
Haz clic en el icono de "Manage" (Administrar) al lado de tu base de datos.
Se abrirá una ventana (phpMyAdmin) o una página de gestión. Aquí podrás ver:
- Nombre de la base de datos: Anótalo exactamente (respeta mayúsculas y minúsculas).
- Nombre de usuario: Debería aparecer asociado a la base de datos. Anótalo.
- Contraseña: Si no la recuerdas, puedes cambiarla desde aquí. Importante: Al cambiar la contraseña, también deberás actualizarla en el archivo de configuración de PrestaShop.
Si no ves la base de datos o el usuario, es posible que hayan sido eliminados. En ese caso, tendrás que crearlos de nuevo (te explico cómo más adelante).

Paso 4: Localizar y editar el archivo de configuración de PrestaShop

El archivo que contiene las credenciales de la base de datos es app/config/parameters.php. Necesitas acceder a él a través de FTP o del administrador de archivos de DirectAdmin.

Opción A: Usando el Administrador de Archivos de DirectAdmin

En DirectAdmin, ve a la sección "File Manager" (Administrador de Archivos).
Navega hasta la carpeta raíz de tu tienda PrestaShop (normalmente public_html o domains/tudominio.com/public_html).
Abre la carpeta app y luego la carpeta config.
Busca el archivo parameters.php. Haz clic derecho sobre él y selecciona "Edit" (Editar).

Opción B: Usando FTP

Conéctate a tu servidor mediante un cliente FTP (como FileZilla).
Navega hasta la raíz de tu tienda (ej. /public_html).
Ve a app/config/ y descarga el archivo parameters.php a tu ordenador.
Ábrelo con un editor de texto plano (como Bloc de Notas o Sublime Text). No uses Word ni procesadores de texto.

¿Qué buscar y cómo editarlo?

El archivo parameters.php contiene una estructura PHP. Busca las líneas que empiezan por 'database_host', 'database_name', 'database_user' y 'database_password'. Debe verse algo así:

'database_host' => 'localhost',
'database_name' => 'tu_usuario_tu_bd',
'database_user' => 'tu_usuario_tu_bd',
'database_password' => 'tu_contraseña',
'database_prefix' => 'ps_',

database_host: Normalmente es localhost. Si tu base de datos está en otro servidor, aquí iría la IP o el nombre del host.
database_name: Debe coincidir exactamente con el nombre que viste en DirectAdmin.
database_user: Debe coincidir exactamente con el usuario que viste en DirectAdmin.
database_password: Debe ser la contraseña actual de ese usuario.

[TIP] Si has cambiado la contraseña en DirectAdmin, este es el momento de actualizarla aquí. Guarda el archivo y súbelo de nuevo si lo descargaste.

Si no encuentras el archivo o está vacío

Si el archivo parameters.php no existe o está vacío, o si ves errores de sintaxis, es posible que PrestaShop no pueda instalarse correctamente. En ese caso, la solución conexión base datos puede ser más drástica: restaurar una copia de seguridad o reinstalar. Pero antes, prueba a crear el archivo manualmente con el contenido básico (pide ayuda a tu hosting si no sabes cómo).

Paso 5: Probar la conexión manualmente

Para asegurarte de que las credenciales son correctas, puedes probar la conexión desde la propia herramienta de administración de bases de datos de DirectAdmin (phpMyAdmin).

En DirectAdmin, en la sección "MySQL Management", haz clic en "phpMyAdmin".
Se abrirá una nueva pestaña. En la pantalla de inicio de sesión, introduce el nombre de usuario y la contraseña que has anotado.
Si la conexión es exitosa, verás el panel de phpMyAdmin con la lista de bases de datos a las que ese usuario tiene acceso.
Si ves un error como "Access denied", significa que las credenciales son incorrectas. Vuelve al paso 3 y verifica o restablece la contraseña.

Paso 6: Solucionar problemas comunes (FAQ)

Aquí tienes las preguntas más frecuentes que resuelvo en el soporte:

¿Qué hago si el error persiste después de verificar las credenciales?

Prueba a reparar la base de datos desde phpMyAdmin. Selecciona tu base de datos, marca todas las tablas y en el menú desplegable elige "Reparar tabla". Esto puede solucionar corrupciones menores.

¿Y si el problema es que la base de datos se ha llenado?

En DirectAdmin, ve a "MySQL Management" y verifica el tamaño de tu base de datos. Si está cerca del límite, necesitarás liberar espacio (eliminar registros antiguos, logs, etc.) o contratar un plan con más capacidad.

¿Puedo cambiar el prefijo de las tablas?

Sí, pero no es recomendable si no sabes lo que haces. El prefijo se define en el archivo parameters.php como 'database_prefix'. Si lo cambias, PrestaShop dejará de encontrar las tablas, así que solo hazlo si estás seguro.

Mi tienda se ha migrado a otro servidor y ahora da error. ¿Qué hago?

Este es el caso más típico. Después de una migración, el archivo parameters.php suele contener las credenciales del servidor antiguo. Debes actualizarlo con las nuevas credenciales del servidor actual (paso 4). Además, asegúrate de que la base de datos se haya importado correctamente.

[WARNING] Si has migrado usando un plugin o manualmente, verifica que la codificación de la base de datos sea UTF-8, ya que PrestaShop la requiere. También comprueba que la versión de MySQL sea compatible con tu versión de PrestaShop.

¿Y si el error es "Table 'xxxx' doesn't exist"?

Esto indica que faltan tablas en la base de datos. Puede deberse a una migración incompleta o a una corrupción. La solución es restaurar una copia de seguridad completa de la base de datos desde phpMyAdmin (importar un archivo .sql). Si no tienes copia, tendrás que reinstalar PrestaShop, pero perderás los datos.

Paso 7: Medidas preventivas y buenas prácticas

Para evitar futuros sustos, te recomiendo:

Realiza copias de seguridad periódicas: DirectAdmin suele tener una herramienta de backup. Actívala para que se hagan copias automáticas de tu web y base de datos.
No compartas contraseñas: Usa contraseñas seguras y no las compartas con terceros.
Actualiza PrestaShop y sus módulos: Las versiones antiguas pueden tener fallos de seguridad que corrompan la base de datos.
Monitorea el estado de tu servidor: Si el error es recurrente, puede que tu hosting tenga problemas de recursos. Contacta con tu proveedor.

Conclusión

El error base de datos PrestaShop en un entorno DirectAdmin PrestaShop no es el fin del mundo. Siguiendo esta guía paso a paso, podrás diagnosticar y solucionar la mayoría de los casos. Recuerda que la clave está en verificar las credenciales, el estado del servicio y el archivo de configuración. Si aun así no lo consigues, no dudes en pedir ayuda a tu proveedor de hosting o a un profesional. ¡Tu tienda volverá a estar online en poco tiempo!

[INFO] Si después de todo esto sigues sin poder acceder, puede que el problema sea más complejo (como un error en el núcleo de PrestaShop). En ese caso, activa el modo depuración de PrestaShop (editando el archivo defines.inc.php en la carpeta /config y cambiando _PS_MODE_DEV_ a true) para obtener más detalles del error. Pero eso ya es para otro artículo.

Espero que esta guía te haya sido de gran ayuda. ¡Mucho ánimo y a seguir vendiendo!