Los 7 errores más comunes al instalar WordPress y sus soluciones (Syspanel)

Antes de empezar: entiende por qué falla WordPress

Instalar WordPress parece sencillo: subes archivos, creas una base de datos, rellenas un formulario y listo. Pero la realidad es que miles de usuarios se topan con errores cada día, especialmente cuando usan un panel de control como Syspanel.

La mayoría de estos fallos no son culpa de WordPress, sino de pequeños detalles de configuración que se pasan por alto. En esta guía extensa vamos a repasar los errores más comunes al instalar WordPress, sus causas y las soluciones paso a paso, pensadas para que cualquier persona sin experiencia técnica pueda resolverlas.

Si estás usando Syspanel (el panel de control que antes se llamaba HestiaCP, y que ahora se accede por el puerto 2106), esta guía te vendrá de perlas. Vamos a ello.

Error 1: "Error al conectar con la base de datos" (base de datos WordPress error)

Este es, con diferencia, el error más común al instalar WordPress. Aparece en el primer paso de la instalación, justo cuando introduces los datos de la base de datos.

¿Por qué ocurre?

Las causas más frecuentes son:

El nombre de la base de datos no coincide con el que creaste en Syspanel.
El usuario de la base de datos no existe o tiene permisos insuficientes.
La contraseña se copió con espacios adicionales.
El host de la base de datos es incorrecto (muchos usan localhost cuando debería ser 127.0.0.1 o un host específico).
La base de datos no se creó correctamente en Syspanel.

Cómo solucionarlo paso a paso

Paso 1: Accede a Syspanel. Recuerda que la URL es https://tu-dominio.com:2106. Inicia sesión con tu usuario administrador.

Paso 2: Ve a la sección "Bases de datos" (o "Databases" si lo tienes en inglés). Ahí deberías ver la base de datos que creaste. Anota el nombre exacto, el usuario y si aparece algún host específico (normalmente es localhost).

Paso 3: Verifica que el usuario tiene todos los privilegios. En Syspanel, cuando creas una base de datos, se genera automáticamente un usuario con todos los permisos. Si lo creaste manualmente, asegúrate de que tenga permisos de SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP.

Paso 4: Comprueba que en el archivo wp-config.php (que está en la raíz de tu instalación de WordPress) los datos sean exactamente estos:

define('DB_NAME', 'nombre_exacto_base_datos');
define('DB_USER', 'usuario_exacto');
define('DB_PASSWORD', 'contraseña_sin_espacios');
define('DB_HOST', 'localhost');

Paso 5: Si todo parece correcto pero sigue fallando, prueba a cambiar localhost por 127.0.0.1. En algunos servidores, especialmente con IPv6, esto resuelve el problema al instante.

[TIP] Cuando copies la contraseña desde Syspanel, pégala primero en un bloc de notas para ver si hay espacios invisibles. Es muy común que al copiar desde el panel se añadan saltos de línea o espacios que rompen la conexión.

Error 2: Pantalla blanca o "Error estableciendo conexión con la base de datos"

Este error es un poco más frustrante porque no te dice exactamente qué falla. Simplemente ves una página en blanco o un mensaje genérico.

Causas más habituales

El servidor de base de datos está caído o sobrecargado.
La base de datos ha superado el límite de conexiones simultáneas.
El usuario de la base de datos no tiene permisos para acceder desde el host donde está WordPress.
Hay un problema con los archivos de WordPress: subida incompleta, permisos incorrectos, etc.

Solución en Syspanel

Paso 1: Entra en Syspanel (puerto 2106) y ve al Administrador de archivos o al gestor de archivos de tu hosting. Comprueba que la carpeta de WordPress tiene los permisos correctos: las carpetas deben estar en 755 y los archivos en 644.

Paso 2: Revisa si el servicio de base de datos (MariaDB o MySQL) está activo. En Syspanel, ve a "Servicios" o "Estado del servicio". Si ves que MySQL/MariaDB está detenido, inícialo.

Paso 3: Si el servicio está activo, prueba a reiniciarlo. A veces se queda en un estado raro que impide nuevas conexiones.

Paso 4: Revisa los logs de error. En Syspanel, busca la sección de "Logs" o "Registros". El log de MySQL te dirá exactamente qué está fallando.

[WARNING] Si tienes muchos sitios en el mismo servidor y todos usan la misma base de datos, es posible que estés alcanzando el límite de conexiones. Considera crear una base de datos separada para cada sitio WordPress.

Error 3: "No se puede seleccionar la base de datos"

Este error aparece cuando WordPress puede conectarse al servidor de base de datos, pero no encuentra la base de datos que le has indicado.

Por qué ocurre

Escribiste mal el nombre de la base de datos.
La base de datos fue eliminada accidentalmente.
Usaste un nombre con guiones o caracteres especiales que MySQL no acepta.
En Syspanel, la base de datos tiene un prefijo que no estás incluyendo.

La solución

Paso 1: Ve a Syspanel (recuerda: puerto 2106) y abre la sección de Bases de datos.

Paso 2: Copia el nombre exacto de la base de datos. IMPORTANTE: En Syspanel, cuando creas una base de datos, normalmente se añade un prefijo con el nombre de usuario del hosting. Por ejemplo, si tu usuario es cliente1 y creas una base llamada wordpress, el nombre real será cliente1_wordpress. Asegúrate de usar este nombre completo.

Paso 3: Verifica que la base de datos existe y que no está vacía. Si está vacía, WordPress no podrá instalar sus tablas. Puedes importar un backup o simplemente borrarla y crearla de nuevo.

Paso 4: Edita tu wp-config.php y asegúrate de que DB_NAME coincide exactamente con lo que ves en Syspanel.

[INFO] Los guiones medios (-) en los nombres de base de datos pueden causar problemas. Si tu base de datos se llama mi-blog, considera renombrarla a mi_blog para evitar errores extraños.

Error 4: Error 500 en la instalación de WordPress

Un error 500 es un error genérico del servidor. Puede aparecer en cualquier momento de la instalación o incluso al intentar acceder al instalador.

Causas comunes

Permisos incorrectos en archivos o carpetas.
Archivos de WordPress corruptos o incompletos.
Problemas con el archivo .htaccess.
Límite de memoria PHP excedido.
Incompatibilidad entre la versión de PHP y WordPress.

Solución paso a paso en Syspanel

Paso 1: Accede al Administrador de archivos en Syspanel y comprueba los permisos. Ejecuta estos valores:

Carpetas: 755
Archivos: 644
wp-config.php: 600 (más seguro) o 644 como mínimo.

Paso 2: Si los permisos están bien, revisa el archivo .htaccess. Si existe, renómbralo a .htaccess.bak temporalmente y prueba de nuevo. Si WordPress funciona, es que el .htaccess tenía una regla conflictiva.

Paso 3: Aumenta el límite de memoria PHP. En Syspanel, ve a "Configuración PHP" o "PHP Settings". Busca la directiva memory_limit y cámbiala a 256M o 512M.

Paso 4: Comprueba la versión de PHP. WordPress 6.x recomienda PHP 7.4 o superior. En Syspanel, puedes cambiar la versión de PHP desde la sección "Dominios" o "Websites", seleccionando tu dominio y cambiando la versión en la pestaña "PHP".

Paso 5: Si nada funciona, descarga WordPress de nuevo desde wordpress.org, elimina todos los archivos de tu servidor y vuelve a subirlos. A veces una subida incompleta (por FTP cortado, por ejemplo) deja archivos corruptos.

[WARNING] No subas archivos con FileZilla o cualquier FTP si la conexión es inestable. Usa el administrador de archivos de Syspanel directamente, que es más fiable.

Error 5: "El enlace que has seguido ha caducado" al instalar WordPress

Este error es típico cuando intentas subir un tema o plugin durante la instalación, pero también puede aparecer al instalar WordPress si el servidor tiene límites muy bajos.

Por qué ocurre

El límite de subida de archivos es demasiado pequeño.
El tiempo máximo de ejecución de PHP es insuficiente.
El archivo que intentas subir es demasiado grande.

Cómo solucionarlo

Paso 1: En Syspanel, ve a "Configuración PHP" y ajusta estos valores:

upload_max_filesize → 64M o más.
post_max_size → 64M o más.
max_execution_time → 300 o más.
max_input_time → 300.

Paso 2: Guarda los cambios y reinicia PHP si es necesario (Syspanel lo hace automáticamente).

Paso 3: Si el error persiste, prueba a instalar WordPress manualmente en lugar de usar el instalador automático. Descarga WordPress, súbelo por FTP o el administrador de archivos, crea la base de datos manualmente y ejecuta tu-dominio.com/wp-admin/install.php.

[TIP] Los instaladores automáticos a veces fallan por problemas de permisos temporales. Si el error persiste, la instalación manual es la solución más fiable.

Error 6: "No se puede conectar a la base de datos" pero solo en el panel de administración

A veces WordPress funciona en la parte pública, pero al entrar a wp-admin aparece un error de conexión. Esto suele ser un problema de caché de DNS o de hosting compartido con IP dinámica.

Soluciones rápidas

Paso 1: Limpia la caché de DNS en tu ordenador. En Windows: ipconfig /flushdns en el símbolo del sistema. En Mac: sudo dscacheutil -flushcache.

Paso 2: Si trabajas desde casa, prueba a conectarte con otra red (por ejemplo, con el móvil). A veces tu ISP tiene problemas con el DNS.

Paso 3: En Syspanel, asegúrate de que el dominio apunta correctamente al servidor. Ve a "Dominios" y verifica que el DNS está bien configurado.

Paso 4: Si tienes acceso a Syspanel, revisa si hay algún firewall activo que esté bloqueando conexiones desde ciertas IPs.

Error 7: Problemas con el puerto 2106 de Syspanel

Si estás usando Syspanel, es posible que tengas problemas para acceder al panel en sí, lo que impide gestionar correctamente WordPress.

¿Por qué no puedo entrar a Syspanel?

El puerto 2106 está bloqueado por el firewall.
El certificado SSL no es válido (accedes por HTTP en lugar de HTTPS).
Tu proveedor de hosting bloquea puertos no estándar.

Solución

Paso 1: Asegúrate de que la URL es exactamente: https://tu-dominio.com:2106. El https es obligatorio.

Paso 2: Si tu navegador te avisa de un certificado no válido, acepta la excepción temporalmente. Es normal si es un certificado autofirmado.

Paso 3: Comprueba que el firewall del servidor permite conexiones al puerto 2106. En Syspanel, ve a "Firewall" y añade una regla para permitir el puerto 2106 desde tu IP.

Paso 4: Si no puedes entrar de ninguna manera, contacta con tu proveedor de hosting para que abra el puerto.

[INFO] Syspanel (anteriormente HestiaCP) usa el puerto 2106 por defecto para su panel de control. Es un puerto seguro y no deberías cambiarlo a menos que sepas lo que haces.

Error 8: WordPress no se instala porque falta la extensión PHP

WordPress necesita ciertas extensiones de PHP para funcionar correctamente. Si no están activas, la instalación se detiene con un mensaje de error.

Extensiones necesarias

mysqli (base de datos)
curl (actualizaciones y conexiones externas)
gd (procesamiento de imágenes)
zip (instalación de temas y plugins)
mbstring (soporte para caracteres especiales)

Cómo activarlas en Syspanel

Paso 1: Ve a "Configuración PHP" en Syspanel.

Paso 2: Busca las extensiones mencionadas y actívalas si están desactivadas.

Paso 3: Guarda los cambios y reinicia PHP.

Paso 4: Vuelve a intentar la instalación de WordPress.

[WARNING] Si tu versión de PHP es muy antigua (5.6 o inferior), WordPress no funcionará correctamente. Actualiza a PHP 7.4 o 8.x desde Syspanel.

Error 9: "No se puede escribir en el directorio" al instalar temas o plugins

Este error aparece cuando WordPress no tiene permisos de escritura en las carpetas wp-content, themes o plugins.

Causa principal

Los permisos de las carpetas son demasiado restrictivos (por ejemplo, 555 en lugar de 755).

Solución

Paso 1: En Syspanel, ve al Administrador de archivos y navega hasta la carpeta wp-content.

Paso 2: Cambia los permisos de wp-content, themes y plugins a 755 (o 775 si el servidor usa un grupo específico).

Paso 3: Si el problema persiste, cambia el propietario de los archivos al usuario del servidor web. En Syspanel, esto se hace automáticamente, pero a veces falla.

Paso 4: Como último recurso, puedes instalar temas y plugins manualmente: descarga el archivo ZIP, súbelo a la carpeta correspondiente y descomprímelo.

Error 10: El instalador de WordPress se queda en blanco después de "Crear archivo de configuración"

Este es un error raro pero frustrante. El instalador llega al paso de crear el wp-config.php y luego se queda en blanco.

Causas

El servidor no tiene permisos para escribir en el directorio raíz.
Hay un problema con la extensión zip o curl.
El archivo wp-config-sample.php está corrupto.

Solución

Paso 1: Descarga WordPress de nuevo y extrae el archivo wp-config-sample.php.

Paso 2: Crea manualmente el archivo wp-config.php copiando el contenido del archivo de muestra y añadiendo tus datos de base de datos.

Paso 3: Asegúrate de que el archivo wp-config.php tiene permisos 644.

Paso 4: Sube el archivo al servidor y continúa la instalación.

Preguntas frecuentes (FAQ)

¿Por qué me pide Syspanel el puerto 2106?

Syspanel (antes HestiaCP) usa el puerto 2106 como puerto de acceso al panel de control. Es un puerto seguro y estándar en este panel. Si no puedes acceder, verifica que el firewall lo permite.

¿Puedo instalar WordPress sin Syspanel?

Sí, puedes instalar WordPress manualmente subiendo los archivos por FTP, pero Syspanel facilita mucho el proceso al gestionar bases de datos, dominios y certificados SSL automáticamente.

¿Qué hago si olvidé la contraseña de la base de datos en Syspanel?

Entra en Syspanel, ve a "Bases de datos", selecciona la base de datos y cambia la contraseña del usuario. Luego actualiza el wp-config.php con la nueva contraseña.

¿Cómo sé qué versión de PHP tengo?

En Syspanel, ve a "Dominios", selecciona