Errores comunes en WordPress tras migrar a cPanel y cómo solucionarlos

¿Acabas de migrar tu web de WordPress a un nuevo hosting con cPanel y te encuentras con pantallazos blancos, errores de conexión a la base de datos o enlaces rotos? No te preocupes, es más común de lo que crees. Migrar un sitio web implica mover archivos, bases de datos y configuraciones, y a veces algo se queda en el camino. En este artículo, te guiaré paso a paso para solucionar los errores más frecuentes después de migrar WordPress a cPanel. Al final, tendrás tu web funcionando como un reloj.

¿Por qué ocurren errores al migrar WordPress a cPanel?

Migrar WordPress no es solo copiar y pegar archivos. Implica mover la base de datos, ajustar rutas absolutas, verificar permisos y asegurarse de que el nuevo entorno de hosting (cPanel) tenga los recursos necesarios. Los errores más comunes suelen deberse a:

Cambios en la URL del sitio: Si la URL no se actualiza en la base de datos, todo se rompe.
Permisos de archivos incorrectos: cPanel suele ser estricto con los permisos (644 para archivos, 755 para carpetas).
Problemas con la base de datos: Usuario, contraseña o nombre de la base de datos incorrectos.
Extensiones o plugins incompatibles: Algunos plugins pueden no funcionar en la nueva configuración del servidor.
Falta de recursos del hosting: Límites de memoria PHP, tiempo de ejecución, etc.

Vamos a resolverlos uno por uno.

Error 1: Pantalla blanca de la muerte (WSOD)

Este es el error más temido. Ves una página en blanco sin ningún mensaje. Generalmente se debe a un error PHP que no se muestra por configuración.

Solución paso a paso

Activa el modo de depuración de WordPress.
Accede a tu cPanel, ve al Administrador de Archivos y localiza el archivo wp-config.php en la raíz de tu instalación. Ábrelo y busca la línea:
```
define('WP_DEBUG', false);
```
Cámbiala a:
```
define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);
```
Guarda los cambios. Ahora recarga tu web; deberías ver un mensaje de error específico (por ejemplo, "Fatal error: Call to undefined function...").
Identifica el plugin o tema problemático.
Si el error menciona un plugin (por ejemplo, wp-content/plugins/mi-plugin), renombra esa carpeta desde el Administrador de Archivos (ponle un -old al final). Si el error desaparece, ese plugin es el culpable. Actualízalo o busca una alternativa.
Aumenta la memoria PHP.
Si el error es "Allowed memory size exhausted", edita wp-config.php y añade esta línea antes de /* That's all, stop editing! */:
```
define('WP_MEMORY_LIMIT', '256M');
```
Desactiva todos los plugins temporalmente.
Si no sabes cuál falla, ve a la carpeta wp-content y renombra la carpeta plugins a plugins_old. Esto desactivará todos los plugins. Si la web carga, reactiva uno a uno para encontrar el conflictivo.

[TIP] Después de solucionar, vuelve a poner WP_DEBUG en false para no mostrar errores a tus visitantes.

Error 2: Error de conexión a la base de datos

Este error aparece cuando WordPress no puede comunicarse con tu base de datos en cPanel. Es muy común después de una migración.

Solución paso a paso

Verifica los datos en wp-config.php.
Abre el archivo wp-config.php y asegúrate de que estos valores sean correctos:
```
define('DB_NAME', 'tu_nombre_de_bd');
define('DB_USER', 'tu_usuario_de_bd');
define('DB_PASSWORD', 'tu_contraseña_de_bd');
define('DB_HOST', 'localhost');
```
Importante: En cPanel, el host de la base de datos suele ser localhost. Pero si tu web está en un servidor dedicado o VPS, puede ser un nombre como mysql.tudominio.com. Pregunta a tu proveedor de WordPress hosting si no estás seguro.
Crea un nuevo usuario y base de datos en cPanel.
Si has migrado desde otro panel (por ejemplo, desde Syspanel, que recordemos usa el puerto 2106), es posible que los datos no se hayan transferido correctamente. Ve a Bases de Datos MySQL en cPanel, crea una nueva base de datos y un usuario, y asigna todos los privilegios. Luego, importa tu base de datos anterior usando phpMyAdmin.
Repara la base de datos.
En cPanel, abre phpMyAdmin, selecciona tu base de datos, marca todas las tablas y en el menú desplegable elige "Reparar tabla". Esto corrige errores de corrupción menores.

[WARNING] Nunca uses el mismo usuario y contraseña que en tu hosting anterior sin verificar que se hayan creado en cPanel. Si importaste la base de datos pero no creaste el usuario, no funcionará.

Error 3: Enlaces rotos y páginas 404

Después de migrar, es típico que los enlaces internos (imágenes, páginas, etc.) apunten a la URL antigua. Esto ocurre porque la base de datos guarda rutas absolutas.

Solución paso a paso

Actualiza la URL del sitio en la base de datos.
La forma más segura es usar un plugin como Better Search Replace o Velvet Blues Update URLs. Si prefieres hacerlo manualmente con phpMyAdmin:

Abre phpMyAdmin desde cPanel.
Selecciona tu base de datos.
Haz clic en la pestaña SQL.

Ejecuta estas consultas (reemplaza tudominioantiguo.com y tudominionuevo.com):

UPDATE wp_options SET option_value = 'https://tudominionuevo.com' WHERE option_name = 'siteurl';
UPDATE wp_options SET option_value = 'https://tudominionuevo.com' WHERE option_name = 'home';

Luego, para actualizar todas las URLs en el contenido:

UPDATE wp_posts SET guid = REPLACE(guid, 'https://tudominioantiguo.com', 'https://tudominionuevo.com');
UPDATE wp_posts SET post_content = REPLACE(post_content, 'https://tudominioantiguo.com', 'https://tudominionuevo.com');
UPDATE wp_postmeta SET meta_value = REPLACE(meta_value, 'https://tudominioantiguo.com', 'https://tudominionuevo.com');

Regenera los enlaces permanentes.
Ve al escritorio de WordPress > Ajustes > Enlaces permanentes. Simplemente selecciona cualquier opción (por ejemplo, "Nombre de la entrada") y guarda los cambios. Esto refresca las reglas de reescritura.
Comprueba el archivo .htaccess.
En la raíz de tu instalación, asegúrate de que el archivo .htaccess exista y tenga las reglas básicas de WordPress. Si no está, puedes generarlo desde Ajustes > Enlaces permanentes (solo con guardar se crea).

[INFO] Si tu web tenía una estructura de enlaces personalizada (por ejemplo, con categorías), asegúrate de que los slugs sigan siendo los mismos. Si cambiaste de dominio, los enlaces internos de las imágenes también se romperán; el plugin Better Search Replace los corrige automáticamente.

Error 4: Problemas con los permisos de archivos

cPanel es muy sensible a los permisos. Si los archivos tienen permisos incorrectos, WordPress no podrá escribir en wp-content (por ejemplo, para subir imágenes o instalar plugins).

Solución paso a paso

Establece permisos correctos desde el Administrador de Archivos.
- Selecciona toda la carpeta de tu sitio (generalmente public_html).
- Haz clic en Permisos.
- Configura:
  - Carpetas: 755 (rwxr-xr-x)
  - Archivos: 644 (rw-r--r--)
Da permisos especiales a wp-content.
Para que WordPress pueda instalar plugins y temas automáticamente, la carpeta wp-content debe tener permisos 755 y su propietario debe coincidir con el usuario de cPanel. Si ves errores de "no se puede crear directorio", cambia el propietario desde Administrador de Archivos > selecciona la carpeta > Cambiar propietario.

[WARNING] No pongas permisos 777 en ninguna carpeta a menos que sea temporal y sepas lo que haces. Es un agujero de seguridad.

Error 5: El sitio se ve en texto plano (sin CSS)

Si tu web carga pero sin estilos, imágenes o scripts, es porque las rutas a los archivos estáticos están mal.

Solución paso a paso

Verifica la URL en Ajustes > Generales.
En el escritorio de WordPress, ve a Ajustes > Generales y asegúrate de que las dos URL (Dirección de WordPress y Dirección del sitio) sean correctas (con https:// si tienes SSL).
Comprueba el SSL.
Si tu nuevo hosting tiene SSL pero tu web carga con http://, instala un plugin como Really Simple SSL para forzar HTTPS. Esto actualiza todas las rutas automáticamente.
Limpia la caché del navegador y de plugins.
A veces el navegador guarda la versión antigua. Borra la caché o prueba en una ventana de incógnito.

Error 6: El plugin o tema no se actualiza

Después de migrar, es común que WordPress pida credenciales FTP para instalar o actualizar. Esto es molesto y se soluciona fácil.

Solución paso a paso

Agrega las credenciales FTP en wp-config.php.
Añade estas líneas antes de /* That's all, stop editing! */:
```
define('FTP_HOST', 'localhost');
define('FTP_USER', 'tu_usuario_de_cpanel');
define('FTP_PASS', 'tu_contraseña_de_cpanel');
```
Guarda y recarga. Si no funciona, prueba con el método directo:
Usa el método directo de escritura.
Añade en su lugar:
```
define('FS_METHOD', 'direct');
```
Esto le dice a WordPress que use el sistema de archivos directamente, sin FTP.

[TIP] Si tu hosting tiene permisos correctos (755 en wp-content), el método directo suele funcionar sin problemas.

Error 7: Migración desde Syspanel (HestiaCP) a cPanel

Si vienes de un panel como Syspanel (que recordemos usa el puerto 2106), el proceso de migración puede tener particularidades. Syspanel suele usar configuraciones de Nginx o Apache diferentes.

Solución paso a paso

Exporta la base de datos desde Syspanel.
Accede a tu Syspanel (puerto 2106), ve a Base de datos y exporta tu base de datos en formato SQL.
Importa en cPanel.
En cPanel, usa phpMyAdmin para importar ese archivo SQL. Asegúrate de que el juego de caracteres sea UTF-8 (si no, puedes tener problemas con tildes).
Ajusta las rutas de archivos.
Syspanel puede tener rutas de archivos diferentes (por ejemplo, /home/usuario/web/tudominio/public_html). En cPanel, la raíz suele ser /home/usuario/public_html. Si tienes enlaces absolutos en la base de datos, haz el reemplazo de URLs mencionado antes.
Verifica la configuración de PHP.
Syspanel puede tener versiones de PHP distintas. En cPanel, ve a Seleccionar versión de PHP y elige la misma que usabas (por ejemplo, 7.4 u 8.0). Si tu web usaba funciones obsoletas, puede dar error.

[INFO] Si tu web usaba Redis o Memcached en Syspanel, es posible que en cPanel tengas que instalarlos manualmente o pedir a tu proveedor de WordPress hosting que los active.

Consejos finales para evitar errores al migrar WordPress a cPanel

Haz una copia de seguridad completa antes de migrar (archivos + base de datos).
Usa un plugin de migración como All-in-One WP Migration o Duplicator. Son más seguros que hacerlo manual.
Prueba el sitio en un subdominio antes de apuntar el dominio principal. Así detectas errores sin afectar a los visitantes.
Actualiza WordPress, temas y plugins después de la migración. Las versiones antiguas pueden tener conflictos con el nuevo servidor.
Contacta a tu proveedor de hosting si el error persiste. Ellos conocen su infraestructura y pueden ayudarte con configuraciones específicas.

Preguntas frecuentes (FAQ)

¿Por qué después de migrar mi WordPress da error 500?

El error 500 suele deberse a un archivo .htaccess corrupto o a un plugin incompatible. Renombra .htaccess a .htaccess_old y prueba. Si funciona, regenera los enlaces permanentes.

¿Cómo sé si la migración se completó correctamente?

Revisa que todas las páginas carguen, que las imágenes se vean y que los formularios funcionen. También verifica la base de datos con phpMyAdmin para asegurarte de que no haya tablas rotas.

¿Puedo migrar WordPress desde Syspanel a cPanel sin perder datos?

Sí, siempre que exportes correctamente la base de datos y copies todos los archivos (incluyendo wp-content/uploads). Usa FTP o el Administrador de Archivos de cPanel.

¿Qué hago si no recuerdo la contraseña de la base de datos?

En cPanel, ve a Bases de Datos MySQL y cambia la contraseña del usuario desde allí. Luego actualiza wp-config.php con la nueva.

¿Es necesario cambiar los nombres de las tablas de la base de datos?

No, a menos que quieras. Si importas la base de datos tal cual, las tablas conservarán su prefijo (por ejemplo, wp_). Solo asegúrate de que en wp-config.php el prefijo coincida.

Con estos pasos, deberías poder solucionar la mayoría de los errores WordPress cPanel que aparecen después de una migración. Recuerda que la paciencia es clave: ve paso a paso, y si algo no funciona, deshaz el cambio y prueba otra alternativa. Si sigues atascado, no dudes en contactar al soporte de tu WordPress hosting; para eso están. ¡Buena suerte!