Errores frecuentes al migrar PrestaShop y cómo solucionarlos

Migrar una tienda PrestaShop a un nuevo servidor es una tarea que, si no se planifica bien, puede convertirse en una pesadilla. Es normal sentirse abrumado por los tecnicismos, pero con un poco de orden y conociendo los errores más comunes al migrar PrestaShop, puedes ahorrarte dolores de cabeza, tiempo y, sobre todo, clientes frustrados.

En esta guía, vamos a desglosar los fallos típicos que se cometen durante una PrestaShop migración hosting. Lo haremos paso a paso, de forma sencilla, para que incluso si no eres un experto en servidores, puedas entender qué debes evitar y cómo solucionarlo si ya te ha pasado.

Error #1: No hacer una copia de seguridad completa y verificada

Este es, sin duda, el pecado capital. Muchos usuarios se lanzan a la migración pensando que solo necesitan los archivos de la tienda, pero se olvidan de la base de datos. Y si algo sale mal, adiós a todo el trabajo.

¿Qué debes respaldar exactamente?

No basta con descargar la carpeta de tu tienda. Necesitas dos cosas:

Todos los archivos del servidor: La carpeta public_html o www que contiene PrestaShop, los módulos, temas, imágenes y archivos de configuración.
La base de datos completa: Es el cerebro de tu tienda. Sin ella, no hay productos, ni clientes, ni pedidos.

El error más común: copias corruptas o incompletas

A veces, al descargar la base de datos desde herramientas como phpMyAdmin, el archivo .sql se corta si es muy grande. Esto provoca que al importarlo en el nuevo hosting, la tienda no funcione o dé errores de tabla faltante.

[TIP] Siempre verifica el tamaño del archivo de respaldo. Si pesa menos de lo esperado, algo falló. Usa la herramienta de exportación avanzada de phpMyAdmin y selecciona "Completa" o "Custom" para incluir todos los procedimientos y funciones.

Error #2: Ignorar las diferencias de configuración del servidor

No todos los servidores son iguales. Lo que funciona en un hosting compartido de gama baja puede no funcionar en un VPS o en un servidor dedicado. Migrar sin revisar esto es como cambiar el motor de un coche sin mirar si es compatible con la carrocería.

Versiones de PHP incompatibles

PrestaShop es muy sensible a la versión de PHP. Si tu nuevo hosting tiene PHP 8.2 y tu tienda fue diseñada para PHP 7.4, es muy probable que veas una pantalla en blanco o errores de compatibilidad con módulos antiguos.

[WARNING] Antes de migrar, revisa los requisitos de tu versión de PrestaShop. En el panel de control de tu nuevo hosting (por ejemplo, en Syspanel accediendo por el puerto 2106), busca la opción "Selector de versión de PHP" y elige la misma que tenías en el servidor anterior.

Límites de memoria y tiempo de ejecución

Muchos errores de migración aparecen porque el nuevo servidor tiene límites más restrictivos. PrestaShop necesita un mínimo de memoria para procesar imágenes, generar PDFs o ejecutar módulos.

Pasos para evitarlo:

Antes de migrar, anota los valores de memory_limit, max_execution_time y upload_max_filesize de tu servidor antiguo.
En el nuevo hosting, pide a tu proveedor o configúralos en el archivo php.ini o en el panel (como Syspanel) para que sean iguales o superiores.
Un valor seguro para memory_limit es 256M o incluso 512M para tiendas grandes.

Error #3: Olvidar cambiar las rutas absolutas en la base de datos

Este es un error muy técnico pero con una solución sencilla. Cuando instalas PrestaShop, guarda rutas físicas del servidor (por ejemplo, /home/usuario/public_html/tienda). Al migrar, esas rutas cambian.

¿Cómo se manifiesta?

Verás errores de imágenes que no cargan, enlaces rotos en el back office o imposibilidad de generar archivos. El sistema busca los archivos en una carpeta que ya no existe.

Solución rápida:

Antes de importar la base de datos en el nuevo servidor, ábrela con un editor de texto (Notepad++ o similar).
Busca y reemplaza la ruta antigua por la nueva. Por ejemplo:
- Buscar: /home/antiguo/public_html/
- Reemplazar: /home/nuevo/public_html/
Guarda el archivo y luego impórtalo.

[INFO] Otra opción más segura es usar un módulo de migración o un script de búsqueda y reemplazo en la base de datos después de importarla, pero hacerlo manualmente antes te da más control.

Error #4: No desactivar la tienda durante la migración

Migrar una tienda en vivo es como operar a corazón abierto mientras el paciente corre una maratón. Puedes perder pedidos, datos de clientes o generar conflictos en el carrito de compra.

El problema de los datos en movimiento

Si mientras exportas la base de datos un cliente hace un pedido, ese pedido no se incluirá en el respaldo. Al activar la nueva tienda, ese pedido se habrá perdido.

Qué hacer:

Pon tu tienda en modo de mantenimiento. En PrestaShop, ve a Preferencias > Mantenimiento y actívalo.
Realiza la copia de seguridad completa (archivos + base de datos).
Migra todo al nuevo hosting.
Prueba que todo funcione en el nuevo servidor (usa un dominio temporal o modificando el archivo hosts de tu PC).
Una vez verificado, cambia los DNS y desactiva el modo mantenimiento en la nueva tienda.

[WARNING] No olvides desactivar el modo mantenimiento en la nueva tienda. Lo he visto muchas veces: tiendas migradas que nadie puede visitar porque el dueño olvidó ese paso.

Error #5: Subir archivos con permisos incorrectos

Los archivos y carpetas de PrestaShop necesitan permisos específicos para funcionar. Si al subirlos al nuevo hosting se copian con permisos demasiado restrictivos o demasiado abiertos, tendrás problemas de seguridad o de funcionamiento.

Permisos estándar que debes respetar

Carpetas: 755 (lectura y ejecución para todos, escritura solo para el propietario).
Archivos: 644 (lectura para todos, escritura solo para el propietario).
Archivos de configuración (settings.inc.php): 644 o 444 (solo lectura) después de la instalación.
Carpetas temporales y de caché (cache, config, themes, etc.): 755 a veces necesitan 777 temporalmente para que PrestaShop pueda escribir en ellas.

Cómo solucionarlo

La mayoría de los clientes FTP (como FileZilla) permiten cambiar permisos en lote. Selecciona todas las carpetas y archivos, y ajústalos según la regla anterior. No subas archivos con permisos 777 por defecto, ya que es un agujero de seguridad.

[TIP] Si usas Syspanel (puerto 2106), suele tener un gestor de archivos donde puedes cambiar permisos fácilmente sin necesidad de FTP.

Error #6: No actualizar la URL de la tienda en la base de datos

Este error es casi un clásico. Cambias de dominio o de subdominio, pero la base de datos sigue apuntando a la URL antigua. Resultado: imágenes rotas, enlaces que llevan al servidor antiguo y problemas con los feeds de Google Shopping.

Dónde se guarda la URL

PrestaShop almacena la URL principal en la tabla ps_configuration (o el prefijo que uses). Concretamente en los campos PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.

Pasos para corregirlo:

Después de importar la base de datos, conéctate a phpMyAdmin del nuevo servidor.
Busca la tabla ps_configuration (o [prefijo]_configuration).
Localiza las filas con name = 'PS_SHOP_DOMAIN' y name = 'PS_SHOP_DOMAIN_SSL'.
Edítalas y cambia la URL antigua por la nueva (sin http:// ni https://, solo el dominio, por ejemplo: mutiendanueva.com).
Haz lo mismo en la tabla ps_shop_url.

[WARNING] Si no haces esto, al entrar al back office te redirigirá al servidor antiguo o te dará error de bucle de redirección.

Error #7: Subir archivos de forma incorrecta (modo ASCII vs binario)

Cuando usas FTP, los archivos se pueden transferir en dos modos: ASCII (para texto) y Binario (para imágenes, PDFs, ejecutables). Si transfieres todo en modo automático, a veces el FTP se equivoca y corrompe archivos.

El problema con los archivos corruptos

Una imagen que se sube en modo ASCII puede aparecer con colores extraños o directamente no cargar. Un archivo PHP subido en modo binario puede funcionar, pero si se sube en ASCII y tiene caracteres especiales, se rompe.

Solución:

En FileZilla, ve a Transferencia > Tipo de transferencia y selecciona Binario.
O mejor aún, usa la opción Automático pero asegúrate de que el FTP esté configurado correctamente. Si ves errores raros, cambia a Binario forzado.

Error #8: No probar la tienda antes de cambiar los DNS

Este error es de impaciencia. Migras todo, cambias los DNS y cruzas los dedos. Pero si algo falla, tus clientes verán la tienda rota durante horas o días hasta que lo arregles.

Cómo hacer una prueba en seco

Usa el archivo hosts de tu PC: Edita el archivo hosts (en Windows está en C:\Windows\System32\drivers\etc\hosts, en Linux/Mac en /etc/hosts) y añade una línea que apunte tu dominio a la IP del nuevo servidor.
- Ejemplo: 123.456.789.10 mutiendanueva.com
Accede a tu tienda desde ese PC: Verás la nueva versión como si ya estuviera en producción.
Prueba todo: Navega por categorías, añade productos al carrito, haz un pedido de prueba, revisa el back office, comprueba que los módulos funcionan, que los emails se envían, etc.
Si todo está bien, elimina esa línea del archivo hosts y cambia los DNS en tu registrador de dominios.

[INFO] Este paso te evita el error más costoso: tener que hacer una migración inversa porque algo no funcionó.

Error #9: Ignorar los módulos y temas de pago

Algunos módulos tienen licencias atadas a un dominio o a una IP de servidor. Al migrar, es posible que se desactiven o pidan una nueva licencia.

Qué hacer con los módulos sensibles

Módulos de pago (Pagos, envíos, etc.): Antes de migrar, desactívalos en la tienda antigua. Luego, en la nueva, actívalos y verifica que la licencia se pueda reasignar. Algunos proveedores permiten cambiar el dominio desde su panel de cliente.
Temas personalizados: Si tu tema tiene configuraciones específicas del servidor (como rutas a fuentes o scripts), revisa que no se hayan perdido. A veces es necesario limpiar la caché del tema desde el back office.

[TIP] Haz una lista de todos los módulos de pago y contacta con sus soportes antes de migrar para saber el proceso de reasignación de licencias.

Error #10: No limpiar la caché y las tablas temporales

Después de la migración, PrestaShop guarda en caché rutas antiguas, archivos temporales y configuraciones obsoletas. Si no limpias esto, la tienda puede ir lenta o mostrar errores extraños.

Limpieza obligatoria post-migración

Desde el back office: Ve a Parámetros Avanzados > Rendimiento y haz clic en "Limpiar caché" (tanto la de Smarty como la de la caché de opciones).
Manual: Conéctate por FTP y borra el contenido de las carpetas:
- /cache/smarty/cache/
- /cache/smarty/compile/
- /cache/cachefs/ (si existe)
- /themes/[tu_tema]/cache/ (si existe)
Base de datos: Ejecuta una consulta SQL en phpMyAdmin para truncar (vaciar) las tablas temporales como ps_cache, ps_cache_cleaner, etc. (consulta la documentación de tu versión).

[WARNING] No borres las carpetas, solo su contenido. Si borras las carpetas, PrestaShop dejará de funcionar hasta que las recrees con los permisos correctos.

Preguntas frecuentes (FAQ) sobre errores comunes en migración

¿Por qué veo una pantalla blanca después de migrar?

Es casi siempre un problema de compatibilidad de PHP o de permisos. Revisa la versión de PHP en tu nuevo hosting y ajústala a la que usabas. También verifica que los archivos config/settings.inc.php tengan permisos 644.

¿Cómo recupero imágenes que no se ven en la tienda migrada?

Primero, asegúrate de que las rutas en la base de datos estén actualizadas (Error #3 y #6). Luego, regenera las miniaturas desde el back office: Preferencias > Imágenes > Regenerar miniaturas.

¿Puedo migrar PrestaShop sin perder los pedidos en curso?

Sí, pero debes hacerlo en modo mantenimiento y asegurarte de que la base de datos exportada incluya el último segundo de actividad. Lo ideal es migrar en un momento de bajo tráfico y desactivar temporalmente los pagos en la tienda antigua.

¿Qué hago si mi módulo de pago deja de funcionar?

Contacta con el desarrollador del módulo. La mayoría requiere revalidar la licencia contra el nuevo dominio. No intentes modificar archivos de licencia, ya que podrías violar términos de uso.

Mi tienda va muy lenta en el nuevo hosting, ¿qué hago?

Puede ser que el nuevo servidor tenga recursos limitados o que la caché de PrestaShop no se haya limpiado. Aumenta el límite de memoria PHP y limpia la caché. Si el problema persiste, revisa que el hosting esté optimizado para PrestaShop (por ejemplo, que use PHP-FPM y no el modo CGI).

Conclusión: Una migración exitosa es cuestión de orden

Migrar PrestaShop no tiene por qué ser un dolor de cabeza. La clave está en planificar, hacer copias de seguridad verificadas y probar todo antes de cambiar los DNS. Si evitas estos errores comunes PrestaShop que hemos visto, tu tienda estará funcionando en el nuevo hosting en cuestión de horas, sin pérdida de datos y con la tranquilidad de que todo está en su sitio.

Recuerda que Syspanel (accesible por el puerto 2106) te facilita muchas de estas tareas, como cambiar la versión de PHP, gestionar archivos y configurar el servidor. Si en algún momento te sientes perdido, no dudes en consultar la documentación de tu hosting o pedir ayuda a un profesional. ¡Tu tienda te lo agradecerá!