Errores comunes al instalar WordPress y cómo solucionarlos

¡Hola! Soy tu técnico de soporte amigable. Si has llegado hasta aquí es porque estás intentando instalar WordPress y te has topado con algún error. No te preocupes, es más común de lo que crees. En esta guía vamos a repasar los errores de instalación de WordPress más frecuentes, cómo identificarlos y, lo más importante, cómo solucionarlos. Vamos a ello, paso a paso.

Conexión a la base de datos: el error más común

El error más típico durante la instalación es el famoso "Error al establecer conexión con la base de datos". Esto suele aparecer justo al hacer clic en "Enviar" en el formulario de configuración de la base de datos.

¿Por qué ocurre?

Este problema casi siempre se debe a que los datos de conexión que has introducido no son correctos. Puede ser el nombre de la base de datos, el usuario, la contraseña o el servidor de la base de datos.

Pasos para solucionarlo

Verifica los datos en el archivo wp-config.php: Abre el archivo wp-config.php que creaste durante la instalación (o el que viene por defecto). Busca las siguientes 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 coinciden exactamente con los que creaste en tu panel de hosting. Un error común es escribir mal la contraseña o el nombre de la base de datos.
Confirma que la base de datos existe: Accede a tu panel de control de hosting (por ejemplo, cPanel, Syspanel, o phpMyAdmin). Dentro de la sección de bases de datos, comprueba que la base de datos que pusiste en DB_NAME existe realmente. Si no existe, créala.
Revisa el servidor de la base de datos: La mayoría de los servidores usan localhost. Sin embargo, algunos proveedores (como ciertos hosting compartidos o servidores con Syspanel) usan direcciones como 127.0.0.1 o incluso un nombre de servidor específico. Si no estás seguro, consulta la documentación de tu hosting o el panel de Syspanel (recuerda, el puerto de acceso es el 2106). Allí suele aparecer el host de la base de datos.

[TIP] Si estás usando Syspanel, busca en la sección "Bases de Datos". Allí verás el nombre exacto del servidor (a veces es localhost o mysql.syspanel.local). Copia ese valor exacto en DB_HOST.

Error de "Headers already sent"

Este error es muy común y suele aparecer como una página en blanco o un mensaje como "Warning: Cannot modify header information – headers already sent by...".

¿Por qué ocurre?

Ocurre cuando hay espacios en blanco o caracteres invisibles (como un salto de línea) antes de la etiqueta de apertura de PHP (<?php) o después de la etiqueta de cierre (?>) en el archivo wp-config.php. También puede deberse a un plugin o tema conflictivo.

Pasos para solucionarlo

Edita el archivo wp-config.php: Ábrelo con un editor de texto plano (como el Bloc de notas, Sublime Text o VS Code). No uses Word o procesadores de texto.
Elimina espacios y líneas en blanco: Busca al principio del archivo. Justo antes de <?php no debe haber absolutamente nada (ni un espacio, ni un salto de línea). Al final del archivo, después del ?> (si existe), tampoco debe haber nada. Lo más seguro es eliminar la etiqueta de cierre ?> al final del todo, ya que no es obligatoria y evita este problema.
Guarda el archivo sin BOM: Al guardar, asegúrate de que la codificación sea UTF-8 sin BOM (Byte Order Mark). En editores como Notepad++, puedes seleccionar "Codificación > Convertir a UTF-8 sin BOM".

[WARNING] Nunca edites el archivo wp-config.php desde el panel de administración de WordPress (si ya lo tienes instalado) porque si hay un error, podrías bloquear el acceso. Hazlo siempre por FTP o desde el panel de archivos de tu hosting.

Problemas con el archivo .htaccess

A veces, al instalar WordPress, los enlaces permanentes no funcionan o aparecen errores 404 en las páginas internas. Esto suele deberse a que el archivo .htaccess no se ha creado correctamente o no tiene los permisos adecuados.

¿Por qué ocurre?

WordPress necesita escribir en el archivo .htaccess para gestionar las URLs limpias. Si el servidor no tiene permisos de escritura, no puede hacerlo.

Pasos para solucionarlo

Crea el archivo .htaccess manualmente: Conéctate a tu servidor por FTP o usa el administrador de archivos de tu panel. En la carpeta raíz de WordPress (donde está wp-config.php), busca el archivo .htaccess. Si no existe, créalo.

Pega el contenido básico: Abre el archivo y pega el siguiente código:

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

Ajusta los permisos: El archivo debe tener permisos 644 (lectura y escritura para el propietario, solo lectura para el grupo y otros). Si no sabes cómo hacerlo, desde el panel de archivos de tu hosting suele haber una opción "Permisos" o "CHMOD".

[INFO] Si tu servidor usa Syspanel, puedes acceder al administrador de archivos desde el panel (puerto 2106). Busca la carpeta public_html y dentro de ella la carpeta de tu dominio. Allí estará el archivo .htaccess.

Error de memoria PHP (Allowed memory size exhausted)

Este error aparece cuando el script de instalación o algún plugin consume más memoria de la que PHP tiene permitida por defecto.

¿Por qué ocurre?

Los servidores compartidos suelen tener un límite de memoria bajo (por ejemplo, 32MB o 64MB). WordPress recomienda al menos 64MB, pero para instalaciones con muchos plugins o temas pesados, es mejor tener 128MB o más.

Pasos para solucionarlo

Aumenta el límite de memoria en wp-config.php: Añade la siguiente línea justo antes del comentario "¡Eso es todo, deja de editar!":
```
define('WP_MEMORY_LIMIT', '256M');
```
Esto le dice a WordPress que puede usar hasta 256MB de memoria.
Modifica el archivo php.ini (si tienes acceso): Si tu hosting te permite editar el php.ini, busca la línea memory_limit y cámbiala a 256M. Si no tienes acceso, puedes crear un archivo php.ini en la raíz de WordPress con el contenido:
```
memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
```
Usa el archivo .htaccess (como alternativa): Añade esta línea al .htaccess:
```
php_value memory_limit 256M
```

[WARNING] Si estás en un hosting compartido, es posible que no puedas modificar php.ini. En ese caso, contacta con el soporte de tu proveedor y pídeles que aumenten el límite de memoria para tu cuenta.

Error de permisos de archivos y carpetas

Si al instalar WordPress ves mensajes como "No se puede crear el archivo wp-config.php" o "No se puede escribir en el directorio wp-content", es un problema de permisos.

¿Por qué ocurre?

Los archivos y carpetas de WordPress deben tener permisos específicos para que el servidor web pueda leerlos y, en algunos casos, escribir en ellos (por ejemplo, para subir imágenes o instalar plugins).

Pasos para solucionarlo

Conéctate por FTP o usa el administrador de archivos de tu panel de hosting.
Establece los permisos correctos:
- Todas las carpetas deben tener permisos 755 (drwxr-xr-x).
- Todos los archivos (excepto wp-config.php) deben tener permisos 644 (-rw-r--r--).
- El archivo wp-config.php debe tener permisos 600 o 640 por seguridad.
Cambia el propietario de los archivos (si es necesario): En muchos servidores, el usuario del FTP y el usuario del servidor web son diferentes. Si no puedes cambiar permisos, es posible que necesites que el soporte técnico asigne el propietario correcto. En Syspanel, esto se suele gestionar desde la sección "Archivos" o "Usuarios".

[TIP] Si usas Syspanel, ve a "Administrador de archivos", selecciona todos los archivos y carpetas de WordPress, y en el menú de la derecha elige "Cambiar permisos". Pon 755 para carpetas y 644 para archivos. A veces también hay una opción "Forzar permisos" que lo hace automáticamente.

Error al subir archivos (límite de tamaño)

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

¿Por qué ocurre?

El servidor tiene un límite de tamaño para las subidas de archivos. Por defecto, suele ser 2MB o 8MB, lo cual es insuficiente para muchos temas o plugins.

Pasos para solucionarlo

Aumenta el límite en php.ini (si puedes): Busca las líneas upload_max_filesize y post_max_size y cámbialas a, por ejemplo, 64M y 64M respectivamente.

Usa el archivo .htaccess: Añade:

php_value upload_max_filesize 64M
php_value post_max_size 64M
php_value max_execution_time 300

Modifica wp-config.php: Añade:

@ini_set( 'upload_max_filesize', '64M' );
@ini_set( 'post_max_size', '64M' );
@ini_set( 'max_execution_time', '300' );

[INFO] En Syspanel, puedes ajustar estos valores desde la sección "PHP Settings" o "Configuración de PHP". Allí hay un campo para "upload_max_filesize". Cambia el valor y guarda los cambios.

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

¿Qué hago si no puedo acceder al panel de administración después de instalar?

Prueba a acceder mediante tudominio.com/wp-admin. Si ves una página en blanco, revisa el error de memoria PHP (punto 4). Si ves un error de base de datos, repasa el punto 1. También puedes intentar desactivar todos los plugins renombrando la carpeta wp-content/plugins a wp-content/plugins_old desde FTP.

¿Por qué aparece "Error de base de datos" justo después de la instalación?

Puede ser que la base de datos no se haya creado correctamente o que el usuario no tenga todos los privilegios. Accede a phpMyAdmin o al panel de bases de datos de Syspanel y verifica que el usuario tiene privilegios de "SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP". Si no, asígnaselos.

¿Cómo reinstalo WordPress desde cero si todo falla?

Elimina todos los archivos de WordPress de tu servidor (excepto la carpeta wp-content si quieres conservar imágenes, pero ojo, los temas y plugins los perderás).
Elimina la base de datos y créala de nuevo.
Descarga la última versión de WordPress desde wordpress.org.
Sigue el proceso de instalación desde el principio.

[WARNING] Antes de reinstalar, haz una copia de seguridad de cualquier archivo importante (como wp-config.php o la carpeta wp-content/uploads).

Mi instalación se queda en blanco después de elegir el idioma

Esto suele ser un problema de memoria o de un plugin/theme corrupto. Prueba aumentando la memoria (punto 4). Si no funciona, descarga de nuevo los archivos de WordPress y reemplázalos (excepto wp-config.php y la carpeta wp-content).

¿Qué significa "Error 500 Internal Server Error"?

Es un error genérico del servidor. Las causas pueden ser: archivo .htaccess corrupto, permisos incorrectos, un plugin o tema que da error, o un problema con la configuración de PHP. La solución más rápida es renombrar el .htaccess a .htaccess_old y ver si funciona. Si sí, regenera los enlaces permanentes desde Ajustes > Enlaces permanentes en el panel de administración.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la mayoría de los problemas de instalación de WordPress se deben a pequeños descuidos con los datos de conexión o los permisos. Si después de seguir todos estos pasos sigues teniendo problemas, no dudes en contactar con el soporte técnico de tu hosting. ¡Buena suerte con tu WordPress!