5 errores comunes al instalar WordPress en cPanel y cómo solucionarlos

Introducción: Por qué falla WordPress al instalarlo en cPanel

Instalar WordPress en cPanel es uno de los procesos más comunes en el mundo del hosting, pero también uno de los que más dolores de cabeza genera. La mayoría de los errores que aparecen durante la instalación no son culpa de WordPress, sino de una configuración incorrecta en el servidor, en los permisos de archivos o en la base de datos.

Si estás viendo una pantalla blanca, un error 500, o un mensaje de "Error al conectar con la base de datos", no te preocupes. En esta guía vamos a desglosar los 5 errores más comunes al instalar WordPress en cPanel, explicando por qué ocurren y, lo más importante, cómo solucionarlos paso a paso.

A lo largo del artículo usaré un tono sencillo, pensado para que cualquier persona, aunque no tenga experiencia técnica, pueda seguir las instrucciones sin sentirse perdida. Vamos a ello.

Error 1: "Error al conectar con la base de datos" (Database Connection Error)

Este es, sin duda, el error más frecuente cuando hablamos de instalar WordPress error. Aparece una pantalla con un mensaje similar a "Error establishing a database connection" y el usuario se queda bloqueado sin saber qué hacer.

¿Por qué ocurre?

Este error tiene tres causas principales:

Datos incorrectos en el archivo wp-config.php (nombre de la base de datos, usuario o contraseña mal escritos).
La base de datos no existe o no fue creada previamente en cPanel.
El usuario de la base de datos no tiene permisos asignados o no está vinculado a la base de datos.

Solución paso a paso

Paso 1: Verifica los datos en cPanel

Entra en tu panel de control de cPanel y busca la sección "Bases de datos MySQL". Ahí verás si la base de datos que pusiste en el archivo wp-config.php existe realmente. Anota el nombre exacto, porque en cPanel los nombres suelen estar prefijados con tu usuario (ejemplo: usuario_wp_bd).

Paso 2: Revisa el archivo wp-config.php

Accede a tu gestor de archivos (File Manager) o por FTP y abre el archivo wp-config.php en la raíz de tu WordPress. Busca estas tres líneas:

define('DB_NAME', 'tu_base_de_datos');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');

Asegúrate de que coinciden EXACTAMENTE con los datos que creaste en cPanel. Un simple espacio extra o una mayúscula mal puesta puede provocar este error.

Paso 3: Comprueba los permisos del usuario

En la misma sección de "Bases de datos MySQL" de cPanel, busca la opción "Añadir usuario a la base de datos". Selecciona tu usuario y tu base de datos y asegúrate de marcar la casilla "TODOS LOS PRIVILEGIOS". Luego guarda los cambios.

[TIP]: Si has creado la base de datos hace un momento, espera 2-3 minutos antes de intentar la instalación. A veces el sistema tarda unos segundos en propagar los permisos.

Error 2: Pantalla blanca de la muerte (WSOD – White Screen of Death)

La pantalla blanca WordPress es otro de los grandes clásicos. La página carga pero se queda en blanco, sin ningún mensaje de error visible. Esto es frustrante porque no te da ninguna pista de lo que ha fallado.

¿Por qué ocurre?

Las causas más comunes durante la instalación son:

Conflictos de plugins o temas (aunque si acabas de instalar, suele ser el tema por defecto).
Límite de memoria PHP agotado.
Errores de sintaxis en algún archivo modificado.

Solución paso a paso

Paso 1: Activa el modo debug de WordPress

Abre el archivo wp-config.php y busca la línea que dice:

define('WP_DEBUG', false);

Cámbiala por:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Guarda el archivo y recarga la página. Ahora se creará un archivo llamado debug.log en la carpeta wp-content. Ábrelo desde el File Manager y verás el error exacto que está provocando la pantalla blanca.

Paso 2: Aumenta el límite de memoria PHP

Añade esta línea justo después de la línea de debug:

define('WP_MEMORY_LIMIT', '256M');

[INFO]: Si no encuentras la línea de debug, puedes añadir ambas líneas al final del archivo, justo antes de la línea que dice /* That's all, stop editing! */.

Paso 3: Reemplaza el tema por defecto

Si el error persiste, ve a la carpeta wp-content/themes/ y renombra la carpeta del tema activo (por ejemplo, de twentytwentyfour a twentytwentyfour_backup). WordPress detectará que no hay tema válido y usará uno por defecto.

Error 3: Error 500 – Internal Server Error

El 500 error cPanel es un error genérico del servidor que puede aparecer en cualquier momento de la instalación o al intentar acceder a la web. Es especialmente molesto porque no especifica qué está mal.

¿Por qué ocurre?

Permisos de archivos incorrectos (por ejemplo, archivos con permisos 777 cuando deberían ser 644).
Archivo .htaccess corrupto.
Problemas con la versión de PHP o módulos faltantes.

Solución paso a paso

Paso 1: Revisa los permisos de archivos y carpetas

En el File Manager, selecciona todos los archivos de la raíz de WordPress y haz clic en "Permisos". Deben estar así:

Carpetas: 755
Archivos: 644
wp-config.php: 644 (nunca 666)

Paso 2: Renombra el archivo .htaccess

A veces el .htaccess generado automáticamente tiene líneas incompatibles. Renómbralo a .htaccess_bak y prueba a cargar la web. Si funciona, ve a Ajustes > Enlaces permanentes en el panel de WordPress y haz clic en "Guardar cambios" para regenerarlo.

Paso 3: Cambia la versión de PHP

En cPanel, busca "Selector de versión de PHP" o "MultiPHP Manager". Prueba a cambiar a una versión más reciente (PHP 8.1 o 8.2) o a una más estable (PHP 7.4) y guarda los cambios.

[WARNING]: No uses versiones de PHP muy antiguas (5.x o 7.0) porque WordPress ya no las soporta correctamente y generará errores de compatibilidad.

Error 4: "No se encontró la página" o "404 Not Found" tras instalar

Este error es muy habitual cuando instalas WordPress en una subcarpeta o cuando el archivo .htaccess no se configura bien. El usuario ve la página de inicio pero al navegar a otras secciones obtiene un 404.

¿Por qué ocurre?

Los enlaces permanentes no están configurados.
El módulo mod_rewrite de Apache no está activo.
El .htaccess no existe o está vacío.

Solución paso a paso

Paso 1: Regenera los enlaces permanentes

Entra en el panel de administración de WordPress (normalmente en tudominio.com/wp-admin). Ve a Ajustes > Enlaces permanentes, selecciona la opción "Nombre de la entrada" y haz clic en "Guardar cambios". Esto regenera el .htaccess automáticamente.

Paso 2: Verifica que mod_rewrite esté activo

Si estás usando Apache, contacta con tu proveedor de hosting o revisa en cPanel si tienes acceso a "Apache Handlers" o "Optimizar sitio web". En algunos casos, debes activar manualmente el módulo desde la configuración del servidor.

Paso 3: Crea un .htaccess manual

Si el archivo no se genera solo, crea uno nuevo en la raíz con este contenido:

# 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

[TIP]: Si tu WordPress está instalado en una subcarpeta, por ejemplo /blog, cambia RewriteBase / por RewriteBase /blog/.

Error 5: El instalador se queda en un bucle o no avanza

A veces el asistente de instalación de WordPress se queda cargando, da error de "No se pudo conectar" o no pasa del paso de selección de idioma. Esto es más común de lo que parece y suele estar relacionado con la configuración del servidor.

¿Por qué ocurre?

El servidor no cumple los requisitos mínimos de PHP.
La carpeta donde se subió WordPress tiene permisos incorrectos.
Hay un conflicto con el firewall o el mod_security de cPanel.

Solución paso a paso

Paso 1: Verifica los requisitos mínimos

WordPress requiere al menos PHP 7.4 y MySQL 5.6 o MariaDB 10.1. Ve a la sección "Información del servidor" o "Estado de WordPress" en cPanel para ver qué versiones tienes.

Paso 2: Sube WordPress de nuevo

A veces los archivos se suben incompletos. Borra todo el contenido de la carpeta donde intentas instalar y vuelve a subir los archivos de WordPress desde el instalador de Softaculous o desde el File Manager. Si usas FTP, asegúrate de usar modo binario.

Paso 3: Desactiva mod_security temporalmente

En cPanel, busca "Mod Security" y desactívalo temporalmente mientras haces la instalación. Algunas reglas de seguridad bloquean peticiones que el instalador de WordPress necesita.

[WARNING]: Vuelve a activar mod_security después de la instalación para mantener tu sitio protegido.

Preguntas frecuentes (FAQ)

¿Qué hago si sigo teniendo errores WordPress cPanel después de probar todo?

Si has seguido todos los pasos anteriores y el problema persiste, te recomiendo:

Revisar los logs de error en cPanel (sección "Errores" o "Registros de errores").
Contactar con tu proveedor de hosting. El soporte técnico puede ver errores a nivel de servidor que tú no puedes ver.
Si usas un panel alternativo como Syspanel, recuerda que el acceso se realiza por el puerto 2106 y que la gestión de bases de datos puede tener una interfaz ligeramente distinta, pero los conceptos son los mismos.

¿Es mejor instalar WordPress manualmente o con Softaculous?

Softaculous (o el instalador que traiga tu cPanel) es más rápido y evita errores típicos como el de base de datos WordPress. Sin embargo, la instalación manual te da más control y te ayuda a entender cómo funciona todo. Si eres principiante, te recomiendo usar el instalador automático.

¿Cómo puedo evitar estos errores en el futuro?

Mantén siempre actualizado WordPress, los plugins y los temas.
Haz copias de seguridad periódicas.
No modifiques archivos del núcleo de WordPress.
Usa contraseñas fuertes para la base de datos y el usuario de cPanel.

Conclusión final

Los errores al instalar WordPress en cPanel son más comunes de lo que parece, pero casi todos tienen una solución clara y sencilla si sabes dónde mirar. Hemos cubierto los 5 errores más comunes: el fallo de conexión con la base de datos, la pantalla blanca, el error 500, los problemas con los enlaces permanentes y el bucle en el instalador.

Recuerda que la paciencia es clave. No saltes directamente a borrar todo y empezar de cero: primero investiga, revisa los logs y prueba las soluciones una a una. La mayoría de las veces, el problema está en un simple dato mal escrito o en un permiso de archivo incorrecto.

Si después de leer esta guía sigues atascado, busca ayuda en los foros oficiales de WordPress o en el soporte de tu hosting. Y si tu panel es Syspanel, recuerda que el acceso se hace por el puerto 2106 y que el proceso de instalación de WordPress es prácticamente idéntico al de cPanel.

Espero que esta guía te haya sido de utilidad. Ahora ve y domina tu instalación de WordPress sin miedo a los errores. ¡Buena suerte!