Errores comunes al instalar WordPress y cómo solucionarlos

Instalar WordPress suele ser un proceso sencillo, pero cuando te topas con un error, puede ser frustrante, sobre todo si no tienes experiencia técnica. La mayoría de estos problemas tienen una solución clara y no requieren ser un experto en servidores. En esta guía extensa, vamos a desglosar los errores más frecuentes que ocurren durante la instalación de WordPress en un hosting, y te explicaré paso a paso cómo solucionarlos.

Vamos a centrarnos en los puntos críticos: la conexión a la base de datos, los permisos de archivos, la configuración del servidor y algunos problemas típicos de acceso. Al final, tendrás un checklist para resolver cualquier contratiempo.

1. El temido "Error al establecer conexión con la base de datos"

Este es, con diferencia, el error más común. Aparece justo cuando terminas de introducir los datos de tu base de datos en el asistente de instalación de WordPress. La pantalla se queda en blanco o muestra un mensaje que dice algo como "Error al establecer conexión con la base de datos".

¿Por qué ocurre?

WordPress necesita comunicarse con una base de datos (normalmente MySQL o MariaDB) para guardar toda tu información: entradas, páginas, usuarios, etc. Si los datos de conexión no son correctos, o si la base de datos no existe o no está accesible, se produce este error.

Solución paso a paso

Verifica los datos en el archivo wp-config.php: Accede a tu hosting mediante FTP o al administrador de archivos del panel de control (si usas Syspanel, el acceso es por el puerto 2106). Busca el archivo wp-config.php en la raíz de tu instalación de WordPress. Ábrelo con un editor de texto. Busca estas líneas:
```
define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_base_datos');
define('DB_HOST', 'localhost');
```
Asegúrate de que el nombre, usuario y contraseña coincidan exactamente con los que creaste en tu hosting. Un error muy común es escribir mal la contraseña o confundir el nombre de la base de datos con el del usuario.
Comprueba el servidor de la base de datos (DB_HOST): En la mayoría de los hostings, el servidor de base de datos es localhost. Sin embargo, algunos proveedores (como los que usan paneles como cPanel o Syspanel) pueden tener un servidor diferente, por ejemplo, mysql.tudominio.com o 127.0.0.1. Revisa la documentación de tu hosting o pregunta al soporte. Si usas Syspanel, suele ser localhost, pero verifica en la sección de Bases de Datos del panel.
Confirma que la base de datos existe y tiene un usuario asignado: Entra en el panel de control de tu hosting (por ejemplo, Syspanel en el puerto 2106). Busca la sección de "Bases de Datos" o "MySQL". Asegúrate de que la base de datos que pusiste en DB_NAME esté creada. Luego, verifica que el usuario de DB_USER esté asociado a esa base de datos y que tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si no lo está, asígnalo desde el panel.
Reinicia el servicio de base de datos (si tienes acceso): Si tienes acceso a la terminal de tu servidor (VPS o dedicado), puedes reiniciar MySQL/MariaDB. En sistemas Linux, el comando suele ser:
```
sudo systemctl restart mysql
# o
sudo systemctl restart mariadb
```
Si estás en un hosting compartido, no podrás hacer esto; contacta al soporte.

[TIP] Si después de todo sigue fallando, prueba a cambiar localhost por 127.0.0.1 en el archivo wp-config.php. A veces el sistema de resolución de nombres falla.

2. Pantalla blanca de la muerte (WSOD) durante la instalación

La famosa "White Screen of Death" (WSOD) es una página en blanco sin ningún mensaje de error. Puede aparecer justo después de la instalación o al intentar acceder al panel de administración.

Causas comunes

Problemas de memoria PHP: WordPress o algún plugin (incluso los que vienen por defecto) requiere más memoria de la que tu hosting tiene asignada.
Error en un plugin o tema: Aunque estés en la instalación inicial, a veces el asistente carga algún script que falla.
Permisos de archivos incorrectos: El servidor web no puede leer o escribir ciertos archivos.

Solución paso a paso

Aumenta la memoria PHP: Localiza el archivo wp-config.php y añade esta línea justo antes del comentario "¡Eso es todo, deja de editar!":
```
define('WP_MEMORY_LIMIT', '256M');
```
Si no funciona, prueba con 512M. Guarda el archivo y recarga la página.
Activa el modo debug de WordPress: En el mismo wp-config.php, busca define('WP_DEBUG', false); y cámbialo a true. También añade estas líneas:
```
define('WP_DEBUG_DISPLAY', true);
define('WP_DEBUG_LOG', true);
```
Esto hará que los errores se muestren en pantalla (si no hay WSOD) o se guarden en un archivo wp-content/debug.log. Vuelve a cargar la página de instalación. Si ves un error específico (por ejemplo, "Fatal error: Call to undefined function..."), búscalo en Google o compártelo con el soporte.
Verifica los permisos de archivos y carpetas: Los permisos incorrectos son una causa frecuente. Conecta por FTP y asegúrate de que:
- Todas las carpetas tengan permisos 755 (o 750 en algunos servidores).
- Todos los archivos (excepto wp-config.php) tengan permisos 644.
- La carpeta wp-content y sus subcarpetas (uploads, plugins, themes) tengan permisos 755 para que WordPress pueda escribir en ellas.
  Puedes cambiar permisos desde el cliente FTP (clic derecho > "Permisos de archivo") o desde el administrador de archivos de Syspanel.

[WARNING] No pongas permisos 777 a ninguna carpeta o archivo. Es un grave riesgo de seguridad. Si tu hosting te obliga a usar 777 para que funcione la subida de archivos, cambia de hosting.

3. Error "Headers already sent" o "Cannot modify header information"

Este error aparece como un texto feo antes de que se cargue la página, o como un mensaje en el panel de administración. Indica que se ha enviado información (como HTML o espacios en blanco) antes de que WordPress pueda enviar las cabeceras HTTP necesarias.

Causas comunes

Espacios en blanco o saltos de línea al inicio o final del archivo wp-config.php: Es el motivo más frecuente.
Archivos de plugins o temas con errores: A veces, aunque no los hayas activado, el simple hecho de tenerlos en la carpeta puede causar problemas.
Problemas con la codificación del archivo: Si el archivo wp-config.php se guardó con BOM (Byte Order Mark) o con una codificación incorrecta.

Solución paso a paso

Revisa el archivo wp-config.php: Ábrelo con un editor de texto plano (como Notepad++ o Sublime Text, nunca con Word o WordPad). Asegúrate de que no haya ningún espacio, salto de línea o carácter antes de <?php al principio del archivo. Tampoco debe haber nada después del ?> final (de hecho, lo mejor es eliminar el ?> final, ya que no es necesario y suele causar problemas). Guarda el archivo sin BOM (en Notepad++, ve a "Codificación" > "Codificar en UTF-8 sin BOM").
Desactiva todos los plugins manualmente: Si ya has instalado WordPress y el error persiste, conecta por FTP, ve a la carpeta wp-content/plugins y renombra la carpeta entera a plugins_old. Esto desactivará todos los plugins. Si el error desaparece, significa que uno de los plugins era el culpable. Ve renombrándolos de uno en uno para identificar al infractor.
Cambia a un tema por defecto: Similar a los plugins, renombra la carpeta wp-content/themes/tu-tema a tu-tema_old. WordPress usará automáticamente el tema por defecto (Twenty Twenty-Four o similar). Si el error se soluciona, el problema está en tu tema.

4. Error de "Permisos insuficientes" al subir archivos o instalar plugins

Este error suele aparecer cuando intentas subir una imagen, instalar un plugin o actualizar WordPress desde el panel de administración. Te dice algo como "No se pudo crear el directorio" o "Error al mover el archivo subido".

Causas comunes

Permisos incorrectos en la carpeta wp-content/uploads.
El propietario de los archivos no es el usuario del servidor web (por ejemplo, en servidores con PHP-FPM y diferentes usuarios).
Problemas con el límite de tamaño de subida en PHP.

Solución paso a paso

Corrige los permisos de la carpeta uploads: Conecta por FTP y ve a wp-content/uploads. Si la carpeta no existe, créala. Dale permisos 755 (o 750 si tu hosting lo exige). A veces, en servidores con configuraciones estrictas, necesitas 775 (permite escritura al grupo). Si no estás seguro, prueba con 755 primero.
Verifica el propietario de los archivos: Si tienes acceso a la terminal (VPS), ejecuta:
```
ls -la
```
Deberías ver que los archivos pertenecen al usuario del servidor web (normalmente www-data, nobody, o el usuario de tu plan de hosting). Si los archivos son tuyos pero el servidor no puede escribir, puedes cambiar el propietario con:
```
sudo chown -R www-data:www-data /ruta/a/tu/wordpress
```
En Syspanel, esto se gestiona automáticamente si usas el asistente de instalación, pero si instalaste manualmente, contacta al soporte para que ajusten los permisos.
Aumenta el límite de subida de archivos: Crea o edita un archivo llamado php.ini en la raíz de tu WordPress (o en la carpeta wp-admin). Añade estas líneas:
```
upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
max_execution_time = 300
```
Guarda el archivo. Si no funciona, contacta a tu hosting para que lo configuren a nivel de servidor.

[INFO] En Syspanel, puedes ajustar estos valores desde la sección "Configuración PHP" del panel (puerto 2106). Busca la opción "Editar configuración PHP" y modifica los parámetros.

5. Error "La conexión se ha restablecido" o "El servidor no responde"

Este error suele ocurrir al principio de la instalación, cuando intentas acceder al archivo wp-admin/install.php. El navegador se queda cargando y luego muestra un mensaje de que la conexión se ha restablecido.

Causas comunes

El servidor web (Apache, Nginx) no está configurado correctamente.
Falta el módulo mod_rewrite (en Apache) o la configuración de reescritura (en Nginx).
Problemas con el archivo .htaccess.

Solución paso a paso

Verifica que el servidor web esté funcionando: Si tienes acceso a Syspanel, ve a "Servicios" y asegúrate de que Apache o Nginx estén en verde (activos). Si no, reinícialos desde allí.
Comprueba el archivo .htaccess: Asegúrate de que exista un archivo .htaccess en la raíz de tu WordPress. Si no existe, créalo con el siguiente 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
```
Si el archivo ya existe pero está corrupto, renómbralo a .htaccess_old y crea uno nuevo con el código de arriba.
Verifica que mod_rewrite esté habilitado: Si tu hosting usa Apache, pide al soporte que activen el módulo mod_rewrite. En Syspanel, puedes hacerlo desde "Configuración del servidor" > "Módulos Apache". Si usas Nginx, la configuración de reescritura suele venir por defecto, pero puedes pedir ayuda al soporte.

6. Error de "Base de datos no encontrada" o "Table doesn't exist"

Este error puede aparecer durante la instalación o al intentar acceder al sitio. Indica que WordPress no encuentra las tablas necesarias en la base de datos.

Causas comunes

La instalación no se completó correctamente (por ejemplo, se interrumpió la conexión).
El prefijo de las tablas es incorrecto.
La base de datos está corrupta.

Solución paso a paso

Reinstala WordPress desde cero: Si la instalación se interrumpió, lo más limpio es borrar todo (archivos y base de datos) y volver a empezar. Asegúrate de tener una copia de seguridad si ya habías subido contenido.
Verifica el prefijo de las tablas: En tu wp-config.php, busca:
```
$table_prefix = 'wp_';
```
Asegúrate de que coincida con el prefijo que usaste al crear la base de datos. Si no lo recuerdas, puedes mirar en Syspanel en la sección de Bases de Datos, o conectar a la base de datos con phpMyAdmin y ver los nombres de las tablas (ej: wp_posts, wp_options).
Repara la base de datos: Si las tablas existen pero están corruptas, puedes intentar repararlas. Añade esta línea a tu wp-config.php:
```
define('WP_ALLOW_REPAIR', true);
```
Luego, visita http://tudominio.com/wp-admin/maint/repair.php. Verás una opción para "Reparar base de datos". Haz clic y espera. Una vez terminado, borra esa línea del wp-config.php por seguridad.

[WARNING] No dejes WP_ALLOW_REPAIR activado permanentemente, ya que cualquiera podría acceder a esa URL y dañar tu base de datos.

7. Error "No se puede conectar al servidor FTP" al instalar plugins o temas

Este error aparece cuando intentas instalar algo desde el panel de administración y WordPress te pide credenciales de FTP, o te dice que no puede conectar.

Causas comunes

El servidor web no tiene permisos para escribir en los directorios.
Falta la configuración de FS_METHOD en wp-config.php.
El servidor FTP no está configurado o no es accesible.

Solución paso a paso

Define el método de sistema de archivos: Añade esta línea a tu wp-config.php:
```
define('FS_METHOD', 'direct');
```
Esto le dice a WordPress que intente escribir directamente en el sistema de archivos, sin pasar por FTP. Si tu hosting tiene los permisos correctos (el usuario del servidor web es el propietario), funcionará.
Si el método direct no funciona, usa FTP: Si tu hosting requiere FTP, asegúrate de tener un usuario FTP creado. En Syspanel, ve a "Usuarios FTP" y crea uno. Luego, en la pantalla de credenciales de WordPress, introduce los datos: servidor (normalmente localhost o tudominio.com), usuario, contraseña y ruta (suele ser /public_html o la raíz de tu WordPress).