Errores comunes al instalar WordPress en DirectAdmin - FAQ

¡Hola! Si has llegado hasta aquí, probablemente estés intentando instalar WordPress en tu servidor con DirectAdmin y te has topado con algún problema. No te preocupes, es más común de lo que crees. En esta FAQ extensa vamos a repasar los errores más frecuentes, por qué ocurren y, lo más importante, cómo solucionarlos paso a paso. Al final de este artículo, serás capaz de identificar y resolver la mayoría de los fallos de instalación de WordPress en DirectAdmin por ti mismo.

1. Error: "No se puede conectar a la base de datos" durante la instalación

Este es, con diferencia, el error más habitual. Aparece justo cuando WordPress intenta establecer la comunicación con MySQL o MariaDB. Las causas suelen ser sencillas.

¿Por qué ocurre?

Credenciales incorrectas: Has escrito mal el nombre de la base de datos, el usuario o la contraseña.
Base de datos o usuario no creados: Olvidaste crear la base de datos y el usuario en DirectAdmin antes de instalar WordPress.
Privilegios no asignados: El usuario de la base de datos no tiene permisos para acceder a ella.
Host de la base de datos equivocado: En servidores compartidos, a veces el host no es "localhost", sino algo como "localhost:3306" o la IP del servidor.

¿Cómo solucionarlo?

Verifica las credenciales en DirectAdmin:
- Accede a tu panel de DirectAdmin.
- Ve a "Administración de MySQL" o "MySQL Management".
- Revisa que el nombre de la base de datos, el usuario y la contraseña sean exactamente los que estás usando en el archivo wp-config.php.
- Atención: En DirectAdmin, los nombres de bases de datos y usuarios suelen tener un prefijo con tu nombre de usuario (ej: usuario_bdwordpress). No olvides incluirlo.
Confirma que la base de datos y el usuario existen:
- En la misma sección de MySQL, asegúrate de que la base de datos esté listada.
- Asegúrate de que el usuario esté creado y asignado a esa base de datos con todos los privilegios.
Asigna privilegios correctamente:
- Dentro de "Administración de MySQL", busca la opción "Asignar usuario a base de datos" o similar.
- Selecciona tu usuario y tu base de datos, y marca "Todos los privilegios". Esto es fundamental.
Comprueba el Host de la base de datos:
- En el archivo wp-config.php, la línea define('DB_HOST', '...'); suele ser 'localhost'.
- Si tu servidor lo requiere (pregunta a tu soporte), puede ser 'localhost:3306' o una dirección IP. Si no estás seguro, prueba primero con 'localhost'.

[INFO] Si después de todo sigues teniendo el error, puedes intentar crear una nueva base de datos y un nuevo usuario desde cero, asegurándote de copiar las credenciales exactas al archivo wp-config.php. A veces, un error de tipeo es la causa.

2. Error: "Error al establecer conexión con la base de datos" después de instalar

Este error es muy similar al anterior, pero aparece después de que la instalación parecía haber ido bien. La causa principal suele ser un cambio en la configuración del servidor o un problema con el archivo wp-config.php.

¿Por qué ocurre?

El archivo wp-config.php tiene datos incorrectos o está corrupto.
El servidor de bases de datos se ha reiniciado o ha cambiado su configuración.
Problemas de permisos en los archivos de WordPress.
El plugin o tema que activaste está causando un conflicto grave.

¿Cómo solucionarlo?

Revisa el archivo wp-config.php:
- Accede a tu sitio vía FTP o el Administrador de Archivos de DirectAdmin.
- Abre el archivo wp-config.php en la raíz de tu instalación de WordPress.
- Verifica que las líneas DB_NAME, DB_USER, DB_PASSWORD y DB_HOST sean correctas.
- Si todo parece bien, puedes descargar una copia nueva de WordPress (solo el archivo wp-config-sample.php), renombrarlo a wp-config.php y rellenar los datos con cuidado.
Verifica el estado del servidor MySQL:
- Esto no siempre está disponible para usuarios sin acceso root, pero puedes preguntar a tu proveedor de hosting si el servicio MySQL está funcionando correctamente.
Desactiva plugins y temas por FTP:
- Si el error apareció después de activar un plugin, renombra la carpeta wp-content/plugins a wp-content/plugins_old. Esto desactivará todos los plugins.
- Si el error desaparece, ve activando plugins uno por uno hasta encontrar el culpable.
- Haz lo mismo con la carpeta wp-content/themes (renómbrala a themes_old). WordPress usará un tema por defecto.

[WARNING] No edites el archivo wp-config.php con un editor de texto básico como el Bloc de notas de Windows, ya que puede añadir caracteres invisibles. Usa un editor de código como Notepad++ o el editor de texto de DirectAdmin.

3. Error: "Página en blanco" (White Screen of Death - WSOD) al acceder al sitio

La temida pantalla en blanco. No ves nada, ni siquiera un mensaje de error. Esto suele ser un problema de PHP o de memoria.

¿Por qué ocurre?

Límite de memoria PHP agotado: WordPress o algún plugin necesita más memoria de la que tiene asignada.
Error de PHP no mostrado: Hay un error en el código, pero está oculto.
Plugin o tema incompatible.
Archivos de WordPress corruptos o incompletos.

¿Cómo solucionarlo?

Aumenta el límite de memoria PHP:
- Crea o edita un archivo llamado php.ini en la carpeta raíz de tu WordPress (donde está wp-config.php).
- Añade la siguiente línea: memory_limit = 256M
- También puedes intentar añadir esta línea al archivo wp-config.php, justo antes de la línea /* That's all, stop editing! Happy blogging. */:
  define('WP_MEMORY_LIMIT', '256M');
Habilita la visualización de errores de PHP (temporalmente):
- En el archivo wp-config.php, busca la línea define('WP_DEBUG', false); y cámbiala a:
  define('WP_DEBUG', true);
- Si no existe, añádela antes de la línea final.
- Esto mostrará los errores en pantalla. Anota el mensaje y luego vuelve a poner WP_DEBUG en false.
Desactiva todo (plugins y tema) por FTP:
- Sigue el mismo método que en el error anterior: renombra las carpetas plugins y themes para desactivarlos todos.
Reemplaza los archivos del núcleo de WordPress:
- Descarga una copia nueva de WordPress desde wordpress.org.
- Descomprime el archivo.
- Sube solo las carpetas wp-admin y wp-includes a tu servidor, sobrescribiendo las existentes. No toques la carpeta wp-content para no perder tus contenidos.

[TIP] Si el problema persiste, contacta a tu soporte técnico y pregúntales si pueden revisar los logs de error de PHP. Ellos podrán ver el error exacto que está ocurriendo.

4. Error: "Permisos de archivo incorrectos" al instalar o actualizar

WordPress necesita ciertos permisos en los archivos y carpetas para poder funcionar, instalar plugins, temas o actualizarse automáticamente.

¿Por qué ocurre?

Los archivos tienen permisos demasiado restrictivos (ej: 600 o 644 para carpetas).
El usuario del servidor web (apache, nginx) no es el propietario de los archivos.
Has subido los archivos con un usuario FTP diferente al del servidor web.

¿Cómo solucionarlo?

Establece los permisos correctos desde DirectAdmin:
- Ve al "Administrador de Archivos" (File Manager).
- Navega a la carpeta raíz de tu WordPress.
- Selecciona todos los archivos y carpetas (Ctrl+A).
- Haz clic en "Cambiar permisos" (Change Permissions).
- Marca los permisos estándar:
  - Carpetas: 755 (rwxr-xr-x)
  - Archivos: 644 (rw-r--r--)
  - Archivo wp-config.php: 640 o 600 (por seguridad)
- Marca la casilla "Recursivo" para que se aplique a todas las subcarpetas y archivos.
Corrige la propiedad de los archivos (si tu hosting lo permite):
- A veces, el problema es que el usuario del servidor web (ej: apache o nobody) no es el dueño de los archivos.
- En DirectAdmin, esto no siempre está disponible para usuarios sin shell, pero puedes preguntar a tu soporte si pueden ejecutar el comando chown -R usuario:usuario /ruta/a/tu/wordpress.

[WARNING] No pongas permisos 777 en ningún archivo o carpeta. Es un grave riesgo de seguridad. Con 755 y 644 es más que suficiente.

5. Error: "No se puede crear el archivo wp-config.php" o "No se encuentra el archivo de configuración"

Este error suele ocurrir durante la instalación automática o al subir WordPress manualmente.

¿Por qué ocurre?

La carpeta de destino no tiene permisos de escritura.
El instalador automático (Softaculous, Installatron) no tiene acceso a la base de datos.
Has subido los archivos de WordPress a una subcarpeta incorrecta.

¿Cómo solucionarlo?

Verifica la carpeta de destino:
- Asegúrate de que estás instalando WordPress en la carpeta correcta. Si quieres que tu web esté en tudominio.com, los archivos deben estar en la carpeta public_html o domains/tudominio.com/public_html.
- Si quieres que esté en tudominio.com/blog, los archivos deben estar en una subcarpeta llamada blog dentro de public_html.
Usa el instalador automático de DirectAdmin:
- La mayoría de los paneles DirectAdmin incluyen Softaculous o Installatron.
- Ve a la sección "Instalador de Scripts" o "Softaculous".
- Busca WordPress y haz clic en "Instalar".
- Rellena los datos: dominio, carpeta (déjala en blanco si quieres la raíz), nombre del sitio, usuario y contraseña del administrador, y los datos de la base de datos (el instalador suele crearla automáticamente).
Si lo haces manualmente, crea el wp-config.php tú mismo:
- Descarga WordPress.
- Renombra el archivo wp-config-sample.php a wp-config.php.
- Ábrelo con un editor de texto.
- Rellena los datos de la base de datos (nombre, usuario, contraseña, host).
- Genera las "Salt Keys" (claves de seguridad) desde aquí: https://api.wordpress.org/secret-key/1.1/salt/
- Copia y pega esas líneas en el archivo wp-config.php, justo después de las líneas de la base de datos.
- Guarda el archivo y súbelo a tu servidor.

[TIP] Si el instalador automático falla, revisa los logs de errores del instalador. Suelen estar en la misma sección de Softaculous o en el panel de control de DirectAdmin.

6. Error: "Redireccionamientos en bucle" o "Demasiadas redirecciones"

Este error hace que tu navegador se quede atascado intentando cargar la página.

¿Por qué ocurre?

Configuración incorrecta de la URL del sitio en WordPress.
Problemas con el archivo .htaccess.
Conflicto con algún plugin de caché o redirección.
El sitio está configurado con HTTPS pero no tienes el certificado SSL bien instalado.

¿Cómo solucionarlo?

Accede a la base de datos y corrige las URLs:
- Ve a "phpMyAdmin" desde DirectAdmin.
- Selecciona tu base de datos de WordPress.
- Busca la tabla wp_options (el prefijo wp_ puede variar).
- Busca las filas siteurl y home.
- Asegúrate de que ambas tengan la URL correcta, por ejemplo: https://tudominio.com (si tienes SSL) o http://tudominio.com (si no).
Reemplaza el archivo .htaccess:
- Conéctate por FTP o al Administrador de Archivos.
- Renombra el archivo .htaccess a .htaccess_old.
- Ve a tu sitio web. WordPress debería generar un nuevo .htaccess automáticamente.
- Si no funciona, crea un nuevo archivo .htaccess con el siguiente contenido (para enlaces permanentes básicos):
```
# 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
```
Desactiva plugins de caché y redirección:
- Renombra la carpeta wp-content/plugins a plugins_old para desactivarlos todos.
- Luego, ve renombrándolos uno a uno para identificar el culpable.

[INFO] Si tienes un certificado SSL, asegúrate de que esté correctamente instalado y que tu web fuerce HTTPS. Puedes usar un plugin como "Really Simple SSL" para ayudarte con la configuración.

7. Error: "El enlace que has seguido ha caducado" al subir archivos grandes

Este error aparece cuando intentas subir un tema, plugin o imagen de gran tamaño.

¿Por qué ocurre?

El límite de subida de archivos en PHP es demasiado bajo.
El tiempo máximo de ejecución de PHP es insuficiente.
El archivo es demasiado grande para el servidor.

¿Cómo solucionarlo?

Aumenta los límites de PHP:
- Crea o edita el archivo php.ini en la raíz de tu WordPress.
- Añade o modifica estas líneas:
```
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
max_input_time = 300
memory_limit = 256M
```
Si no funciona, contacta a tu proveedor:
- Algunos servidores compartidos tienen límites muy restrictivos. Pregunta si pueden aumentarlos temporalmente.
- También puedes intentar subir el archivo por FTP a la carpeta wp-content/uploads y luego instalarlo desde el panel de administración de WordPress (si es un plugin o tema).

[WARNING] No subas archivos de más de 64MB en servidores compartidos sin consultar antes con tu proveedor, ya que podrían ralentizar el servidor.

8. Error: "El servidor no pudo completar la solicitud" al instalar un plugin

Este error suele ir acompañado de un mensaje de "Error 500" o "Internal Server Error".

¿Por qué ocurre?

El plugin requiere una versión de PHP más reciente.
**El