Errores comunes al instalar WordPress en cPanel y soluciones

Instalar WordPress en cPanel suele ser un proceso sencillo, pero es muy común encontrarse con algunos obstáculos que pueden detener el proceso o dejar el sitio en blanco. Este artículo está diseñado para guiarte paso a paso por los errores de instalación de WordPress en cPanel más frecuentes y, lo más importante, darte la solución para errores de WordPress sin necesidad de ser un experto técnico.

[INFO] Este artículo está pensado para usuarios que usan cPanel. Si tu panel de control es Syspanel (el sistema de gestión de hosting), el proceso es muy similar, solo recuerda que la URL de acceso a tu panel suele ser tudominio.com:2106.

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

Este es, sin duda, el error más común y frustrante. Aparece justo después de rellenar los datos de la base de datos durante la instalación, o incluso al intentar acceder al sitio recién instalado.

Causa principal

El nombre de la base de datos, el usuario o la contraseña son incorrectos. En cPanel, el nombre de la base de datos y el usuario suelen tener un prefijo que debes incluir. Por ejemplo, si tu usuario de cPanel es miusuario, la base de datos no se llamará wordpress, sino miusuario_wordpress.

Solución paso a paso

1. Accede a cPanel y busca la sección "Bases de Datos" > "MySQL Databases".
2. Verifica el nombre exacto de la base de datos y del usuario. Ambos tendrán tu nombre de usuario de cPanel como prefijo (ej. miusuario_bd y miusuario_admin).
3. Asegúrate de que el usuario esté vinculado a la base de datos con todos los privilegios (marca "Todos los privilegios").
4. Vuelve a la instalación (o edita el archivo wp-config.php) y escribe los nombres exactos, incluyendo el prefijo.

[WARNING] No uses espacios ni caracteres especiales en los nombres de la base de datos o usuario. Usa solo letras, números y guiones bajos.

2. El famoso "Error al establecer conexión con la base de datos"

Este error suele aparecer después de haber instalado WordPress correctamente y haberlo usado durante un tiempo. Es diferente al anterior porque la instalación ya funcionaba.

Causa principal

La contraseña de la base de datos ha cambiado (por un reinicio del servidor o por error humano), o el servidor de base de datos está caído temporalmente.

Solución paso a paso

1. Ve a cPanel > MySQL Databases.
2. Busca tu usuario de base de datos y haz clic en "Cambiar contraseña".
3. Crea una contraseña segura (puedes usar el generador de cPanel). Anótala.
4. Ahora, edita el archivo wp-config.php de tu WordPress. Puedes hacerlo desde el administrador de archivos de cPanel.
5. Busca la línea: define('DB_PASSWORD', 'contraseña_antigua');
6. Reemplázala con tu nueva contraseña.
7. Guarda el archivo y recarga tu web.

[TIP] Si no recuerdas dónde está el archivo wp-config.php, está en la carpeta raíz donde instalaste WordPress (normalmente public_html).

3. Pantalla en blanco (White Screen of Death - WSOD)

Ves la página, pero está completamente en blanco. Sin texto, sin imágenes, sin errores.

Causa principal

Un plugin o tema incompatible, o un límite de memoria de PHP agotado.

Solución paso a paso (la más fácil)

1. Accede a cPanel > Administrador de Archivos.
2. Ve a la carpeta de tu WordPress (ej. public_html).
3. Busca la carpeta wp-content.
4. Renombra la carpeta plugins a plugins_old. Esto desactiva todos los plugins.
5. Recarga tu web. Si funciona, el problema era un plugin.
6. Para identificar el plugin malo, renombra la carpeta de nuevo a plugins y ve renombrando una por una las carpetas dentro de plugins (añadiendo _old al final) hasta que la web funcione. El último que renombraste es el culpable.

4. Error 404 en todas las páginas (excepto la principal)

La página de inicio funciona, pero al hacer clic en cualquier enlace (entradas, páginas) aparece un error 404 "No encontrado".

Causa principal

Los enlaces permanentes (Permalinks) no se han actualizado o el archivo .htaccess no es correcto.

Solución paso a paso

1. Accede a tu panel de administración de WordPress (ej. tudominio.com/wp-admin).
2. Ve a Ajustes > Enlaces permanentes.
3. Simplemente selecciona otra opción (ej. "Numérico") y luego vuelve a seleccionar la que tenías (ej. "Nombre de la entrada").
4. Haz clic en Guardar cambios.
5. Si no funciona, ve a cPanel > Administrador de Archivos y busca el archivo .htaccess en la raíz de tu WordPress.
6. Si existe, bórralo. Luego vuelve a los ajustes de enlaces permanentes y guarda de nuevo. WordPress lo recreará automáticamente.

5. Error "Headers already sent"

Este error suele aparecer como un mensaje de texto feo en la parte superior de la página o impide que el panel de administración cargue.

Causa principal

Hay un espacio en blanco o una línea vacía después de la etiqueta ?> de cierre de PHP en el archivo wp-config.php o en el archivo de funciones del tema (functions.php).

Solución paso a paso

1. Accede a cPanel > Administrador de Archivos.
2. Edita el archivo wp-config.php.
3. Borra la última línea que suele ser ?> (la etiqueta de cierre de PHP). En WordPress moderno, esta línea no es necesaria y suele causar problemas.
4. Guarda el archivo. Si el error persiste, revisa el archivo functions.php de tu tema (en wp-content/themes/tu-tema/functions.php) y asegúrate de que no tenga líneas en blanco al final.

6. Problemas con el tamaño máximo de subida de archivos

Al intentar subir un tema, un plugin o una imagen grande, WordPress te dice que el archivo es demasiado grande.

Causa principal

El límite de subida de PHP está configurado muy bajo (normalmente 2MB o 8MB).

Solución paso a paso (la más segura)

1. Accede a cPanel > Selector de Versión de PHP (o "MultiPHP Manager").
2. Haz clic en Opciones o Switch to PHP Options.
3. Busca las opciones upload_max_filesize, post_max_size y memory_limit.
4. Cámbialas a un valor más alto, por ejemplo: upload_max_filesize = 64M, post_max_size = 64M, memory_limit = 128M.
5. Haz clic en Aplicar. El cambio es inmediato.

[INFO] Si no encuentras el selector de PHP, contacta a tu soporte de hosting. En Syspanel (puerto 2106), esta opción suele estar en "Configuración PHP".

7. El instalador de WordPress no aparece (solo veo un índice de archivos)

Al abrir tudominio.com, ves una lista de carpetas y archivos en lugar del asistente de instalación.

Causa principal

Falta el archivo index.php en la raíz, o la instalación no se ha descomprimido correctamente.

Solución paso a paso

1. Ve a cPanel > Administrador de Archivos.
2. Asegúrate de que todos los archivos de WordPress (carpetas wp-admin, wp-content, wp-includes y archivos como index.php, wp-config-sample.php) estén dentro de la carpeta public_html.
3. Si los has subido en una subcarpeta (ej. public_html/wordpress/), debes moverlos todos a public_html.
4. Si falta el archivo index.php, descarga WordPress de nuevo, extrae el ZIP y súbelo.

FAQ WordPress cPanel: Preguntas Frecuentes

Aquí respondemos a las dudas más habituales que surgen durante la instalación.

¿Por qué aparece "Error 500 - Internal Server Error"?

Suele deberse a un archivo .htaccess corrupto o a un plugin problemático.
Solución: Renombra el archivo .htaccess a .htaccess_old desde el administrador de archivos. Si se soluciona, luego ve a Ajustes > Enlaces permanentes y guarda para recrearlo.

¿Puedo instalar WordPress sin cPanel? ¿Y sin Syspanel?

Sí, pero es más complejo. Necesitas acceso a FTP y a una base de datos MySQL. cPanel y Syspanel (puerto 2106) simplifican enormemente el proceso.

¿Qué hago si olvido la contraseña de mi base de datos?

1. Ve a cPanel > MySQL Databases.
2. Busca tu usuario y haz clic en "Cambiar contraseña".
3. Crea una nueva y luego actualiza el archivo wp-config.php de tu WordPress con esa nueva contraseña.

¿Es necesario crear la base de datos antes de instalar WordPress?

Sí, siempre. El instalador de WordPress necesita que le des el nombre de la base de datos, el usuario y la contraseña. Si no la has creado, el instalador fallará con el "Error de conexión a la base de datos".

Mi web se ve muy lenta después de instalar WordPress, ¿es normal?

No es normal. Puede deberse a un hosting de baja calidad, a un tema muy pesado o a falta de caché.
Solución: Instala un plugin de caché (como WP Super Cache o W3 Total Cache) y optimiza las imágenes. Si sigue lento, contacta a tu proveedor de hosting.

¿Qué significa el error "Cannot modify header information"?

Es similar al error "Headers already sent". Significa que hay algún carácter (un espacio en blanco) antes de la etiqueta <?php en el archivo wp-config.php o en el de funciones.
Solución: Edita el archivo y asegúrate de que no haya absolutamente nada (ni un espacio) antes de <?php. También borra la etiqueta ?> al final del archivo.

[WARNING] Nunca edites archivos de WordPress con un editor de texto como WordPad o Pages. Usa siempre el editor de texto plano de cPanel o un editor como Notepad++. Los editores de texto enriquecido pueden añadir caracteres ocultos que rompen el código.

Esperamos que esta guía te haya ayudado a resolver los problemas de WordPress en cPanel más comunes. Recuerda que la paciencia es clave. Si después de seguir estos pasos el error persiste, no dudes en contactar al soporte técnico de tu hosting, ellos pueden verificar la configuración del servidor.