No puedo acceder a PrestaShop tras migrar: Soluciones

¡Hola! Soy el técnico de soporte amigable. Has llegado al lugar indicado. Migrar tu tienda PrestaShop a un nuevo servidor es un paso enorme, pero a veces, al final del camino, te encuentras con la pantalla en blanco, un error 500 o simplemente no puedes acceder a tu panel de administración. No te preocupes, esto es más común de lo que crees y, en el 99% de los casos, tiene solución.

En este artículo, vamos a desglosar paso a paso qué hacer si no puedes acceder a PrestaShop después de una migración. Te guiaré como si estuviéramos al teléfono, usando un lenguaje claro y sin tecnicismos complicados. Al final, serás capaz de diagnosticar y solucionar los errores más frecuentes.

1. Mantén la calma y diagnostica el problema

Lo primero es entender qué tipo de error estás viendo. No es lo mismo una página en blanco que un error 403 (acceso prohibido). Anota exactamente lo que ves en la pantalla. Esto nos dará pistas clave.

¿Qué tipo de error ves?

Pantalla en blanco (Error 500): Es el más común. Significa que algo falló en el servidor, pero no se muestra el detalle. Generalmente es un problema de configuración o de archivos.
Error 404 (Página no encontrada): Indica que la URL no está bien configurada o que faltan archivos del núcleo de PrestaShop.
Error 403 (Acceso prohibido): Suele deberse a permisos incorrectos en los archivos o a un archivo .htaccess mal configurado.
Error de conexión a la base de datos: Verás un mensaje como "Cannot connect to database" o "Error establishing a database connection". Esto indica que los datos de conexión (usuario, contraseña, host) son incorrectos.
Redirecciones infinitas: El navegador se queda cargando sin parar. Normalmente por un bucle en las redirecciones de HTTP a HTTPS o viceversa.

Paso clave: Anota el error exacto. Si es un error 500, intenta activar el modo debug de PrestaShop para ver el mensaje real. Te explico cómo más adelante.

2. Verifica los archivos críticos de la migración

Si no puedes acceder a PrestaShop, el problema suele estar en los archivos que acabas de subir al servidor. Asegúrate de que la migración se realizó correctamente.

¿Subiste todos los archivos?

Usa un cliente FTP (como FileZilla): Conéctate a tu nuevo servidor y verifica que la carpeta donde instalaste PrestaShop (normalmente public_html o www) contenga todos los archivos de tu tienda. Debe tener las carpetas admin, classes, controllers, config, img, modules, themes, etc.
Comprueba el archivo settings.inc.php: Este es el archivo más importante. Está en la carpeta config. Si no está o está vacío, la tienda no funcionará. Debe haberse generado durante la instalación o la migración.
No olvides el archivo .htaccess: Si no ves este archivo, es posible que esté oculto. En FileZilla, ve a "Servidor" -> "Forzar mostrar archivos ocultos". Si no existe, puedes generarlo después desde el panel de administración (si logras acceder) o manualmente.

[WARNING] ¡Cuidado con la carpeta install! Después de migrar, la carpeta install debe ser eliminada o renombrada. Si está presente, PrestaShop puede intentar reinstalarse y bloquear el acceso.

3. Configura la conexión a la base de datos

Este es el punto más delicado. Si los datos de la base de datos no coinciden con los que tiene PrestaShop, no podrás acceder.

Paso a paso para corregir la conexión:

Localiza el archivo config/settings.inc.php: Ábrelo con un editor de texto (como Notepad++ o Bloc de notas). Verás algo como esto:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'nombre_de_tu_base');
define('_DB_USER_', 'usuario_de_la_base');
define('_DB_PASSWD_', 'contraseña');
define('_DB_PREFIX_', 'ps_');

Verifica los datos: Asegúrate de que:
- _DB_SERVER_ es correcto. En la mayoría de los casos es localhost, pero si tu hosting tiene un servidor de base de datos externo, será una IP o dominio (ej: mysql.miweb.com).
- _DB_NAME_ coincide exactamente con el nombre de la base de datos que creaste en el nuevo servidor.
- _DB_USER_ y _DB_PASSWD_ son los datos del usuario que creaste para esa base de datos.
Prueba la conexión manualmente: Puedes usar una herramienta como phpMyAdmin (que suele venir incluida en paneles como cPanel o Syspanel) para conectarte con esos datos. Si no puedes desde phpMyAdmin, es que los datos son incorrectos.

[TIP] Si usas Syspanel (recuerda, el puerto de acceso es el 2106), ve a "Base de datos" y crea una nueva base de datos y un usuario. Luego, edita el archivo settings.inc.php con esos datos.

¿Qué pasa si la base de datos no se importó bien?

Vuelve a importar el archivo SQL: Asegúrate de que el archivo .sql que exportaste desde tu antiguo servidor se haya subido completamente. Usa phpMyAdmin o la línea de comandos (si tienes acceso SSH). Un error común es que el archivo sea demasiado grande y se interrumpa la importación.

4. Soluciona errores comunes de PrestaShop migración

Aquí tienes soluciones para los problemas más frecuentes que impiden acceder a PrestaShop.

4.1. Error 500 o pantalla en blanco

Este es el rey de los errores. Activa el modo debug para ver el mensaje real.

Cómo activar el modo debug:

Abre el archivo config/defines.inc.php.
Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);
Guarda el archivo y vuelve a cargar tu tienda. Ahora verás un mensaje de error detallado (por ejemplo, "Class 'Module' not found" o "Fatal error: Uncaught Error..."). Ese mensaje es tu mapa del tesoro.

Soluciones comunes para el error 500:

Permisos incorrectos: Los archivos deben tener permisos 644 y las carpetas 755. En tu FTP, selecciona todos los archivos y carpetas, haz clic derecho -> "Permisos de archivo" y ajústalos.
Problemas con módulos: Desactiva todos los módulos temporalmente. Renombra la carpeta modules a modules_backup y crea una nueva carpeta modules vacía. Si la tienda carga, el problema es un módulo. Luego, ve moviendo los módulos de uno en uno desde la carpeta de backup hasta encontrar el culpable.
Problemas con el tema: Cambia al tema predeterminado (por ejemplo, "classic"). Renombra la carpeta themes/tu-tema a themes/tu-tema_backup. PrestaShop usará el tema por defecto.

[INFO] Si después de activar el modo debug ves un error de memoria (por ejemplo, "Allowed memory size of X bytes exhausted"), necesitas aumentar el límite de memoria en el archivo config/defines.inc.php añadiendo: ini_set('memory_limit', '256M');

4.2. Error 404 después de migrar

Esto suele pasar porque las URL han cambiado o el archivo .htaccess no se regeneró.

Solución:

Accede al panel de administración: Si puedes, ve a "Parámetros de la tienda" -> "Tráfico y SEO" -> "SEO y URL" y guarda la configuración sin cambiar nada. Esto regenera el .htaccess.
Si no puedes acceder al admin: Borra el archivo .htaccess de la raíz de tu tienda (si existe) y luego intenta cargar la tienda. PrestaShop lo regenerará automáticamente. Si no, créalo manualmente con el siguiente contenido básico:
```
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
```
Actualiza la URL en la base de datos: A veces la URL guardada en la base de datos es la antigua. Conéctate a phpMyAdmin, selecciona tu base de datos, ve a la tabla ps_configuration (o el prefijo que uses) y busca las filas con name = PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL. Cámbialas por tu nuevo dominio.

4.3. Error de conexión a la base de datos

Ya lo vimos en el paso 3. Pero si los datos son correctos, puede ser que el servidor de base de datos no esté accesible.

Verifica el firewall: Si tu servidor tiene un firewall (como iptables o CSF), asegúrate de que permite conexiones al puerto 3306 (MySQL) desde tu servidor web.
Hosting compartido: En algunos hostings, el servidor de base de datos no es localhost sino algo como mysql.tudominio.com. Revisa el correo de bienvenida de tu nuevo hosting.

5. Accede al panel de administración

Si la tienda ya carga en el front-end (la parte pública), pero no puedes acceder al back-office (el panel de administración), prueba esto:

¿Olvidaste la URL del admin?

Después de migrar, la URL del panel de administración puede cambiar. Si no la recuerdas, puedes encontrarla en el archivo config/settings.inc.php buscando la línea define('_PS_ADMIN_DIR_', '/ruta/a/tu/admin');. O simplemente prueba con /admin o /admin123 (nombres comunes).

Error al iniciar sesión

Borra la caché: Renombra la carpeta var/cache a var/cache_backup y crea una nueva carpeta var/cache vacía con permisos 755.
Reestablece la contraseña: Si no recuerdas la contraseña, usa la opción "¿Olvidaste tu contraseña?" en la página de login. Si no funciona, puedes cambiarla directamente en la base de datos (tabla ps_employee, campo passwd) usando una herramienta como MD5 (PrestaShop 1.6) o un hash moderno (PrestaShop 1.7+). Es más seguro usar un generador de contraseñas de PrestaShop online.

6. FAQ: Preguntas frecuentes sobre errores en PrestaShop migración

Aquí respondo las dudas que más me llegan al chat de soporte.

¿Por qué veo un error "PrestaShop no puede instalar el módulo" después de migrar?

Esto suele pasar porque la versión de PHP del nuevo servidor es diferente. Verifica que tu hosting tenga la versión de PHP compatible con tu PrestaShop (PrestaShop 1.6 necesita PHP 5.6 o 7.0; PrestaShop 1.7 necesita PHP 7.1 o superior). Puedes cambiarlo desde el panel de control (Syspanel, cPanel, etc.).

¿Cómo soluciono un error "El archivo no se puede escribir"?

Permisos de archivo. Vuelve a asignar permisos 755 a las carpetas y 644 a los archivos. En Syspanel, puedes hacerlo desde el "Administrador de archivos" o por FTP.

¿Qué hago si la migración fue de un hosting a otro y ahora la tienda está en blanco?

Sigue estos pasos en orden:

Activa el modo debug.
Verifica la conexión a la base de datos.
Borra la caché (var/cache).
Desactiva módulos (renombra la carpeta modules).
Cambia el tema (renombra la carpeta themes).

¿Puedo migrar PrestaShop sin perder datos?

Sí, siempre que exportes bien la base de datos y subas todos los archivos. El mayor riesgo es olvidar la carpeta img (las imágenes de productos) o no actualizar las URL en la base de datos.

¿Por qué mi tienda carga lento después de migrar?

Puede ser que el nuevo servidor tenga menos recursos, o que la caché no se haya regenerado. Activa la caché en "Parámetros de la tienda" -> "Rendimiento" y elige "Caché de archivos" o "Caché de Memcached" (si está disponible).

7. Consejos finales para evitar futuros problemas

Antes de migrar, haz siempre una copia de seguridad completa (archivos + base de datos). Usa herramientas como PrestaShop Migrator si no te sientes cómodo haciéndolo manualmente. Y si usas Syspanel, recuerda que el puerto de acceso es el 2106, y que puedes gestionar fácilmente bases de datos y usuarios desde su interfaz.

[TIP] Si después de todo esto sigues sin poder acceder a PrestaShop, no dudes en contactar a tu proveedor de hosting. Ellos pueden revisar los logs del servidor (errores de Apache, PHP, etc.) y darte pistas más precisas. ¡A veces el problema está en el servidor, no en tu tienda!

Espero que esta guía te haya ayudado. Recuerda, la paciencia es clave. Los errores de migración son normales, pero con estos pasos los resolverás en un abrir y cerrar de ojos. ¡Buena suerte con tu tienda!