Guía para solucionar errores comunes de WordPress en DirectAdmin
Introducción: ¿Por qué ocurren errores en WordPress con DirectAdmin?
Si tienes un sitio web alojado en un servidor que usa DirectAdmin como panel de control, es posible que en algún momento te encuentres con algún error en WordPress. No te preocupes, es algo normal. La mayoría de estos problemas tienen soluciones sencillas que puedes aplicar tú mismo, sin necesidad de ser un experto técnico.
En esta guía, vamos a recorrer los errores WordPress DirectAdmin más frecuentes y te explicaremos, paso a paso, cómo solucionar WordPress DirectAdmin de forma segura y rápida. Desde la temida pantalla blanca WordPress DirectAdmin hasta problemas con la base de datos, aquí encontrarás las respuestas.
[INFO] Esta guía está pensada para usuarios sin experiencia técnica. Si en algún momento te sientes perdido, recuerda que siempre puedes contactar con el soporte técnico de tu hosting.
## 1. Error de conexión a la base de datos en WordPress
Uno de los errores WordPress DirectAdmin más comunes es el mensaje: "Error al establecer una conexión a la base de datos". Esto suele ocurrir cuando WordPress no puede comunicarse con la base de datos MySQL.
### ¿Por qué ocurre?
- Las credenciales de la base de datos en el archivo
wp-config.phpson incorrectas. - La base de datos ha sido eliminada o dañada.
- El servidor de base de datos está caído o sobrecargado.
- Cambios recientes en la contraseña de la base de datos desde DirectAdmin.
### Cómo solucionarlo paso a paso
- Accede a DirectAdmin: Ingresa a tu panel de control con tu usuario y contraseña.
- Ve a la sección de "MySQL Management" (o "Gestión de Bases de Datos"): Aquí verás todas las bases de datos asociadas a tu cuenta.
- Verifica que la base de datos existe: Busca el nombre de tu base de datos. Si no aparece, puede que haya sido eliminada por error. Si es así, tendrás que crearla de nuevo y restaurar una copia de seguridad.
- Comprueba las credenciales en
wp-config.php:- Conéctate a tu hosting vía FTP o usando el administrador de archivos de DirectAdmin.
- Localiza el archivo
wp-config.phpen la raíz de tu instalación de WordPress. - Ábrelo con un editor de texto (como el Bloc de notas).
- Busca estas líneas:
define('DB_NAME', 'nombre_base_datos'); define('DB_USER', 'usuario_base_datos'); define('DB_PASSWORD', 'contraseña'); define('DB_HOST', 'localhost'); - Asegúrate de que coinciden exactamente con los datos de tu base de datos en DirectAdmin.
- Restablece la contraseña desde DirectAdmin (si es necesario):
- En la sección de MySQL, haz clic en el icono de lápiz o "Editar" junto a tu base de datos.
- Cambia la contraseña y anótala.
- Actualiza el valor en
wp-config.phpcon la nueva contraseña.
- Guarda los cambios y sube el archivo de nuevo al servidor si lo editaste localmente.
- Prueba tu sitio web. Si el error persiste, contacta con tu proveedor de hosting para verificar que el servicio MySQL esté funcionando.
[TIP] Siempre guarda las contraseñas de tus bases de datos en un lugar seguro. Puedes usar un gestor de contraseñas para no perderlas.
## 2. Pantalla blanca de la muerte en WordPress (White Screen of Death)
La pantalla blanca WordPress DirectAdmin es uno de los errores más frustrantes porque no da ninguna pista visual. Simplemente ves una página en blanco. No te alarmes, suele deberse a un conflicto de plugins, temas o un límite de memoria excedido.
### ¿Por qué ocurre?
- Un plugin o tema recién instalado o actualizado está causando un error fatal de PHP.
- El límite de memoria de PHP es demasiado bajo.
- Hay un error de sintaxis en el archivo
functions.phpde tu tema.
### Cómo solucionarlo paso a paso
#### Solución 1: Desactivar plugins y temas manualmente
- Accede a tu servidor vía FTP o el administrador de archivos de DirectAdmin.
- Navega a la carpeta
wp-content/plugins/. - Renombra la carpeta del plugin sospechoso (por ejemplo, cambia
mi-pluginami-plugin-desactivado). Esto desactivará el plugin automáticamente.- Si no sabes cuál es el causante, renombra toda la carpeta
pluginsaplugins-desactivados. Esto desactivará todos los plugins.
- Si no sabes cuál es el causante, renombra toda la carpeta
- Vuelve a cargar tu sitio web. Si ahora funciona, el problema está en uno de los plugins.
- Para identificar el plugin problemático:
- Vuelve a renombrar la carpeta
plugins-desactivadosaplugins. - Luego, renombra los plugins uno por uno (o en grupos pequeños) hasta encontrar el culpable.
- Vuelve a renombrar la carpeta
- Si el problema persiste, prueba con el tema:
- Ve a
wp-content/themes/. - Renombra la carpeta de tu tema activo (por ejemplo,
mi-temaami-tema-desactivado). WordPress usará automáticamente un tema por defecto (como Twenty Twenty-Four). - Si el sitio se recupera, el problema está en tu tema.
- Ve a
#### Solución 2: Aumentar el límite de memoria de PHP
- Edita el archivo
wp-config.php(como en el paso anterior). - Añade esta línea justo antes del comentario final (
/* That's all, stop editing! Happy blogging. */):define('WP_MEMORY_LIMIT', '256M'); - Guarda y sube el archivo.
- Prueba tu sitio.
#### Solución 3: Activar el modo de depuración (debug)
- En el mismo
wp-config.php, busca la línea:define('WP_DEBUG', false); - Cámbiala a:
define('WP_DEBUG', true); - También añade estas líneas para que los errores se muestren en pantalla:
define('WP_DEBUG_DISPLAY', true); - Guarda y sube. Ahora, al cargar tu web, verás mensajes de error que te indicarán exactamente qué archivo está causando el problema.
- Una vez resuelto, vuelve a poner
WP_DEBUGenfalsepara no mostrar errores a los visitantes.
[WARNING] No dejes el modo debug activado en un sitio en producción, ya que puede exponer información sensible.
## 3. Error 500 – Internal Server Error
Este error genérico puede deberse a varias causas, pero en DirectAdmin suele estar relacionado con archivos .htaccess corruptos o permisos incorrectos.
### ¿Por qué ocurre?
- El archivo
.htaccessde WordPress está dañado. - Los permisos de archivos o carpetas son incorrectos.
- Un plugin o tema está causando un conflicto grave.
### Cómo solucionarlo paso a paso
-
Renombra el archivo
.htaccess:- Conéctate vía FTP o administrador de archivos.
- Busca el archivo
.htaccessen la raíz de WordPress. - Cámbiale el nombre a
.htaccess_old. - Vuelve a cargar tu web. Si funciona, el
.htaccessoriginal estaba dañado. - Para regenerar uno nuevo, ve a Ajustes > Enlaces permanentes en el escritorio de WordPress y haz clic en "Guardar cambios". Esto creará un nuevo
.htaccesslimpio.
-
Verifica los permisos de archivos y carpetas:
- En DirectAdmin, ve a File Manager.
- Selecciona la carpeta raíz de tu sitio y haz clic en Change Permissions.
- Asegúrate de que los permisos sean:
- Carpetas: 755
- Archivos: 644
- Si no estás seguro, puedes marcar todas las opciones de lectura y ejecución para carpetas, y solo lectura para archivos.
- Haz clic en Apply to subdirectories para que se aplique a todo.
-
Si el error persiste, desactiva todos los plugins y cambia al tema por defecto (como en la sección de pantalla blanca).
## 4. Error 404 después de cambiar la estructura de enlaces permanentes
A veces, al modificar los enlaces permanentes en WordPress, aparecen errores 404 en todas las páginas excepto la principal.
### ¿Por qué ocurre?
- El archivo
.htaccessno se ha actualizado correctamente. - El módulo
mod_rewritede Apache no está habilitado en el servidor.
### Cómo solucionarlo paso a paso
- Regenera el
.htaccess:- Sigue el paso 1 de la sección anterior (renombrar y guardar ajustes de enlaces permanentes).
- Verifica que
mod_rewriteesté activo:- Esto lo suele gestionar el hosting, pero puedes comprobarlo creando un archivo
info.phpen la raíz con el contenido:<?php phpinfo(); ?> - Accede a ese archivo desde tu navegador (ej:
tudominio.com/info.php). - Busca "mod_rewrite" en la página. Si no aparece, contacta con el soporte para que lo habiliten.
- No olvides eliminar el archivo
info.phpdespués por seguridad.
- Esto lo suele gestionar el hosting, pero puedes comprobarlo creando un archivo
[TIP] Si usas Syspanel (anteriormente HestiaCP, accesible por el puerto 2106), el proceso es similar, pero la interfaz puede variar ligeramente.
## 5. Error "Conexión segura fallida" o problemas con SSL/HTTPS
Si tu sitio tiene un certificado SSL y ves errores de seguridad, puede deberse a una configuración incorrecta en WordPress.
### ¿Por qué ocurre?
- La URL del sitio en los ajustes de WordPress sigue usando
http://en lugar dehttps://. - Hay contenido mixto (recursos cargados sobre HTTP en una página HTTPS).
### Cómo solucionarlo paso a paso
-
Actualiza la URL del sitio en WordPress:
- Ve a Ajustes > Generales en el escritorio.
- Cambia tanto la Dirección de WordPress como la Dirección del sitio a
https://tudominio.com. - Guarda los cambios.
-
Forza HTTPS desde el archivo
.htaccess:- Añade estas líneas al principio del archivo
.htaccess:RewriteEngine On RewriteCond %{HTTPS} off RewriteRule ^(.*)$ https://%{HTTP_HOST}/$1 [R=301,L]
- Añade estas líneas al principio del archivo
-
Corrige contenido mixto:
- Puedes usar un plugin como "Really Simple SSL" o "SSL Insecure Content Fixer" para automatizar la corrección.
- O manualmente, busca en tu base de datos (usando phpMyAdmin desde DirectAdmin) y reemplaza
http://tudominio.comporhttps://tudominio.com.
[WARNING] Siempre haz una copia de seguridad de tu base de datos antes de hacer cambios directos.
## 6. Preguntas frecuentes (FAQ)
### ¿Qué hago si no puedo acceder al escritorio de WordPress?
Puedes usar FTP o el administrador de archivos de DirectAdmin para desactivar plugins o temas manualmente, como se explicó en la sección de la pantalla blanca.
### ¿Cómo puedo restaurar una copia de seguridad en DirectAdmin?
En DirectAdmin, ve a Backup/Transfer > Create/Restore Backups. Allí puedes subir un archivo de respaldo y restaurarlo. Asegúrate de tener una copia reciente.
### ¿Es seguro editar archivos directamente desde DirectAdmin?
Sí, siempre que tengas cuidado. Usa el File Manager de DirectAdmin, que es más seguro que FTP porque no expone tus credenciales. Haz cambios pequeños y guarda siempre una copia de seguridad antes.
### ¿Qué es Syspanel y cómo accedo?
Syspanel es el nuevo nombre de HestiaCP, un panel de control para servidores. Se accede por el puerto 2106, por ejemplo: https://tudominio.com:2106. Si tu hosting usa Syspanel, los pasos son similares a los de DirectAdmin, pero la interfaz puede tener nombres de sección diferentes.
## Conclusión
Los errores WordPress DirectAdmin pueden parecer abrumadores al principio, pero con esta guía tienes las herramientas para resolver los más comunes por ti mismo. Recuerda siempre:
- Haz copias de seguridad antes de hacer cambios importantes.
- Anota las contraseñas y configuraciones en un lugar seguro.
- Si te atascas, no dudes en pedir ayuda al soporte técnico de tu hosting.
Con un poco de paciencia y siguiendo estos pasos, tu sitio web volverá a funcionar en poco tiempo. ¡Buena suerte!
