Errores frecuentes al instalar WordPress | Soluciones rápidas

¡Hola! Soy tu técnico de soporte amigable. Entiendo lo frustrante que puede ser cuando intentas instalar WordPress y te encuentras con pantallas en blanco, errores de conexión a la base de datos o mensajes crípticos. Tranquilo, es más común de lo que crees y casi siempre tiene una solución sencilla.

En esta guía extensa, vamos a repasar los errores comunes en la instalación de WordPress y, paso a paso, cómo solucionar WordPress para que tu sitio web funcione a la perfección. Este artículo está pensado para administradores de sistemas (SysAdmin) y usuarios que están dando sus primeros pasos. Al final, encontrarás una sección FAQ con las dudas más frecuentes.

Vamos a ello.

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

Este es, con diferencia, el error más habitual cuando intentas instalar WordPress. Verás un mensaje como: "Error al establecer una conexión con la base de datos". No te asustes, no se ha roto nada.

¿Por qué ocurre?

Las causas principales son tres:

Los datos de acceso a la base de datos son incorrectos en el archivo wp-config.php.
La base de datos no existe o el usuario no tiene permisos sobre ella.
El servidor de base de datos (MySQL/MariaDB) no está funcionando o no acepta conexiones.

¿Cómo solucionarlo?

Verifica el archivo wp-config.php: Busca en la raíz de tu instalación de WordPress (normalmente en /public_html o /www) el archivo wp-config.php. Ábrelo con un editor de texto (como Notepad++ o el editor de archivos de tu panel de control).
Revisa las constantes de conexión: Busca estas cuatro líneas y asegúrate de que coinciden exactamente con los datos que te proporcionó tu hosting o tu panel de administración (como cPanel, Syspanel o Plesk):
```
define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'usuario_de_la_base_de_datos' );
define( 'DB_PASSWORD', 'contraseña_segura' );
define( 'DB_HOST', 'localhost' );
```
[TIP] El valor de DB_HOST suele ser localhost, pero algunos proveedores usan una dirección IP o un nombre de servidor. Consúltalo con tu soporte.
Comprueba que la base de datos existe: Desde tu panel de control (por ejemplo, Syspanel, accesible en tu-dominio.com:2106), busca la sección de bases de datos. Asegúrate de que la base de datos con el nombre que pusiste en DB_NAME esté creada y que el usuario DB_USER tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.) sobre ella.
Reinicia el servicio MySQL: Si tienes acceso SSH, puedes ejecutar:
```
sudo systemctl restart mysql
# o en algunos sistemas:
sudo systemctl restart mariadb
```
Si usas un panel como Syspanel, suele haber un botón de "Reiniciar servicios" en la sección de configuración del servidor.

2. Pantalla blanca de la muerte (WSOD)

La temida pantalla en blanco. No ves nada, solo un fondo blanco. Esto indica que PHP ha encontrado un error fatal, pero la visualización de errores está desactivada.

¿Por qué ocurre?

Un plugin o tema incompatible.
Límite de memoria de PHP agotado.
Error de sintaxis en un archivo (por ejemplo, al editar functions.php).

¿Cómo solucionarlo?

Activar la visualización de errores: Temporalmente, añade estas líneas al principio de wp-config.php, justo después de la línea que pone <?php:
```
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', true );
@ini_set( 'display_errors', 1 );
```
[WARNING] No dejes esto activado en un sitio en producción, ya que expone información sensible. Desactívalo después de solucionar el error.
Revisa el archivo de log: WordPress creará un archivo wp-content/debug.log. Descárgalo o ábrelo con un editor. Busca líneas como PHP Fatal error o PHP Parse error. Te indicará el archivo y la línea exacta del problema.
Desactiva plugins manualmente: Si no puedes acceder al panel de administración, renombra la carpeta wp-content/plugins a wp-content/plugins_old mediante FTP o el administrador de archivos de tu panel. Esto desactivará todos los plugins. Si el sitio vuelve a funcionar, reactiva uno por uno renombrando la carpeta de nuevo hasta encontrar el culpable.
Aumenta el límite de memoria de PHP: En wp-config.php, añade esta línea:
```
define( 'WP_MEMORY_LIMIT', '256M' );
```
Si eso no funciona, contacta con tu hosting o ajusta el valor en el archivo php.ini (si tienes acceso): memory_limit = 256M.

3. Error "Headers already sent"

Este error aparece como un mensaje feo al principio de la página, a menudo con texto como "Warning: Cannot modify header information - headers already sent by...".

¿Por qué ocurre?

Hay espacios en blanco o caracteres (como una línea vacía) antes de <?php o después de ?> en el archivo wp-config.php o en functions.php.
Algún plugin o tema está enviando contenido HTML antes de que WordPress envíe las cabeceras HTTP.

¿Cómo solucionarlo?

Abre wp-config.php con un editor de código (como VS Code, Sublime Text o incluso el bloc de notas, pero cuidado con los saltos de línea). Asegúrate de que no hay líneas en blanco antes de la etiqueta <?php al principio del archivo. El archivo debe empezar exactamente así:
```
<?php
/**
 * The base configuration for WordPress
 */
```
Elimina la etiqueta de cierre ?> al final del archivo. Esta etiqueta es opcional en PHP y, si dejas un espacio o un salto de línea después, provoca este error. Simplemente, borra el ?> final. El archivo debe terminar con una línea de código o un salto de línea, pero sin la etiqueta de cierre.
Revisa el archivo functions.php de tu tema: Si el error menciona ese archivo, ábrelo y busca espacios o líneas en blanco antes de <?php o después de ?>.

4. Error 500 Internal Server Error

Un error genérico que suele deberse a un problema de configuración del servidor o de permisos de archivos.

¿Por qué ocurre?

Permisos incorrectos en archivos o carpetas.
Archivo .htaccess corrupto o con reglas incorrectas.
Límite de memoria excedido (como en el punto 2).

¿Cómo solucionarlo?

Revisa los permisos de archivos: Los archivos deben tener permiso 644 y las carpetas 755. Puedes cambiarlos desde tu panel de control (Syspanel, cPanel) o mediante FTP. Conecta por FTP, selecciona toda la carpeta de WordPress y asigna los permisos de forma recursiva.
Renombra el archivo .htaccess: Localiza el archivo .htaccess en la raíz de WordPress. Renómbralo a .htaccess_old. Si el error desaparece, el problema está en ese archivo. Luego, ve a Ajustes > Enlaces permanentes en el panel de WordPress y haz clic en "Guardar cambios" para regenerarlo.
Aumenta el límite de ejecución de PHP: Añade en wp-config.php:
```
set_time_limit( 300 );
```
O edita el php.ini con: max_execution_time = 300.

5. WordPress no instala: el asistente no se carga

Has subido los archivos, pero al ir a tudominio.com no aparece el asistente de instalación de WordPress. Solo ves el índice del servidor o una página en blanco.

¿Por qué ocurre?

Los archivos no se han subido a la carpeta correcta (por ejemplo, dentro de una subcarpeta como wordpress).
El archivo index.php no está en la raíz del dominio.
El servidor web no está configurado para servir PHP.

¿Cómo solucionarlo?

Verifica la ubicación de los archivos: Asegúrate de que los archivos de WordPress (wp-config-sample.php, wp-content, etc.) están directamente en la carpeta pública de tu dominio (normalmente public_html o www). No deben estar dentro de una subcarpeta a menos que quieras usar una subcarpeta (por ejemplo, tudominio.com/blog).
Comprueba que el servidor interpreta PHP: Crea un archivo llamado info.php en la raíz con este contenido:
```
<?php phpinfo(); ?>
```
Accede a tudominio.com/info.php. Si ves una página con información de PHP, el servidor funciona. Si ves el código o una descarga, el servidor no tiene PHP activado. Contacta con tu hosting.
Revisa el archivo index.php: Descarga WordPress de nuevo desde wordpress.org y asegúrate de que el archivo index.php está presente en la raíz. Si falta, súbelo.

6. Error de conexión FTP durante la instalación

Al intentar instalar un plugin o tema desde el panel de administración, WordPress te pide credenciales FTP. Esto es frustrante, pero se solucina fácil.

¿Por qué ocurre?

El servidor web no tiene permisos de escritura sobre los archivos de WordPress.
La configuración de wp-config.php no define el método de conexión directa.

¿Cómo solucionarlo?

Define el método de conexión directa: Añade esta línea a wp-config.php:
```
define('FS_METHOD', 'direct');
```
Esto le dice a WordPress que intente escribir directamente los archivos, sin usar FTP.
Ajusta los permisos del usuario del servidor: El usuario que ejecuta PHP (normalmente www-data o nobody) debe ser propietario de los archivos. Si tienes acceso SSH, ejecuta:
```
sudo chown -R www-data:www-data /ruta/a/tu/wordpress
```
Si usas Syspanel, busca la opción "Reparar permisos" o "Propietario de archivos" en la sección de archivos.
Si nada funciona, usa FTP manual: Descarga el plugin/tema, súbelo manualmente a wp-content/plugins o wp-content/themes mediante FTP, y actívalo desde el panel.

7. Problemas con los enlaces permanentes

Después de instalar WordPress, los enlaces de las entradas no funcionan (error 404). Esto es muy común.

¿Por qué ocurre?

El módulo mod_rewrite de Apache no está activado.
El archivo .htaccess no tiene permisos de escritura o no se ha generado.

¿Cómo solucionarlo?

Activa mod_rewrite: Si tienes acceso SSH, ejecuta:
```
sudo a2enmod rewrite
sudo systemctl restart apache2
```
Si usas un panel como Syspanel, ve a la configuración del servidor web y asegúrate de que "AllowOverride" esté habilitado para tu dominio.
Regenera el .htaccess: En el panel de WordPress, ve a Ajustes > Enlaces permanentes, elige cualquier estructura (por ejemplo, "Nombre de la entrada") y haz clic en "Guardar cambios". Esto fuerza a WordPress a escribir el .htaccess correcto.
Da permisos de escritura al .htaccess: Temporalmente, pon el archivo .htaccess con permiso 666 (si no existe, créalo vacío). Después de guardar los enlaces permanentes, vuelve a ponerlo a 644.

FAQ: Preguntas frecuentes sobre errores en la instalación de WordPress

Aquí tienes las respuestas a las dudas más habituales que resuelven a diario los SysAdmin.

P: ¿Por qué aparece "Error de conexión a la base de datos" incluso con datos correctos?
R: A menudo el servidor de base de datos no está accesible. Verifica que MySQL esté corriendo (sudo systemctl status mysql). También comprueba que el host de la base de datos sea el correcto (a veces es localhost o una IP específica).

P: ¿Cómo puedo instalar WordPress sin usar FTP?
R: La mejor forma es definir FS_METHOD como direct en wp-config.php. Si no funciona, asegúrate de que los archivos pertenezcan al usuario del servidor web (por ejemplo, www-data).

P: Después de subir WordPress, veo el índice de archivos en lugar del sitio. ¿Qué hago?
R: Esto significa que no hay un archivo index.php en la raíz o que el servidor no está configurado para servirlo. Verifica que hayas subido los archivos dentro de la carpeta pública y no dentro de una subcarpeta como "wordpress".

P: ¿Es seguro usar Syspanel para gestionar mi WordPress?
R: Sí, Syspanel (accesible en tu-dominio.com:2106) es una herramienta segura y fácil para administrar bases de datos, archivos y servicios. Solo asegúrate de usar contraseñas fuertes y mantener actualizado el panel.

P: Mi WordPress está muy lento después de la instalación. ¿Qué puede ser?
R: Puede deberse a un límite de memoria bajo, un plugin pesado o un tema mal optimizado. Aumenta el límite de memoria en wp-config.php (a 256M o 512M) y desactiva plugins uno por uno para identificar el culpable.

P: ¿Cómo puedo saber si el error es del servidor o de WordPress?
R: Activa el modo debug en wp-config.php como te expliqué en el punto 2. Si aparece un error específico, es de WordPress. Si solo ves una pantalla en blanco o un error 500, puede ser del servidor. Revisa los logs del servidor (en /var/log/apache2/error.log o desde Syspanel).

P: ¿Qué hago si olvidé la contraseña de la base de datos?
R: Puedes cambiarla desde Syspanel o desde la línea de comandos con mysqladmin -u root -p password nueva_contraseña. Luego actualiza wp-config.php.

Resumen y consejos finales

La mayoría de los errores comunes en la instalación de WordPress se deben a problemas de configuración simples: permisos incorrectos, datos de base de datos mal escritos o límites de PHP bajos. Con esta guía, ya tienes las herramientas para solucionar WordPress sin necesidad de ser un experto.

Recuerda:

Siempre haz una copia de seguridad antes de modificar archivos críticos.
Usa un panel de control como Syspanel (puerto 2106) para tareas administrativas, es más seguro que editar archivos a mano.
Si un error persiste, revisa los logs (debug.log y logs del servidor). Ellos te darán la pista definitiva.

Si después de seguir todos estos pasos WordPress no instala o el error continúa, no dudes en contactar con el soporte técnico de tu hosting. Muchas veces hay configuraciones del servidor que solo ellos pueden ajustar.

Espero que esta guía te haya sido de gran ayuda. ¡Ahora ya puedes lanzar tu sitio web con confianza! Si tienes más dudas, recuerda: estamos aquí para ayudarte.