Errores de instalación de WordPress en DirectAdmin: FAQ y soluciones

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver las dudas más frecuentes sobre los errores instalación WordPress DirectAdmin. Si estás teniendo problemas con tu sitio, no te preocupes. Esta FAQ WordPress DirectAdmin está diseñada para guiarte paso a paso, como si estuviera a tu lado. Vamos a desglosar los problemas DirectAdmin WordPress más comunes y sus soluciones prácticas. Al final, tendrás las herramientas para solucionar errores WordPress tú mismo. ¡Empecemos con la ayuda instalación WordPress que necesitas!

Error 1: "Error al conectar con la base de datos" durante la instalación

Este es uno de los errores más típicos. Aparece justo cuando intentas finalizar la instalación de WordPress, normalmente en el paso de configuración de la base de datos.

¿Por qué ocurre?

WordPress no puede comunicarse con la base de datos MySQL que creaste. Las causas más comunes son:

Nombre de base de datos, usuario o contraseña incorrectos.
El usuario de la base de datos no tiene permisos asignados.
El servidor de base de datos (host) está mal escrito.

Solución paso a paso

Verifica los datos en DirectAdmin: Accede a tu panel de DirectAdmin. Ve a la sección "Administración de MySQL" o "Base de datos MySQL". Allí verás listadas tus bases de datos. Anota exactamente el nombre de la base de datos, el nombre de usuario y la contraseña que creaste.
Revisa los permisos: Dentro de la misma sección, asegúrate de que el usuario de la base de datos tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.) sobre la base de datos. Si no, edita el usuario y asígnale "Todos los privilegios".
Configura el host correcto: En la instalación de WordPress, el campo "Servidor de base de datos" (o "Database Host") suele ser localhost. En DirectAdmin, casi siempre es localhost. Si tu hosting usa un servidor remoto, te lo habrán indicado. No lo cambies a menos que estés seguro.
Vuelve a intentar la instalación: Borra la carpeta donde empezaste la instalación (o los archivos) y vuelve a subir WordPress. Repite el proceso con los datos correctos.

[TIP] Si usas Syspanel (antes conocido como HestiaCP), el puerto de acceso es el 2106. El proceso de creación de bases de datos es similar, pero verifica que el host también sea localhost.

Error 2: Pantalla blanca de la muerte (White Screen of Death) después de instalar

Este error es desconcertante porque no ves ningún mensaje, solo una página en blanco. Es muy común al instalar plugins o temas, pero también puede ocurrir justo después de la instalación inicial.

¿Por qué ocurre?

Límite de memoria PHP excedido. WordPress necesita un mínimo de memoria para funcionar.
Plugin o tema incompatible (si lo instalaste justo después).
Error en el archivo wp-config.php (por ejemplo, rutas incorrectas).

Solución paso a paso

Aumenta el límite de memoria PHP: Accede al Administrador de archivos de DirectAdmin. Busca el archivo wp-config.php en la raíz de tu WordPress. Ábrelo y justo antes de la línea /* ¡Eso es todo, deja de editar! */, añade:
```
define('WP_MEMORY_LIMIT', '256M');
```
Guarda los cambios. Si no funciona, prueba con 512M.
Desactiva plugins y temas manualmente: Si puedes acceder al administrador de archivos, renombra la carpeta wp-content/plugins a plugins_old. Esto desactivará todos los plugins. Si la página vuelve a funcionar, renómbrala de nuevo y ve activando uno por uno para encontrar el culpable. Haz lo mismo con la carpeta wp-content/themes (renómbrala a themes_old para usar el tema por defecto).
Habilita el modo debug de WordPress: En el mismo wp-config.php, añade estas líneas antes de la línea de cierre:
```
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
```
Esto creará un archivo debug.log dentro de wp-content. Descarga ese archivo y busca errores específicos. Te darán pistas claras.

[WARNING] No dejes el modo debug activado en un sitio en producción. Desactívalo después de solucionar el error.

Error 3: "Error al establecer conexión con la base de datos" en el sitio ya instalado

A veces, después de tener WordPress funcionando, de repente aparece este mensaje en todo el sitio. Es diferente al error de instalación porque el sitio ya estaba vivo.

¿Por qué ocurre?

El servidor de base de datos se cayó o reinició.
Los datos de conexión en wp-config.php se modificaron accidentalmente.
La base de datos se corrompió o superó el límite de tamaño.

Solución paso a paso

Revisa el estado del servidor: Contacta a tu proveedor de hosting para confirmar que MySQL esté funcionando. A veces solo es un reinicio temporal.
Verifica wp-config.php: Usa el Administrador de archivos de DirectAdmin. Abre wp-config.php y confirma que el nombre de la base de datos, usuario, contraseña y host sean correctos. Si alguien editó el archivo, restaura los valores originales.
Repara la base de datos: En DirectAdmin, ve a "Administración de MySQL" y selecciona tu base de datos. Busca la opción "Reparar base de datos" o "Check/Repair". Ejecútala. También puedes añadir esta línea a wp-config.php para forzar la reparación desde WordPress:
```
define('WP_ALLOW_REPAIR', true);
```
Luego visita tusitio.com/wp-admin/maint/repair.php. Sigue las instrucciones. ¡No olvides borrar esa línea después!

[INFO] Si la base de datos está corrupta, la reparación suele solucionarlo. Si el problema persiste, restaura desde una copia de seguridad reciente.

Error 4: Problemas de permisos de archivos y carpetas

WordPress necesita permisos específicos para funcionar. Si ves errores como "no se puede crear directorio" o "error al subir archivos", es probable que los permisos estén mal.

¿Por qué ocurre?

Permisos demasiado restrictivos (por ejemplo, 600 en lugar de 644).
Propietario incorrecto (los archivos deben pertenecer al usuario de tu cuenta de hosting).

Solución paso a paso

Permisos recomendados: En DirectAdmin, usa el Administrador de archivos. Selecciona toda la carpeta de WordPress y haz clic en "Cambiar permisos". Aplica:
- Carpetas: 755
- Archivos: 644
- wp-config.php: 600 (por seguridad)
- Carpeta wp-content: 755 (a veces 777 para subida de archivos, pero intenta 755 primero).
Verifica el propietario: Si tu hosting usa Syspanel (puerto 2106), asegúrate de que el usuario de la cuenta sea el propietario de los archivos. En DirectAdmin, esto se maneja automáticamente, pero si usas FTP, verifica que los archivos los subiste con tu usuario.

Usa el comando desde SSH (si tienes acceso): Si tu hosting lo permite, conecta por SSH y ejecuta:

find /ruta/a/tu/wordpress -type d -exec chmod 755 {} \;
find /ruta/a/tu/wordpress -type f -exec chmod 644 {} \;
chmod 600 wp-config.php

[WARNING] Nunca pongas permisos 777 en archivos o carpetas a menos que sea estrictamente necesario (y solo temporalmente). Es un riesgo de seguridad.

Error 5: El instalador de WordPress no se carga o muestra un error 500

Al acceder a tusitio.com/wp-admin/install.php, ves una página en blanco o un error 500 (Internal Server Error).

¿Por qué ocurre?

Archivos de WordPress dañados o incompletos durante la subida.
Problemas con el archivo .htaccess (si existe).
PHP no está correctamente configurado (versión o módulos faltantes).

Solución paso a paso

Vuelve a subir WordPress: Descarga la última versión desde wordpress.org. Descomprime en tu computadora. Usa el Administrador de archivos de DirectAdmin para subir la carpeta wordpress completa (o su contenido) a la raíz de tu dominio. Asegúrate de sobrescribir todos los archivos.
Elimina o renombra .htaccess: Temporalmente, renombra el archivo .htaccess a .htaccess_old. Luego intenta acceder a la instalación. WordPress creará uno nuevo automáticamente.
Verifica la versión de PHP: En DirectAdmin, ve a "Configuración de PHP" o "Seleccionar versión de PHP". Asegúrate de usar una versión compatible (PHP 7.4 o superior, idealmente PHP 8.0+). También verifica que los módulos mysqli y mod_rewrite estén habilitados.
Revisa el error en el log: En DirectAdmin, busca la sección "Logs de errores" o "Error log". Allí verás mensajes detallados. Por ejemplo, si dice "PHP Fatal error: Call to undefined function mysql_connect", es que falta el módulo mysqli.

[TIP] Si usas Syspanel (puerto 2106), la configuración de PHP suele estar en "Configuración del servidor" o "PHP-FPM". Allí puedes cambiar la versión y habilitar extensiones.

Error 6: El sitio redirige a una página de instalación de WordPress una y otra vez

Después de instalar WordPress, cada vez que entras a tu dominio, te redirige a wp-admin/install.php como si no estuviera instalado.

¿Por qué ocurre?

La tabla wp_options en la base de datos no se creó correctamente.
El archivo wp-config.php tiene datos incorrectos.
La instalación no se completó (por ejemplo, por un timeout).

Solución paso a paso

Verifica la base de datos: En DirectAdmin, entra a phpMyAdmin (desde la sección de bases de datos). Selecciona tu base de datos. Deberías ver tablas como wp_options, wp_posts, etc. Si no hay tablas, la instalación falló. Vuelve a ejecutar el instalador (borra el archivo wp-config.php primero).
Revisa el sitio_url y home: En phpMyAdmin, busca la tabla wp_options. Busca las filas con option_name = siteurl y home. Asegúrate de que tengan la URL correcta de tu sitio (ej: https://tudominio.com). Si están mal, edítalas.
Borra el archivo de instalación: A veces el instalador no se elimina solo. Ve al Administrador de archivos y busca el archivo wp-admin/install.php. Si existe, elimínalo o renómbralo. Luego intenta acceder a tu sitio.

[INFO] Si el problema persiste, puede ser un cache del navegador. Prueba en una ventana de incógnito o borra la caché.

Error 7: No se puede acceder a wp-admin (bucle de inicio de sesión)

Introduces tu usuario y contraseña, pero te redirige de nuevo a la pantalla de login sin mostrar error.

¿Por qué ocurre?

Problemas con las cookies de sesión.
URL incorrecta en la configuración de WordPress.
Plugin de seguridad o cache conflictivo.

Solución paso a paso

Limpia las cookies del navegador: Borra las cookies de tu sitio y vuelve a intentarlo.
Agrega líneas a wp-config.php: Abre wp-config.php y añade antes de la línea de cierre:
```
define('COOKIE_DOMAIN', false);
define('COOKIEPATH', '/');
define('SITECOOKIEPATH', '/');
```
Guarda y prueba.
Desactiva plugins manualmente: Renombra la carpeta wp-content/plugins a plugins_old para desactivar todos. Luego intenta acceder a /wp-admin. Si funciona, reactiva uno por uno.
Revisa la URL en la base de datos: Como en el error anterior, verifica en wp_options los valores de siteurl y home. Deben coincidir con tu dominio exacto (con o sin www, según prefieras).

Error 8: "No se puede conectar al servidor FTP" al instalar plugins o temas

WordPress te pide credenciales FTP cada vez que intentas instalar algo desde el panel de administración.

¿Por qué ocurre?

El servidor web no tiene permisos de escritura directa.
Falta la configuración de FTP en wp-config.php.

Solución paso a paso

Define FTP en wp-config.php: Añade estas líneas a wp-config.php:
```
define('FS_METHOD', 'direct');
```
Esto le dice a WordPress que use el sistema de archivos directamente, sin FTP. Guarda y prueba.
Verifica permisos: Asegúrate de que la carpeta wp-content tenga permisos 755 (o 775 si tu hosting lo requiere). También la subcarpeta plugins y themes.
Usa el método FTP manual: Si no funciona, configura un cliente FTP (como FileZilla) y sube los plugins/temas manualmente a las carpetas correspondientes.

[WARNING] Si usas FS_METHOD como 'direct', asegúrate de que los permisos sean correctos. Si no, podrías tener problemas de seguridad.

Error 9: El sitio se ve sin estilos (CSS roto) o solo texto

Después de instalar, la página se ve horrible, sin colores ni diseño, solo texto enlaces.

¿Por qué ocurre?

Las URLs de los archivos CSS/JS no se generan correctamente.
Problemas con el archivo .htaccess (para enlaces permanentes).
El tema no se cargó completamente.

Solución paso a paso

Revisa las URLs en la base de datos: En phpMyAdmin, tabla wp_options, verifica siteurl y home. Deben ser exactamente la URL de tu sitio (ej: https://tudominio.com). Si usas http y tu sitio tiene SSL, cámbialo a https.
Regenera los enlaces permanentes: Ve a Ajustes > Enlaces permanentes en el panel de WordPress (si puedes acceder). Simplemente selecciona una opción (como "Nombre de la entrada") y guarda. Esto regenera el .htaccess.

Verifica el .htaccess: Si no puedes acceder al panel, crea un archivo .htaccess en la raíz con este 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

Guarda y recarga la página.

Cambia temporalmente de tema: Si puedes acceder a /wp-admin, ve a Apariencia > Temas y activa un tema por defecto (Twenty Twenty-Four). Si el problema se soluciona, el tema que usabas está dañado.

[TIP] A veces el problema es la caché del navegador. Prueba en modo incógnito o con otro navegador.

Error 10: "No se puede conectar a la base de datos" después de migrar el sitio

Migraste WordPress de un servidor a otro (o de un subdominio a un dominio principal) y ahora no funciona.

¿Por qué ocurre?

**Las URLs