Errores comunes al migrar bases de datos en PrestaShop y cómo solucionarlos

Migrar una tienda online a un nuevo servidor o a un nuevo hosting puede parecer una tarea titánica, especialmente si tu negocio depende de ella. Sin embargo, uno de los pasos más críticos y donde suelen surgir la mayoría de los problemas es en la migración de la base de datos.

En este artículo, te guiaré a través de los errores más comunes al realizar una migrar base de datos PrestaShop y, lo más importante, cómo solucionarlos paso a paso. Tanto si eres un usuario novato como si tienes algo de experiencia, esta guía te ayudará a evitar dolores de cabeza y a mantener tu tienda funcionando sin problemas.

---

Error #1: No hacer una copia de seguridad completa antes de empezar

Este es, sin duda, el error más grave y el que más se repite. Muchos usuarios se lanzan a la migración confiando en que todo irá bien, pero un pequeño fallo en la conexión o un archivo corrupto puede dejarte sin tienda.

¿Por qué ocurre?

La prisa o la confianza excesiva. A veces se piensa que “solo es mover unos archivos” y se omite este paso vital.

¿Cómo solucionarlo?

La regla de oro es: siempre, siempre, haz una copia de seguridad completa. Esto incluye:

• La base de datos completa (tablas, datos, configuraciones).
• Los archivos del sistema (carpeta admin, modules, themes, img, etc.).

Pasos para una copia de seguridad segura:

1. Accede a tu panel de control de hosting (por ejemplo, cPanel, Syspanel, o Plesk).
   • Si usas Syspanel (HestiaCP): Recuerda que el puerto de acceso es el 2106 (ejemplo: tudominio.com:2106).
2. Busca la sección de Bases de Datos o phpMyAdmin.
3. Selecciona tu base de datos de PrestaShop.
4. Ve a la pestaña Exportar y elige el método Rápido (o Personalizado si quieres seleccionar tablas específicas).
5. Guarda el archivo .sql en tu ordenador. No lo subas aún al nuevo servidor.

[WARNING] No confíes únicamente en las copias automáticas del hosting. Haz una manual justo antes de la migración.

---

Error #2: No verificar la compatibilidad de versiones de MySQL/MariaDB

PrestaShop es muy sensible a la versión del motor de base de datos. Si tu servidor antiguo usa MySQL 5.6 y el nuevo usa MySQL 8.0 (o viceversa), puedes encontrar errores de sintaxis o funciones obsoletas.

¿Por qué ocurre?

Los proveedores de hosting actualizan sus servidores, y a veces no avisan de los cambios de versión. O simplemente no revisas los requisitos de PrestaShop.

¿Cómo solucionarlo?

1. Verifica la versión actual: En tu PrestaShop, ve a Parámetros de la tienda > Información y busca la línea “Versión del servidor MySQL”.
2. Verifica la versión destino: Pregunta a tu nuevo hosting o mira en el panel de control (Syspanel, cPanel, etc.) qué versión de MySQL/MariaDB ofrecen.
3. Comprueba la compatibilidad:
   • PrestaShop 1.6: Funciona bien con MySQL 5.6 y 5.7. Con MySQL 8.0 puede dar problemas de sintaxis (ej. GROUP BY).
   • PrestaShop 1.7 y 8.x: Son compatibles con MySQL 5.7 y 8.0, pero a veces requieren ajustes en el archivo parameters.php.
4. Solución rápida: Si hay incompatibilidad, pide a tu hosting que te asigne una versión específica de MySQL (muchos lo permiten). Si no es posible, tendrás que editar la base de datos exportada para eliminar o modificar las consultas problemáticas.

[TIP] Si usas Syspanel, puedes cambiar la versión de MySQL desde el apartado “Base de datos” > “Cambiar versión”. Es muy sencillo.

---

Error #3: No actualizar las URLs en la base de datos después de la migración

Este es uno de los errores más comunes y frustrantes. Migras todo, pero al abrir la tienda ves imágenes rotas, enlaces que apuntan al dominio antiguo o un error 404 general.

¿Por qué ocurre?

PrestaShop guarda las URLs absolutas (con el dominio antiguo) en muchas tablas de la base de datos. Al cambiar de dominio o de carpeta, esas URLs quedan obsoletas.

¿Cómo solucionarlo?

Debes buscar y reemplazar todas las referencias al dominio antiguo por el nuevo. No uses un editor de texto normal porque puede dañar datos serializados (como los de módulos o configuraciones).

Pasos para una migración limpia de URLs:

1. Exporta la base de datos del servidor antiguo (como vimos en el error #1).
2. Usa una herramienta especializada: El mejor aliado es Search Replace DB (de Interconnect IT). Es un script PHP gratuito y seguro.
   • Súbelo a la raíz de tu nuevo servidor.
   • Ejecútalo desde el navegador.
   • Introduce los datos de conexión de tu nueva base de datos.
   • En “Buscar” escribe: http://tudominioantiguo.com
   • En “Reemplazar” escribe: http://tudominionuevo.com
   • Importante: Marca la opción “Reemplazar todas las URLs” y asegúrate de que no reemplaza nada en el campo id_shop o id_shop_group (aunque suele ser seguro).
3. Alternativa manual (solo para expertos): Si no quieres usar scripts, puedes conectarte a la base de datos con phpMyAdmin y ejecutar consultas SQL como:

   UPDATE ps_configuration SET value = REPLACE(value, 'tudominioantiguo.com', 'tudominionuevo.com') WHERE name = 'PS_SHOP_DOMAIN' OR name = 'PS_SHOP_DOMAIN_SSL';
   

   Pero esto solo cambia la configuración principal, no las URLs dentro de productos, categorías, imágenes, etc.

[WARNING] Si usas PrestaShop 1.7 o superior, también debes buscar y reemplazar https:// si usabas SSL. Hazlo en dos pasos: primero http:// y luego https:// para evitar duplicados.

---

Error #4: Olvidar la configuración del archivo parameters.php o settings.inc.php

Después de migrar los archivos y la base de datos, PrestaShop necesita saber cómo conectarse a la nueva base de datos. Si este archivo no se actualiza, la tienda no cargará.

¿Por qué ocurre?

Es fácil olvidar que la conexión a la base de datos se define en un archivo de configuración, no en la propia base de datos.

¿Cómo solucionarlo?

1. Localiza el archivo correcto:
   • PrestaShop 1.6 y anteriores: config/settings.inc.php
   • PrestaShop 1.7 y 8.x: app/config/parameters.php
2. Edítalo con un editor de texto plano (como Notepad++ o Sublime Text). No uses Word ni bloc de notas básico porque pueden añadir caracteres extraños.
3. Actualiza los siguientes parámetros:
   • database_host: Normalmente localhost, pero a veces tu hosting te dará una IP o un nombre de servidor (ej. mysql.tudominio.com).
   • database_name: El nombre de la nueva base de datos que creaste en el nuevo servidor.
   • database_user: El usuario de la nueva base de datos.
   • database_password: La contraseña de ese usuario.
4. Guarda los cambios y sube el archivo a la misma ubicación en el nuevo servidor.

[TIP] Si usas Syspanel, ve a “Base de datos” > “Añadir base de datos”. Allí crearás la base, el usuario y la contraseña. Luego solo copias esos datos al archivo parameters.php.

---

Error #5: Ignorar los problemas de codificación de caracteres (UTF-8)

Después de la migración, ves caracteres extraños como “ñ” o “¿” en lugar de las tildes y la letra “ñ”. Esto es un clásico.

¿Por qué ocurre?

La base de datos exportada puede tener una codificación diferente a la del nuevo servidor. Lo más común es que el antiguo usara latin1_swedish_ci y el nuevo use utf8_general_ci o utf8mb4_general_ci.

¿Cómo solucionarlo?

1. Antes de importar: Abre el archivo .sql con un editor de texto (como Notepad++).
2. Busca y reemplaza: Al principio del archivo suele haber líneas como SET NAMES 'latin1' o DEFAULT CHARSET=latin1. Cámbialas por utf8 o utf8mb4.
   • Ejemplo: DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci;
3. Importa la base de datos en el nuevo servidor.
4. Verifica: Si ya importaste y ves caracteres extraños, puedes ejecutar una consulta SQL en phpMyAdmin sobre la base de datos ya importada:

   ALTER DATABASE tu_nueva_base CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
   

   Luego, para cada tabla, puedes usar phpMyAdmin para cambiar el cotejamiento (collation) de forma masiva.

[INFO] La codificación utf8mb4 es la recomendada hoy en día porque soporta emojis y caracteres especiales. PrestaShop 1.7 y 8.x la usan por defecto.

---

Error #6: No ajustar los límites de memoria y tiempo de ejecución

Si tu base de datos es grande (más de 50 MB), la importación puede fallar por límites de tiempo o memoria en el servidor.

¿Por qué ocurre?

Los hostings compartidos suelen tener límites de ejecución de scripts (por ejemplo, 30 segundos) y de memoria (por ejemplo, 128 MB). Una importación de una base de datos de 200 MB puede tardar varios minutos.

¿Cómo solucionarlo?

1. Divide el archivo SQL: Usa herramientas como BigDump o MySQL Splitter para dividir tu archivo .sql en partes más pequeñas (por ejemplo, de 20 MB cada una).
2. Importa por partes: Sube cada parte a través de phpMyAdmin o de la línea de comandos (si tienes acceso SSH).
3. Aumenta los límites temporalmente:
   • Si tienes acceso a un panel como Syspanel, busca la opción “PHP Settings” o “Configuración de PHP” y aumenta max_execution_time a 300 (5 minutos) y memory_limit a 256M.
   • Si no tienes acceso, contacta con el soporte de tu hosting y pídeles que hagan el ajuste para la migración.

[TIP] Si usas Syspanel, puedes editar el archivo php.ini desde el panel de administración (puerto 2106). Busca “PHP” y luego “Editor de configuración”.

---

Error #7: No regenerar el índice de búsqueda y las URLs amigables

Después de la migración, es posible que la búsqueda interna de tu tienda no funcione o que las URLs amigables (SEO) no se generen correctamente.

¿Por qué ocurre?

Los índices de búsqueda y las reglas de reescritura de URLs se almacenan en la base de datos y pueden quedar desactualizados o corruptos tras el movimiento.

¿Cómo solucionarlo?

1. Regenera el índice de búsqueda:
   • Ve a Parámetros de la tienda > Búsqueda.
   • Haz clic en “Añadir un índice” o “Regenerar índice”. Espera a que termine.
2. Regenera las URLs amigables:
   • Ve a Parámetros de la tienda > Tráfico y SEO.
   • En la pestaña “SEO y URL”, asegúrate de que la opción “URLs amigables” esté activada.
   • Si ya lo está, desactívala, guarda, actívala de nuevo y guarda. Esto fuerza la regeneración.
3. Limpia la caché de PrestaShop:
   • Ve a Parámetros avanzados > Rendimiento.
   • Haz clic en “Limpiar caché” (tanto la de Smarty como la de Symfony).

---

Error #8: No probar la tienda en un entorno de staging (pruebas)

Migrar directamente a producción sin probar antes es como lanzarse al vacío sin paracaídas. Puede que todo funcione, pero si hay un error, los clientes lo sufrirán.

¿Por qué ocurre?

Por falta de tiempo o por no saber cómo crear un entorno de pruebas.

¿Cómo solucionarlo?

1. Crea un subdominio o una carpeta de pruebas en tu nuevo servidor (ej. pruebas.tudominio.com).
2. Realiza la migración completa (archivos, base de datos, configuración) en ese entorno.
3. Prueba todo:
   • Página de inicio y categorías.
   • Proceso de compra (añadir al carrito, registro, pago).
   • Módulos de terceros.
   • Panel de administración.
4. Corrige los errores que encuentres.
5. Una vez que todo funcione perfecto, repite la migración en el entorno de producción.

[WARNING] No uses el mismo dominio para las pruebas y la producción. Si lo haces, los motores de búsqueda indexarán la versión de pruebas y tendrás problemas de SEO.

---

Preguntas Frecuentes (FAQ) sobre la migración de bases de datos en PrestaShop

¿Puedo migrar la base de datos sin usar phpMyAdmin?

Sí, puedes usar la línea de comandos (SSH) si tu hosting lo permite. El comando típico es:

mysql -u usuario -p nombre_base < archivo.sql

Esto es más rápido y evita los límites de tiempo de phpMyAdmin.

¿Qué hago si después de la migración veo el error “Tabla ‘ps_product’ no existe”?

Esto suele ocurrir si la importación se interrumpió a mitad. Vuelve a importar la base de datos completa o, si usaste una herramienta de división, asegúrate de importar todas las partes.

¿Es necesario cambiar el prefijo de las tablas (ps_)?

No, no es necesario. El prefijo es solo una convención. Si lo cambias, tendrás que editar el archivo parameters.php para reflejar el nuevo prefijo.

¿Puedo migrar solo la base de datos y no los archivos?

Técnicamente sí, pero no es recomendable. Los archivos (módulos, temas, imágenes) también contienen rutas y configuraciones. Si solo mueves la base de datos, las imágenes se romperán y los módulos pueden fallar.

¿Cómo sé si mi migración de base de datos fue exitosa?

1. Abre tu tienda en el nuevo dominio.
2. Revisa que no haya errores 500 o pantallas en blanco.
3. Prueba a hacer login en el panel de administración.
4. Comprueba que las imágenes de los productos se carguen.
5. Realiza una compra de prueba (con un producto de 0€ o en modo mantenimiento).

---

Conclusión

La migrar base de datos PrestaShop no tiene por qué ser una pesadilla si sigues estos pasos. Recuerda siempre:

• Haz copias de seguridad.
• Verifica la compatibilidad de versiones.
• Actualiza todas las URLs.
• Configura correctamente la conexión.
• Prueba en un entorno de staging.

Si te encuentras con un error PrestaShop base de datos, no entres en pánico. Vuelve a leer esta guía, identifica el error y aplica la solución correspondiente. Con un poco de paciencia y método, tu tienda estará funcionando en su nuevo hogar en menos de lo que imaginas.

¿T