Errores al migrar WordPress con cPanel: Soluciones prácticas

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a hablar de un tema que a muchos nos ha dado algún que otro dolor de cabeza: migrar WordPress con cPanel. No te preocupes, es más común de lo que crees y, con la guía adecuada, podrás hacerlo sin problemas. Vamos a desglosar los errores más frecuentes y, lo más importante, cómo solucionarlos paso a paso.

¿Por qué migrar WordPress con cPanel puede ser un desafío?

Migrar un sitio WordPress implica mover archivos, bases de datos y configuraciones de un servidor a otro. cPanel es una herramienta fantástica para esto, pero si no se siguen los pasos correctos, pueden aparecer errores. La clave está en la preparación y en conocer los puntos débiles del proceso.

Recuerda: una migración exitosa no solo mueve datos, sino que también mantiene la funcionalidad y la apariencia de tu web. Vamos a ver los errores más comunes y cómo evitarlos.

Error #1: No hacer una copia de seguridad completa

Este es el error más grave. Muchos usuarios confían en que la migración saldrá bien y omiten este paso. Siempre, siempre, siempre haz una copia de seguridad completa antes de empezar.

¿Qué incluye una copia de seguridad completa?

Archivos del sitio: Todo el contenido de la carpeta public_html (o la carpeta raíz de tu WordPress).
Base de datos: La base de datos MySQL donde se almacenan tus entradas, páginas, comentarios, configuraciones, etc.
Archivos de configuración: Especialmente el wp-config.php, que contiene las credenciales de conexión a la base de datos.

Cómo hacer la copia de seguridad en cPanel

Accede a cPanel (normalmente en tudominio.com/cpanel).
Busca la sección Archivos y haz clic en Asistente de copias de seguridad.
Selecciona Copia de seguridad completa (esto te descargará un archivo .tar.gz con todo).
También puedes hacer copias parciales: en la sección Bases de datos, exporta tu base de datos como un archivo .sql.

[WARNING] No confíes solo en plugins de WordPress para la copia de seguridad. Aunque son útiles, una copia directa desde cPanel es más fiable.

Solución si no tienes copia de seguridad

Si ya cometiste el error y tu sitio está roto, intenta lo siguiente:

Contacta a tu hosting anterior y pídeles una copia de seguridad reciente.
Si tienes acceso al panel de administración de WordPress, usa un plugin como UpdraftPlus para hacer una copia de emergencia.
Como último recurso, revisa si tu hosting anterior tiene backups automáticos (muchos proveedores los guardan por 30 días).

Error #2: No actualizar las rutas en la base de datos

Cuando mueves WordPress de un dominio a otro (o de un subdominio a un dominio principal), las rutas absolutas en la base de datos quedan desactualizadas. Esto provoca que las imágenes no se vean, los enlaces internos apunten al sitio antiguo y, en casos extremos, que el panel de administración sea inaccesible.

¿Dónde se guardan esas rutas?

En la tabla wp_options (campos siteurl y home).
En las tablas wp_posts y wp_postmeta (rutas de imágenes, enlaces permanentes, etc.).
También en la tabla wp_usermeta (si usas URLs de perfil personalizadas).

Cómo solucionarlo

Opción 1: Usar un plugin (recomendado para principiantes)

Instala el plugin Better Search Replace en tu WordPress.
Ve a Herramientas > Better Search Replace.
En "Buscar", escribe la URL antigua (ej: http://antiguodominio.com).
En "Reemplazar con", escribe la nueva URL (ej: http://nuevodominio.com).
Selecciona todas las tablas de la base de datos.
Haz clic en Ejecutar reemplazo.

Opción 2: Usar phpMyAdmin (más técnico)

Accede a phpMyAdmin desde cPanel (sección Bases de datos).
Selecciona tu base de datos.
Haz clic en la pestaña SQL.

Ejecuta el siguiente comando (cambiando las URLs):

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

[TIP] Si tu sitio usa HTTPS, asegúrate de usar https:// en ambas URLs. De lo contrario, tendrás problemas de contenido mixto.

Error #3: Olvidar actualizar el archivo wp-config.php

El archivo wp-config.php es el corazón de tu WordPress. Contiene las credenciales de la base de datos y otras configuraciones clave. Si no lo actualizas, tu sitio no podrá conectarse a la base de datos y verás el temido error "Error al establecer una conexión con la base de datos".

¿Qué debes cambiar?

DB_NAME: El nombre de la nueva base de datos.
DB_USER: El usuario de la nueva base de datos.
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: Normalmente es localhost, pero en algunos hosting puede ser diferente (p.ej., mysql.tudominio.com).

Cómo hacerlo

Conéctate a tu nuevo servidor vía FTP o desde el administrador de archivos de cPanel.
Localiza el archivo wp-config.php en la raíz de tu WordPress.
Edítalo con un editor de texto (Notepad++ es ideal).
Reemplaza las líneas de las credenciales con los datos de tu nueva base de datos.
Guarda el archivo y vuelve a cargarlo al servidor.

[WARNING] Ten cuidado con los espacios y comillas. Un carácter mal colocado puede romper todo. Si no estás seguro, copia el bloque exacto de tu nueva base de datos.

Error #4: No verificar los permisos de archivos y carpetas

Los permisos incorrectos pueden impedir que WordPress escriba en el servidor. Esto afecta la subida de imágenes, la instalación de plugins, las actualizaciones y, en general, el funcionamiento del sitio.

Permisos correctos

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)
Archivo wp-config.php: 600 (rw-------) o 640 (rw-r-----) por seguridad.

Cómo ajustarlos desde cPanel

Ve a Archivos > Administrador de archivos.
Navega a la carpeta raíz de tu WordPress (normalmente public_html).
Selecciona todos los archivos y carpetas (Ctrl+A).
Haz clic en Permisos en la barra superior.
Establece el permiso para Carpetas en 755 y para Archivos en 644.
Después, ajusta el wp-config.php manualmente: haz clic derecho sobre él, elige Cambiar permisos y pon 600.

[INFO] Si tu sitio usa plugins de caché o de seguridad, es posible que necesiten permisos especiales. Revisa la documentación de cada plugin.

Error #5: Ignorar los problemas de la base de datos (corrupción o incompatibilidad)

A veces, la base de datos se corrompe durante la migración, especialmente si la exportación/importación se interrumpe o si hay caracteres especiales mal codificados. También puede haber incompatibilidades de versiones de MySQL.

Síntomas

Errores como "Tabla no existe" o "Columna desconocida".
El sitio carga muy lento o muestra contenido desordenado.
Algunos plugins o temas fallan.

Soluciones

Reparar la base de datos desde cPanel:
- Ve a Bases de datos > phpMyAdmin.
- Selecciona tu base de datos.
- Marca todas las tablas (clic en "Seleccionar todo").
- En el menú desplegable, elige Reparar tabla.
Verificar la codificación:
- Asegúrate de que la base de datos use utf8_general_ci o utf8mb4_general_ci (esta última es la recomendada para WordPress moderno).
- Puedes cambiar la codificación desde phpMyAdmin en la pestaña Operaciones de la base de datos.
Reimportar la base de datos:
- Si la reparación no funciona, exporta la base de datos nuevamente desde el origen (asegurándote de que la exportación sea completa).
- En el destino, elimina todas las tablas existentes y vuelve a importar.

Error #6: No actualizar las DNS o los registros del dominio

Después de mover los archivos y la base de datos, tu dominio debe apuntar al nuevo servidor. Si no actualizas los DNS, los visitantes seguirán viendo el sitio antiguo (o un error).

¿Qué debes hacer?

Actualiza los servidores DNS en tu registrador de dominio (donde compraste el dominio). Normalmente son dos direcciones (ns1.nuevohosting.com, ns2.nuevohosting.com).
Espera la propagación: Puede tardar de 1 a 48 horas. Durante ese tiempo, algunos verán el sitio nuevo y otros el antiguo.
Si usas un CDN (como Cloudflare), actualiza la configuración del CDN con la IP del nuevo servidor.

Cómo verificar si la propagación terminó

Usa herramientas como whatsmydns.net para comprobar desde diferentes ubicaciones.
También puedes editar tu archivo hosts local para forzar la visualización del nuevo sitio y probar.

[WARNING] Si cambias las DNS antes de que la migración esté completa, tu sitio estará caído temporalmente. Haz el cambio solo cuando estés seguro de que todo funciona en el nuevo servidor.

Error #7: No desactivar plugins o temas incompatibles

Algunos plugins y temas están diseñados para funcionar con configuraciones específicas del servidor (como versiones de PHP, extensiones, etc.). Al migrar, es posible que no sean compatibles y generen errores.

Síntomas

Pantalla blanca de la muerte (WSOD).
Errores de tipo "Call to undefined function".
El panel de administración no carga correctamente.

Solución

Accede a tu sitio por FTP o por el administrador de archivos de cPanel.
Navega a wp-content/plugins y renombra la carpeta del plugin problemático (por ejemplo, añadiendo _old al final). Esto lo desactivará.
Si no sabes cuál es el problemático, renombra toda la carpeta plugins a plugins_old. WordPress creará una nueva carpeta plugins vacía.
Luego, desde el panel de administración, ve a Plugins y actívalos uno por uno para identificar el culpable.

[TIP] Para temas, renombra la carpeta del tema en wp-content/themes. WordPress usará el tema por defecto (Twenty Twenty-Four o similar) y podrás acceder al panel.

Error #8: No comprobar la versión de PHP

WordPress y muchos plugins requieren una versión específica de PHP. Si tu nuevo servidor tiene una versión diferente (especialmente inferior), pueden aparecer errores.

Cómo verificarlo

En cPanel, busca la sección Software y haz clic en Seleccionar versión de PHP.
Asegúrate de que sea al menos PHP 7.4 (WordPress recomienda PHP 8.0 o superior).
Si no ves la opción, contacta a tu hosting para que la cambien.

Solución

Cambia la versión de PHP desde el selector de cPanel.
Si tu sitio usa plugins antiguos que no son compatibles con PHP 8, considera actualizarlos o buscar alternativas.

Error #9: Olvidar migrar los archivos multimedia

A veces, los usuarios migran la base de datos y los archivos de WordPress, pero olvidan la carpeta wp-content/uploads. Esto provoca que las imágenes y otros archivos multimedia no se vean.

Cómo evitarlo

Al migrar, asegúrate de copiar toda la carpeta wp-content/uploads (y cualquier otra carpeta personalizada dentro de wp-content, como wp-content/cache o wp-content/themes).
Usa un cliente FTP (como FileZilla) para arrastrar la carpeta completa desde tu servidor antiguo al nuevo.

[INFO] Si tu sitio tiene muchas imágenes, la migración por FTP puede ser lenta. Considera usar una herramienta de copia remota como rsync si tienes acceso SSH.

Error #10: No probar el sitio antes de hacer el cambio definitivo

Este es el error que más dolores de cabeza causa. Migrar y cambiar las DNS sin probar puede dejarte sin sitio funcional durante horas o días.

Cómo probar el sitio en el nuevo servidor

Usa un archivo hosts temporal: En tu computadora, edita el archivo hosts (en Windows está en C:\Windows\System32\drivers\etc\hosts, en Linux/Mac en /etc/hosts). Agrega una línea como:
```
IP_DEL_NUEVO_SERVIDOR tudominio.com www.tudominio.com
```
Esto hará que tu computadora vea el nuevo servidor, mientras que el resto del mundo sigue viendo el antiguo.
Prueba todo: Navega por el sitio, haz clic en enlaces, envía formularios, prueba el carrito de compras (si es tienda), etc.
Si todo funciona, elimina la línea del archivo hosts y procede a cambiar las DNS.

[WARNING] No olvides eliminar la línea del archivo hosts después de probar, o tu computadora seguirá viendo el nuevo servidor incluso después del cambio de DNS.

Preguntas frecuentes (FAQ) sobre migrar WordPress con cPanel

¿Cuánto tiempo tarda una migración con cPanel?

Depende del tamaño de tu sitio. Una migración completa (archivos + base de datos) puede tomar desde 10 minutos hasta varias horas si tienes muchos archivos multimedia. La propagación de DNS puede añadir hasta 48 horas, pero el sitio suele estar funcional en unas horas.

¿Qué hago si mi sitio queda en blanco después de la migración?

Verifica el archivo wp-config.php (credenciales correctas).
Revisa los permisos de archivos (755/644).
Desactiva plugins renombrando la carpeta plugins.
Cambia la versión de PHP a una más reciente.
Activa el modo debug de WordPress añadiendo al wp-config.php:
```
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
```
Luego revisa el archivo wp-content/debug.log para ver errores específicos.

¿Puedo migrar WordPress sin cPanel?

Sí, pero cPanel facilita mucho el proceso. Alternativas:

Por FTP: Descarga todos los archivos y súbelos al nuevo servidor, luego exporta/importa la base de datos.
Con plugins: Usa plugins como Duplicator, All-in-One WP Migration o UpdraftPlus.
Con comandos SSH: Si tienes acceso, puedes usar wp-cli o rsync.

¿Qué es Syspanel y cómo se relaciona con cPanel?

Syspanel es un panel de control alternativo (similar a cPanel) que algunos proveedores de hosting ofrecen. Si tu hosting usa Syspanel (anteriormente conocido como HestiaCP), el puerto de acceso es el 2106 (por ejemplo, tudominio.com:2106). Los pasos para migrar son similares a los de cPanel, pero las opciones pueden estar en diferentes lugares. Si tienes dudas, consulta la documentación de tu hosting.

¿Necesito conocimientos técnicos para migrar?

No necesariamente, pero ayuda tener una comprensión básica de archivos, bases de datos y FTP. Si te sientes inseg