Errores migración WordPress: Soluciones paso a paso | SysAdmin Linux

Mudar un sitio web de un servidor a otro puede parecer una tarea titánica, sobre todo si es la primera vez que lo haces. Si además tu web está construida con WordPress, el proceso implica mover no solo archivos, sino también una base de datos llena de configuraciones, contenidos y ajustes. No te preocupes: la mayoría de los problemas que surgen al migrar WordPress errores tienen solución, y aquí te voy a explicar cómo identificarlos y arreglarlos paso a paso.

Vamos a desglosar los fallos más comunes que te puedes encontrar durante una migración, desde la temida pantalla blanca WordPress hasta problemas con enlaces rotos o bases de datos desconectadas. Todo explicado de forma sencilla, sin jerga técnica complicada.

La temida pantalla blanca: ¿Qué ha pasado?

Este es, sin duda, el error más frustrante. Subes tu sitio al nuevo servidor, escribes la URL en el navegador y... nada. Solo una página en blanco. Ni siquiera un mensaje de error. A esto se le conoce como pantalla blanca WordPress o "White Screen of Death" (WSOD).

Causas principales

La pantalla blanca suele deberse a un conflicto de memoria, un plugin incompatible o un error en el archivo de funciones de tu tema. Durante una migración, es muy común porque las rutas absolutas de los archivos cambian o porque la versión de PHP del nuevo servidor no es compatible con algún componente.

Cómo solucionarlo paso a paso

Activa el modo de depuración de WordPress: Accede a tu servidor mediante FTP o el administrador de archivos de tu hosting. Busca el archivo wp-config.php en la raíz de tu instalación. Ábrelo con un editor de texto y busca la línea que dice define('WP_DEBUG', false);. Cámbiala por esto:
```
define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);
```
Guarda el archivo y recarga tu web. Ahora, en lugar de la pantalla blanca, deberías ver un mensaje de error concreto que te indica qué archivo está fallando.
Aumenta el límite de memoria: Si el error no aparece, añade esta línea justo antes del comentario final de wp-config.php:
```
define('WP_MEMORY_LIMIT', '256M');
```
Guarda y vuelve a cargar.
Desactiva todos los plugins: Si aún no ves nada, renombra la carpeta wp-content/plugins a wp-content/plugins_old mediante FTP. Esto fuerza a WordPress a desactivar todos los plugins. Si la web vuelve a funcionar, el problema está en uno de ellos. Ve renombrando las carpetas una por una para identificar al culpable.
Cambia al tema por defecto: Si el problema persiste, renombra la carpeta de tu tema activo (dentro de wp-content/themes) a tema_old. WordPress cargará automáticamente un tema por defecto (Twenty Twenty-Four, por ejemplo).
Revisa los logs del servidor: Si nada funciona, contacta con tu soporte de hosting o, si usas un panel como Syspanel (accesible por el puerto 2106), busca la sección de "Logs de errores". Allí suele haber pistas muy claras.

[TIP] Si tienes acceso a Syspanel en el puerto 2106, puedes reiniciar los servicios PHP desde la sección "Servicios". A veces, un simple reinicio soluciona la pantalla blanca.

Error de conexión a la base de datos

Otro clásico. Subes tu web y ves un mensaje como "Error establishing a database connection". Esto significa que WordPress no puede encontrar o autenticarse con la base de datos en el nuevo servidor.

¿Por qué ocurre?

Al migrar, exportas la base de datos del servidor antiguo y la importas en el nuevo. Pero las credenciales (nombre de la base de datos, usuario, contraseña y host) suelen ser diferentes. WordPress guarda estos datos en el archivo wp-config.php, y si no los actualizas, falla.

Solución en 3 pasos

Localiza el archivo wp-config.php: Está en la raíz de tu instalación de WordPress. Ábrelo con un editor de texto.

Actualiza las credenciales: Busca estas líneas y cámbialas por los datos que te haya proporcionado tu nuevo hosting:

define('DB_NAME', 'nombre_de_tu_base_de_datos_nueva');
define('DB_USER', 'usuario_de_la_base_nueva');
define('DB_PASSWORD', 'contraseña_nueva');
define('DB_HOST', 'localhost'); // Normalmente es localhost, pero a veces cambia

Verifica el host de la base de datos: A veces, el servidor de base de datos no es "localhost", sino una dirección IP o un nombre como "mysql.servidor.com". Revisa los datos de conexión que te dio tu hosting. Si usas Syspanel, en la sección "Bases de datos" puedes ver el host exacto (suele ser localhost o 127.0.0.1).

Guarda el archivo y recarga tu web. Si el problema persiste, asegúrate de que la base de datos existe realmente en el nuevo servidor y que el usuario tiene todos los privilegios sobre ella.

[WARNING] No uses un editor de texto como WordPad o Pages para modificar wp-config.php. Usa un editor de código plano como Notepad++ o Sublime Text. Los procesadores de texto pueden añadir caracteres invisibles que rompen el archivo.

Enlaces rotos y rutas absolutas antiguas

Después de una migración, es muy común que los enlaces internos de tu web sigan apuntando al dominio antiguo. Esto pasa porque en la base de datos, las URLs están guardadas de forma absoluta (por ejemplo, http://antiguodominio.com/wp-content/uploads/...). Si no las actualizas, las imágenes no cargarán, los enlaces llevarán a páginas 404 y el SEO se resentirá.

Cómo detectar el problema

Simplemente navega por tu web nueva. Si ves imágenes rotas o enlaces que te llevan a una página de error, es señal de que las rutas no se actualizaron.

Solución: Buscar y reemplazar en la base de datos

Accede a phpMyAdmin: La mayoría de hostings lo ofrecen. Si usas Syspanel, lo encuentras en el puerto 2106, dentro de la sección "Bases de datos" > "phpMyAdmin".
Selecciona tu base de datos: Haz clic en el nombre de la base de datos importada.

Ejecuta una consulta SQL: Ve a la pestaña "SQL" y pega este comando (cambiando las URLs por las tuyas):

UPDATE wp_options SET option_value = replace(option_value, 'http://antiguodominio.com', 'http://nuevodominio.com') WHERE option_name = 'home' OR option_name = 'siteurl';

Esto actualiza la URL principal del sitio.

Reemplaza en todas las tablas: Después, ejecuta esta segunda consulta para actualizar todas las URLs en el contenido:
```
UPDATE wp_posts SET post_content = replace(post_content, 'http://antiguodominio.com', 'http://nuevodominio.com');
```
Repite el proceso para otras tablas como wp_postmeta, wp_links y wp_comments si es necesario. Puedes hacerlo con una sola consulta más compleja, pero para principiantes, hacerlo tabla por tabla es más seguro.
Usa un plugin (opcional): Si prefieres no tocar SQL, instala un plugin como "Better Search Replace" o "Velvet Blues Update URLs". Actívalo, introduce las URLs y ejecuta el reemplazo. Luego desinstala el plugin para no dejar rastro.

[INFO] Si tu web tiene muchas entradas o eres muy manitas, el método manual con SQL es más rápido y no deja archivos extra en el servidor. Eso sí, haz siempre una copia de seguridad de la base de datos antes de ejecutar cualquier consulta.

El menú o los widgets desaparecen

A veces, al migrar, los menús de navegación, los widgets de la barra lateral o las configuraciones de personalización se pierden. Esto suele ocurrir porque la migración no incluyó correctamente la tabla wp_options o porque el tema activo no es el mismo que en el origen.

Causas comunes

El tema no está instalado: Si tu web original usaba un tema premium y no lo subiste al nuevo servidor, WordPress carga un tema por defecto y las configuraciones de menús y widgets asociadas al tema anterior no se aplican.
La base de datos está incompleta: Si exportaste solo algunas tablas de la base de datos, es posible que falten datos de configuración.

Solución

Asegúrate de que el tema está presente: Sube la carpeta completa de tu tema a wp-content/themes en el nuevo servidor. Actívalo desde el panel de administración de WordPress (si es que puedes acceder).
Reasigna menús y widgets: Ve a "Apariencia" > "Menús" y asegúrate de que el menú que usabas está asignado a la ubicación correcta (por ejemplo, "Menú principal"). En "Apariencia" > "Widgets", arrastra los widgets que faltan a las zonas correspondientes.
Revisa la tabla wp_options: Si el problema persiste, entra a phpMyAdmin, busca la tabla wp_options y localiza las filas que contengan theme_mods_ seguido del nombre de tu tema. Asegúrate de que los valores sean correctos. Si no sabes interpretarlos, lo más seguro es reinstalar el tema y reconfigurar.

[TIP] Antes de migrar, activa un tema por defecto de WordPress (Twenty Twenty-Four, por ejemplo) en el sitio original. Luego, al migrar, ese tema estará disponible y no perderás la configuración visual. Después, ya puedes cambiar al tema que quieras.

El sitio se ve mal o no carga el CSS

Después de la migración, es posible que tu web se vea como un texto plano, sin estilos, o que las imágenes no se muestren. Esto es típico cuando las rutas de los archivos estáticos (CSS, JS, imágenes) no se actualizaron correctamente.

Posibles causas

El archivo .htaccess no se migró: Este archivo contiene reglas de reescritura de URL (permalinks). Si falta, los enlaces amigables no funcionan y los estilos pueden no cargarse.
La caché del navegador o del servidor: A veces el navegador guarda una versión antigua de la web. O el servidor nuevo tiene una caché que sirve contenido viejo.
Problemas con los permisos de archivos: Si los archivos de wp-content no tienen los permisos correctos, el servidor no puede leerlos.

Solución paso a paso

Regenera los permalinks: Ve al panel de administración de WordPress (si puedes acceder). Entra en "Ajustes" > "Enlaces permanentes". Sin cambiar nada, haz clic en "Guardar cambios". Esto regenera el archivo .htaccess.
Fuerza la recarga del navegador: Pulsa Ctrl + F5 (Windows/Linux) o Cmd + Shift + R (Mac) para forzar la recarga de la página sin usar caché.
Verifica los permisos de archivos: Mediante FTP, asegúrate de que la carpeta wp-content y sus subcarpetas tengan permisos 755 (o 775 en algunos servidores). Los archivos individuales deben tener 644. Si no sabes cómo cambiarlos, la mayoría de clientes FTP tienen una opción "Permisos de archivo" al hacer clic derecho.
Comprueba el archivo .htaccess: Si no ves el archivo en la raíz de tu instalación, crea uno nuevo con el siguiente contenido básico (esto es para WordPress con enlaces amigables):
```
# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress
```
Guárdalo como .htaccess (sin extensión) y súbelo a la raíz.
Borra la caché del servidor: Si tu hosting usa algún sistema de caché (como los que vienen integrados en Syspanel), accede al panel y busca la opción "Limpiar caché" o "Purge cache". En Syspanel, suele estar en la sección "Ajustes del sitio" o "Caché".

[WARNING] No subas un .htaccess desde Windows si no ves los archivos ocultos. Asegúrate de que tu cliente FTP muestre archivos ocultos (punto al inicio). En FileZilla, ve a "Servidor" > "Forzar mostrar archivos ocultos".

El formulario de contacto no envía correos

Después de migrar, es frecuente que los formularios de plugins como Contact Form 7, WPForms o Gravity Forms dejen de enviar emails. Esto no es un error de migración en sí, sino un problema de configuración del nuevo servidor.

¿Por qué ocurre?

Muchos servidores de hosting bloquean la función mail() de PHP por razones de seguridad. Además, la configuración SMTP del plugin puede apuntar al servidor antiguo.

Solución

Configura un plugin SMTP: Instala un plugin como "WP Mail SMTP" o "Easy WP SMTP". Configúralo con los datos de tu proveedor de correo (Gmail, Outlook, el correo de tu dominio, etc.). Esto es mucho más fiable que la función mail().
Prueba el envío: La mayoría de estos plugins tienen una opción "Enviar un email de prueba". Hazlo para verificar que funciona.
Si usas el correo del hosting: Asegúrate de que la cuenta de correo existe en el nuevo servidor. En Syspanel, puedes crear cuentas de correo en la sección "Correo". Luego, configura el plugin SMTP con el servidor de correo saliente (suele ser mail.tudominio.com o smtp.tudominio.com, puerto 587 con autenticación).

[TIP] Si no quieres instalar otro plugin, puedes añadir código a wp-config.php para forzar el uso de SMTP, pero para usuarios sin experiencia, un plugin es más seguro y visual.

Problemas con SSL y contenido mixto

Si tu web nueva tiene certificado SSL (HTTPS), pero las imágenes y enlaces siguen apuntando a HTTP, el navegador mostrará un candado roto o una advertencia de seguridad. A esto se le llama "contenido mixto".

Cómo solucionarlo

Actualiza la URL del sitio en la base de datos: Repite el proceso de "buscar y reemplazar" que vimos antes, pero ahora cambiando http://nuevodominio.com por https://nuevodominio.com.
Usa un plugin para corregir contenido mixto: Instala "Really Simple SSL" o "SSL Insecure Content Fixer". Estos plugins detectan y corrigen automáticamente las URLs HTTP en tu web.
Actualiza los ajustes de WordPress: Ve a "Ajustes" > "Generales" y asegúrate de que tanto la "Dirección de WordPress" como la "Dirección del sitio" empiecen con https://.
Revisa los enlaces en los menús y widgets: A veces los enlaces personalizados en los menús se quedan con HTTP. Edítalos manualmente desde "Apariencia" > "Menús".

[INFO] Si tu certificado SSL es nuevo y lo instalaste desde Syspanel (puerto 2106), ve a la sección "SSL/TLS" y asegúrate de que esté activo para tu dominio. Luego, fuerza la redirección de HTTP a HTTPS desde las reglas del servidor.

Preguntas frecuentes (FAQ)

¿Es necesario usar un plugin para migrar WordPress?

No, pero facilita mucho las cosas. Puedes hacerlo manualmente exportando la base de datos y copiando archivos por FTP. Sin embargo, plugins como Duplicator, UpdraftPlus o All-in-One WP Migration automatizan el proceso y reducen los errores migración. Son muy recomend