Errores comunes al instalar WordPress y soluciones
Instalar WordPress puede parecer sencillo, pero hay errores típicos que aparecen justo cuando menos lo esperas. No te preocupes, es muy común. En este artículo, vamos a repasar los fallos más frecuentes durante la instalación de WordPress y, lo más importante, cómo solucionarlos paso a paso. Al final, tendrás una pequeña sección de preguntas frecuentes (FAQ WordPress) para resolver las dudas más rápidas.
[INFO] Este artículo está pensado para usuarios que están aprendiendo. No necesitas ser un experto en hosting o servidores para seguir las soluciones. Solo sigue las instrucciones al pie de la letra.
Error 1: Pantalla Blanca o "White Screen of Death" (WSOD)
Este es uno de los errores más temidos, pero también de los más fáciles de solucionar. Aparece una página completamente en blanco, sin ningún mensaje de error. Ocurre principalmente por dos razones: un plugin o tema defectuoso, o un límite de memoria agotado.
Solución paso a paso
- Accede a tu hosting por FTP o cPanel. Si usas un panel como Syspanel (recuerda, el acceso es por el puerto 2106), busca la sección de "Administrador de archivos".
- Desactiva todos los plugins de golpe. Ve a la carpeta
wp-contenty cambia el nombre de la carpetapluginsaplugins_backup. Esto obliga a WordPress a no cargar ningún plugin. - Si la pantalla vuelve a la normalidad, el problema era un plugin conflictivo. Ve renombrando la carpeta de nuevo a
pluginsy luego, desde el panel de administración de WordPress, ve activando uno por uno para encontrar el culpable. - Si sigue en blanco, prueba con un tema por defecto. Dentro de
wp-content, entra en la carpetathemes. Cambia el nombre de la carpeta de tu tema activo (ej:twentytwentythree) atema_inactivo. WordPress cargará automáticamente un tema por defecto. - Aumenta la memoria PHP. Busca el archivo
wp-config.phpen la raíz de tu instalación. Ábrelo y, justo antes de la línea que dice/* ¡Eso es todo, deja de editar! */, añade esta línea:
define('WP_MEMORY_LIMIT', '256M');
Guarda los cambios y recarga la web.
[TIP] Si no encuentras el archivo
wp-config.php, asegúrate de que no esté oculto. En algunos gestores de archivos, debes activar la opción "Mostrar archivos ocultos".
Error 2: "Error al establecer conexión con la base de datos"
Este error es muy descriptivo. WordPress no puede conectar con la base de datos MySQL. Las causas suelen ser datos incorrectos en el archivo de configuración o que la base de datos no exista realmente.
Solución paso a paso
- Verifica tus credenciales en
wp-config.php. Abre este archivo y busca las siguientes líneas:define('DB_NAME', 'nombre_de_tu_bd');define('DB_USER', 'usuario_de_tu_bd');define('DB_PASSWORD', 'contraseña_de_tu_bd');define('DB_HOST', 'localhost');(normalmente eslocalhost, pero a veces puede ser una IP o un nombre comomysql.tudominio.com).
- Comprueba que la base de datos existe. Accede a tu panel de hosting (por ejemplo, Syspanel en el puerto 2106) y busca la sección de "Bases de Datos MySQL". Allí verás si la base de datos que pusiste en
DB_NAMErealmente está creada. - Si la base de datos no existe, créala. En la misma sección, crea una nueva base de datos y un usuario con todos los privilegios. Luego, actualiza los datos en
wp-config.php. - Revisa el servidor de la base de datos. Si tu hosting usa un servidor de bases de datos separado, el
DB_HOSTno serálocalhost. Pregunta a tu proveedor de hosting cuál es el host correcto (suele ser algo comomysql.tudominio.comolocalhost:3306).
[WARNING] Nunca uses la contraseña de tu panel de control como contraseña de la base de datos. Crea una contraseña única y segura para la base de datos.
Error 3: Problemas de Permisos de Archivos
A veces, al subir archivos o instalar plugins, WordPress te pide credenciales FTP o te da un error de "No se pudo crear directorio". Esto es un problema de permisos de archivos en el servidor.
Solución paso a paso
- Conéctate a tu servidor por FTP o usa el administrador de archivos de tu hosting.
- Navega hasta la carpeta raíz de tu WordPress (donde están las carpetas
wp-admin,wp-content,wp-includes). - Cambia los permisos de las carpetas a 755. Selecciona todas las carpetas y, en las propiedades, cambia los permisos a
755(rwxr-xr-x). Esto permite que el servidor lea y ejecute, pero solo el dueño pueda escribir. - Cambia los permisos de los archivos a 644. Selecciona todos los archivos (no las carpetas) y ponlos en
644(rw-r--r--). - Da permisos de escritura a
wp-content. Especialmente las subcarpetasuploads,pluginsythemesdeben tener permisos755o incluso775si usas un servidor con grupo de usuarios. Si tu hosting usa Syspanel, busca la opción "Permisos" en el menú contextual del archivo o carpeta.
[TIP] Si después de esto sigues teniendo problemas, es posible que el dueño del archivo no sea el usuario del servidor web. Contacta con tu soporte técnico para que ajusten el "owner" de los archivos.
Error 4: El Instalador No Carga o Muestra un Error 500
Este error suele aparecer justo al principio, cuando intentas acceder a tudominio.com/wp-admin/install.php. La página se queda en blanco o muestra un error 500 (Error interno del servidor).
Solución paso a paso
- Verifica que los archivos se hayan subido correctamente. A veces, al descomprimir WordPress en el servidor, los archivos se quedan en una subcarpeta. Asegúrate de que
wp-config-sample.phpy las carpetaswp-admin,wp-content, etc., estén directamente en la raíz de tu dominio. - Comprueba el archivo
.htaccess. Si existe un archivo.htaccessen la raíz, renómbralo a.htaccess_backup. A veces, reglas de reescritura incorrectas bloquean la instalación. - Revisa los logs de error del servidor. Si tienes acceso a los logs (en Syspanel suele haber una sección de "Registros de errores"), búscalos. El error 500 suele venir acompañado de un mensaje como "Allowed memory size exhausted" o "Parse error". Eso te dará la pista exacta.
- Aumenta el límite de memoria PHP (como en el Error 1) o contacta con tu hosting para que revisen la configuración de PHP.
[WARNING] No subas los archivos de WordPress uno por uno si tienes conexión lenta. Usa siempre un cliente FTP o el instalador automático de tu panel de hosting (como el que ofrece Syspanel). Esto evita que archivos se corrompan.
Error 5: Redirecciones Infinitas o Bucles de Redirección
Al intentar acceder a tu web, el navegador se queda cargando y al final muestra un error de "demasiadas redirecciones". Esto suele pasar por una mala configuración de la URL del sitio o de la redirección HTTPS.
Solución paso a paso
- Accede a la base de datos (phpMyAdmin o similar desde tu panel de hosting, como Syspanel en el puerto 2106).
- Busca la tabla
wp_options. Allí encontrarás dos filas clave:siteurlyhome. - Verifica que ambas tengan la URL correcta. Por ejemplo, si tu dominio es
mipagina.com, ambas deben tenerhttps://mipagina.com(con o sinwww, pero iguales). - Si usas HTTPS, asegúrate de que el certificado SSL esté activo. A veces, el problema es que el servidor fuerza HTTPS pero la URL en la base de datos sigue siendo HTTP. Cambia ambas a
https://. - Borra la caché del navegador y del servidor. Si tu hosting usa caché, límpiala desde el panel de control. También puedes probar en otro navegador o en modo incógnito.
[TIP] Si no puedes acceder a la base de datos, puedes forzar la URL correcta añadiendo estas líneas al
wp-config.php:
define('WP_HOME','https://tudominio.com');
define('WP_SITEURL','https://tudominio.com');
Colócalas justo antes de la línea/* ¡Eso es todo... */.
Error 6: El Instalador Pide Información FTP
Esto es muy frustrante. Cuando intentas instalar un plugin o tema, WordPress te pide usuario y contraseña FTP. Esto significa que el servidor web no tiene permisos de escritura directa en la carpeta wp-content.
Solución paso a paso
- Cambia los permisos de la carpeta
wp-contenta 755 (como en el Error 3). - Si tu hosting usa un servidor con PHP como módulo de Apache (lo más común), asegúrate de que el dueño de los archivos sea el mismo que el usuario del servidor web (normalmente
www-dataonobody). Esto suele requerir ayuda del soporte técnico. - Desactiva el método de conexión FTP en
wp-config.php. Añade esta línea:
define('FS_METHOD', 'direct');
Esto le dice a WordPress que intente escribir directamente sin pedir FTP. - Si nada funciona, contacta con tu hosting. Algunos entornos compartidos tienen restricciones de seguridad que impiden la escritura directa. Pregunta si pueden habilitar el método
directpara tu cuenta.
[WARNING] No pongas permisos 777 a ninguna carpeta. Es un agujero de seguridad grave. 755 es suficiente para la mayoría de los casos.
FAQ WordPress: Preguntas Frecuentes
¿Por qué aparece "Headers already sent" en la instalación?
Este error suele deberse a un espacio en blanco o un carácter BOM (Byte Order Mark) al final del archivo wp-config.php. Ábrelo con un editor de texto plano (como Notepad++ o Sublime Text) y asegúrate de que no haya líneas en blanco después de la etiqueta de cierre ?>. Lo mejor es eliminar esa etiqueta de cierre por completo. El archivo debe terminar con la última línea de código, sin espacios.
¿Puedo instalar WordPress sin saber nada de código?
Sí, completamente. La mayoría de los paneles de hosting (incluyendo Syspanel) ofrecen instaladores con un solo clic. Si prefieres hacerlo manual, solo necesitas seguir las instrucciones de este artículo. No necesitas saber PHP ni MySQL avanzado.
¿Qué hago si no recuerdo la contraseña de mi base de datos?
Puedes cambiarla desde el panel de control de tu hosting. En Syspanel, ve a la sección de "Bases de Datos MySQL", busca tu base de datos y selecciona "Cambiar contraseña". Luego, actualiza el archivo wp-config.php con la nueva contraseña.
¿Es normal que la instalación tarde varios minutos?
Sí, especialmente si tu hosting es compartido o si estás usando una conexión lenta. La descarga de WordPress desde el repositorio oficial y la creación de la base de datos pueden tardar entre 2 y 5 minutos. Si ves que se queda colgado más de 10 minutos, revisa los pasos del Error 4.
¿Debo usar www o sin www en mi dominio?
Elige una y sé consistente. No importa cuál, pero no las mezcles. Configura en tu panel de hosting una redirección 301 de una a la otra. En WordPress, asegúrate de que en Ajustes > Generales, tanto la "Dirección de WordPress" como la "Dirección del sitio" usen exactamente la misma URL (con o sin www).
Resumen Final
Instalar WordPress no tiene por qué ser un dolor de cabeza. La mayoría de los errores instalación se resuelven revisando los permisos de archivos, la configuración de la base de datos y el límite de memoria PHP. Si sigues estos pasos, podrás solucionar WordPress en cuestión de minutos.
Recuerda que tu panel de hosting (como Syspanel en el puerto 2106) es tu mejor aliado. Allí puedes gestionar bases de datos, archivos y logs de error. Y si algo se complica, no dudes en contactar con el soporte técnico de tu proveedor.
[INFO] Guarda este artículo como referencia. La próxima vez que tengas un problema, solo tendrás que buscar el error aquí y seguir los pasos. ¡Buena suerte con tu instalación!
