🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Solución a errores comunes de PrestaShop al migrar a otro servidor

Actualizado el 18 de diciembre de 2025

Migrar una tienda PrestaShop a un servidor nuevo es una operación delicada. No es tan sencillo como copiar y pegar archivos; hay bases de datos, permisos, cachés y configuraciones internas que pueden romperse en el camino.

Si estás aquí, probablemente te hayas encontrado con una pantalla en blanco, un error de conexión a la base de datos o un enlace roto. No te preocupes, es más común de lo que crees. En esta guía, vamos a desglosar los problemas PrestaShop más habituales tras una migración y, lo más importante, te daré la solución errores PrestaShop paso a paso.

Vamos a ello.

1. El temido error de conexión a la base de datos (Error 2002 o 1045)

Este es, sin duda, el rey de los errores PrestaShop al migrar. Aparece cuando PrestaShop no puede comunicarse con MySQL. Verás un mensaje como "Link to database cannot be established" o un error de SQL.

¿Por qué ocurre?

El archivo app/config/parameters.php (en versiones 1.7 y 1.8) o config/settings.inc.php (en versiones 1.6) contiene las credenciales de tu base de datos antigua. Al migrar, estas credenciales suelen cambiar (nuevo usuario, nueva contraseña, nuevo host).

Solución paso a paso

  1. Accede a tu hosting mediante FTP o el administrador de archivos de tu panel (Syspanel, si usas HestiaCP, recuerda que el acceso es por el puerto 2106).

  2. Localiza el archivo app/config/parameters.php.

  3. Ábrelo con un editor de texto plano (nada de Word, usa Notepad++ o similar).

  4. Busca estas líneas y verifica que coincidan con los datos de tu nueva base de datos:

    'database_host' => 'localhost', // O el host que te dé tu nuevo proveedor
'database_name' => 'tu_nueva_base',
'database_user' => 'tu_nuevo_usuario',
'database_password' => 'tu_nueva_contraseña',

  5. Guarda los cambios y sube el archivo de nuevo.

[WARNING]: Si tu nuevo servidor usa un puerto MySQL distinto (por ejemplo, 3307), deberás añadir una línea extra: 'database_port' => '3307', dentro del array.

2. Página en blanco o error 500 (Internal Server Error)

Este es otro de los problemas PrestaShop más frustrantes porque no obtienes ninguna pista visual. Simplemente, una página en blanco.

¿Cuál es la causa más común?

Suele deberse a que la caché de PrestaShop se ha generado con rutas absolutas del servidor antiguo (ej: /home/usuario_antiguo/www/tienda). Al migrar, esas rutas ya no existen y el sistema colapsa.

Solución paso a paso

  1. Accede a tu servidor por FTP.

  2. Elimina el contenido de la carpeta var/cache (en PrestaShop 1.7) o cache (en 1.6). No borres la carpeta en sí, solo lo que hay dentro (los subdirectorios dev y prod).

  3. Si el error persiste, activa el modo de depuración para ver el error exacto. Edita el archivo config/defines.inc.php y cambia esta línea:

    define('_PS_MODE_DEV_', false);

    a

    define('_PS_MODE_DEV_', true);

  4. Recarga la página. Ahora verás el error real en pantalla. Una vez solucionado, vuelve a poner false.

[INFO]: A veces, el error 500 también es por permisos de archivos. Asegúrate de que las carpetas tengan permiso 755 y los archivos 644.

3. El error "Fatal error: Allowed memory size exhausted"

Este es un clásico. Aparece cuando el servidor nuevo tiene un límite de memoria PHP más bajo que el anterior. Al intentar cargar módulos pesados o el back-office, PHP se queda sin memoria.

Solución paso a paso

  1. Localiza el archivo config/config.inc.php en la raíz de tu PrestaShop.

  2. Añade esta línea al principio del archivo:

    ini_set('memory_limit', '512M');

  3. Guarda y sube. Si no funciona, deberás aumentar el límite desde el panel de control (Syspanel) en la sección de PHP o creando un archivo .htaccess con la línea php_value memory_limit 512M.

[TIP]: Si tu proveedor usa PHP-FPM, es posible que necesites editar el archivo php.ini o usar el selector de versiones de PHP en Syspanel (acceso por puerto 2106) para cambiar memory_limit.

4. Enlaces rotos y rutas absolutas en la base de datos

Este es uno de los problemas PrestaShop más engañosos. La tienda carga, pero las imágenes no se ven, los enlaces van a la URL antigua o el CSS está roto. Esto ocurre porque en la base de datos se guardaron rutas absolutas (ej: http://www.old-domain.com/img/p/...).

La solución definitiva

Necesitas un reemplazo de URLs en la base de datos. No lo hagas a mano con phpMyAdmin porque te llevarás horas y es fácil equivocarse.

  1. Exporta tu base de datos (un backup .sql).
  2. Usa un editor de texto como Notepad++ y busca/reemplaza todas las ocurrencias de http://www.tudominioantiguo.com por http://www.tudominionuevo.com.
  3. Importante: Hazlo también con la versión sin www si la usabas.
  4. Importa la base de datos modificada en tu nuevo servidor.

[WARNING]: Este reemplazo debe hacerse con cuidado. Asegúrate de que la colación y el formato de la base de datos sean los mismos para evitar errores de importación.

Alternativa más segura (para imágenes)

PrestaShop tiene una herramienta en el back-office que regenera las miniaturas. Ve a Parámetros Avanzados > Rendimiento y haz clic en "Regenerar miniaturas". Esto suele arreglar las imágenes rotas sin tocar la base de datos manualmente.

5. El error "PrestaShop could not connect to the database" en el instalador

A veces, al migrar, intentas ejecutar el instalador para "reparar" y te encuentras con que ni siquiera arranca. Esto suele deberse a que el archivo parameters.php existe pero está corrupto o tiene datos erróneos.

Solución paso a paso

  1. Borra el archivo app/config/parameters.php.
  2. Intenta acceder a tudominio.com/install. PrestaShop te redirigirá al asistente de instalación.
  3. Elige la opción "Actualizar" en lugar de "Instalar". Esto te permitirá reconfigurar la base de datos sin perder tus datos.

[INFO]: Si no quieres borrar el archivo, renómbralo a parameters.php.bak. Así PrestaShop no lo encontrará y podrás usar el instalador.

6. Módulos que fallan o no se actualizan

Tras la migración, algunos módulos pueden dar error porque tienen rutas absolutas guardadas en sus tablas internas o porque la versión de PHP del nuevo servidor no es compatible.

Solución paso a paso

  1. Ve a Módulos > Módulos y Servicios en el back-office.
  2. Ordena por "Estado" y busca los que estén en rojo.
  3. Intenta desinstalarlos y reinstalarlos. Esto regenera sus tablas con las nuevas rutas.
  4. Si uno da error de compatibilidad, revisa la versión de PHP de tu servidor. PrestaShop 1.6 no funciona bien con PHP 7.4+, y 1.7 necesita PHP 7.1 o superior.

[TIP]: Si no puedes acceder al back-office por un error de módulo, desactiva todos los módulos temporalmente. Ve a la tabla ps_module en phpMyAdmin y ejecuta: UPDATE ps_module SET active = 0;. Luego accede y activa uno por uno para identificar al culpable.

7. El problema de las URLs amigables (404)

Este es muy común. La tienda funciona, pero al navegar a una categoría te da un error 404. Esto se debe a que las reglas de reescritura de Apache (.htaccess) no se han regenerado.

Solución paso a paso

  1. Accede al back-office de PrestaShop.
  2. Ve a Parámetros Avanzados > SEO y URLs.
  3. Haz clic en el botón "Guardar" sin cambiar nada. Esto fuerza a PrestaShop a regenerar el archivo .htaccess.
  4. Si el error persiste, borra el archivo .htaccess del directorio raíz de tu tienda y repite el paso anterior.

[WARNING]: Si tu servidor usa Nginx en lugar de Apache, necesitarás reglas de reescritura específicas para Nginx. Consulta la documentación de tu hosting o de Syspanel (puerto 2106) para saber cómo configurarlas.

8. El error "Cannot start session" o problemas con las cookies

Este error suele aparecer cuando cambias el dominio y la sesión de PHP no puede validarse.

Solución paso a paso

  1. Ve a tu back-office (si puedes) y limpia la caché.
  2. Si no puedes, edita app/config/parameters.php y busca la línea 'cookie_key'. Cámbiala por una nueva cadena aleatoria.
  3. También revisa que la zona horaria y la configuración de idioma en config/settings.inc.php (o parameters.php) sean correctas.

[TIP]: Si el error aparece justo después de la migración, prueba a acceder desde una ventana de incógnito. A veces es solo un problema de cookies antiguas del navegador.

9. El error "Shop not found" o "Shop with id 0 not found"

Este es uno de los problemas PrestaShop más raros, pero ocurre. Suele pasar cuando la tabla ps_shop tiene un valor incorrecto o la URL del dominio no coincide con la configurada.

Solución paso a paso

  1. En la base de datos, busca la tabla ps_shop y verifica que el campo domain y domain_ssl tengan tu nuevo dominio.

  2. También revisa la tabla ps_shop_url. Aquí se guarda la URL principal.

  3. Ejecuta una consulta SQL para actualizarla:

    UPDATE ps_shop_url SET domain = 'www.tudominionuevo.com', domain_ssl = 'www.tudominionuevo.com' WHERE id_shop = 1;

  4. Limpia la caché de PrestaShop.

10. Preguntas frecuentes (FAQ) sobre la migración

¿Puedo migrar PrestaShop sin acceso al back-office antiguo?

Sí. Necesitas acceso FTP al servidor antiguo y acceso a phpMyAdmin para exportar la base de datos. Si no tienes estos accesos, contacta con tu proveedor anterior.

¿Cuánto tarda en propagarse el cambio de DNS?

Puede tardar de 2 a 48 horas. Durante ese tiempo, algunos usuarios verán la tienda antigua y otros la nueva. Es normal.

¿Debo desactivar la tienda durante la migración?

Es recomendable poner la tienda en modo mantenimiento en el servidor nuevo mientras pruebas. Así evitas que los clientes vean errores a mitad de configuración.

¿Es necesario migrar los archivos de la carpeta img?

Sí, la carpeta img es crucial. Contiene las imágenes de productos, categorías y logotipos. Si no la migras, las imágenes se romperán.

¿Qué pasa con los módulos de pago?

Después de migrar, es posible que los módulos de pago (PayPal, Stripe, etc.) necesiten que vuelvas a introducir las claves API o que verifiques la URL del webhook con el nuevo dominio.

Conclusión final

Migrar PrestaShop no tiene por qué ser una pesadilla si sigues un orden lógico. La mayoría de estos errores PrestaShop se solucionan con paciencia y revisando tres puntos clave: el archivo de configuración, la base de datos y los permisos de archivos.

Resumen rápido de la solución errores PrestaShop:

  • Si ves error de base de datos → Revisa parameters.php.
  • Si ves pantalla blanca → Borra var/cache y activa el modo dev.
  • Si ves enlaces rotos → Reemplaza URLs en la base de datos.
  • Si ves 404 → Regenera el .htaccess desde el back-office.

Recuerda que si tu hosting usa Syspanel (acceso por el puerto 2106), puedes gestionar las bases de datos y los archivos PHP desde un solo lugar, lo que facilita mucho el proceso.

¿Has tenido algún otro error extraño al migrar? Cuéntamelo en los comentarios y lo resolvemos juntos.

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel