Problemas al actualizar WordPress en DirectAdmin | FAQ

Introducción: ¿Por qué aparecen problemas al actualizar WordPress en DirectAdmin?

Actualizar WordPress es una tarea esencial para mantener tu sitio web seguro, rápido y libre de vulnerabilidades. Sin embargo, cuando tu hosting está gestionado a través de DirectAdmin, pueden surgir algunos obstáculos técnicos que, aunque parezcan complejos, tienen soluciones sencillas. En esta FAQ (Preguntas Frecuentes) vamos a desglosar los problemas más comunes al actualizar WordPress DirectAdmin, explicando por qué ocurren y cómo resolverlos paso a paso.

Si alguna vez te has encontrado con una pantalla blanca, un mensaje de error de conexión a la base de datos o un plugin que deja de funcionar tras una actualización, este artículo es para ti. Aquí encontrarás respuestas claras, basadas en la experiencia real de soporte técnico, para que puedas realizar tus actualizaciones con confianza.

[INFO] Recuerda que, aunque hablemos de DirectAdmin, muchos de estos consejos aplican también a otros paneles como cPanel o Syspanel (anteriormente conocido como HestiaCP, cuyo acceso se realiza por el puerto 2106). Sin embargo, nos centraremos en DirectAdmin por ser el entorno más común en este tipo de consultas.

1. Error de conexión a la base de datos después de la actualización

¿Por qué ocurre?

Uno de los errores más frecuentes al actualizar WordPress DirectAdmin es la temida pantalla con el mensaje: "Error establishing a database connection". Esto suele deberse a que los datos de conexión en el archivo wp-config.php no coinciden con los que tiene configurados tu hosting.

Solución paso a paso

Accede a tu panel de DirectAdmin y busca la sección de "Administrador de archivos" o "File Manager".
Navega hasta la carpeta raíz de tu instalación de WordPress (normalmente public_html o una subcarpeta).
Localiza el archivo wp-config.php y ábrelo con el editor de texto.
Verifica que los siguientes datos sean correctos:
- DB_NAME (nombre de la base de datos)
- DB_USER (usuario de la base de datos)
- DB_PASSWORD (contraseña)
- DB_HOST (normalmente es localhost, pero puede ser un servidor remoto)
Si no recuerdas tus credenciales, ve a "MySQL Management" en DirectAdmin y revisa las bases de datos existentes.
Guarda los cambios y vuelve a cargar tu sitio.

[TIP] Si después de la actualización el archivo wp-config.php se corrompió, puedes restaurar una copia de seguridad reciente desde el propio panel de DirectAdmin o desde tu backup externo.

2. Pantalla blanca de la muerte (White Screen of Death)

¿Por qué ocurre?

La pantalla blanca es uno de los errores actualización WordPress más desconcertantes. Suele ser provocada por un conflicto entre plugins, temas o por un límite de memoria PHP insuficiente.

Solución paso a paso

Accede a tu hosting por FTP o mediante el Administrador de archivos de DirectAdmin.
Ve a la carpeta wp-content/plugins/ y renombra la carpeta del plugin que sospechas que causa el conflicto (por ejemplo, cambia mi-plugin a mi-plugin-desactivado). Esto desactivará el plugin sin necesidad de entrar al panel.
Si no sabes cuál es, renombra toda la carpeta plugins a plugins-desactivados. Luego crea una nueva carpeta vacía llamada plugins. Esto desactivará todos los plugins.
Vuelve a cargar tu sitio. Si funciona, el problema está en uno de los plugins. Actívalos uno por uno para identificarlo.
También puedes incrementar el límite de memoria PHP editando el archivo wp-config.php y añadiendo esta línea antes del comentario final:

define('WP_MEMORY_LIMIT', '256M');

[WARNING] Si el problema persiste, prueba con el tema por defecto de WordPress (Twenty Twenty-Four o similar). Para ello, renombra la carpeta de tu tema activo en wp-content/themes/. WordPress cargará automáticamente un tema alternativo.

3. Error 500 Internal Server Error tras la actualización

¿Por qué ocurre?

Un error 500 puede deberse a archivos .htaccess corruptos, problemas de permisos o incompatibilidades con la versión de PHP.

Solución paso a paso

Conéctate a DirectAdmin y ve a "Administrador de archivos".
Busca el archivo .htaccess en la raíz de tu sitio. Si no lo ves, activa la opción "Mostrar archivos ocultos".
Renómbralo a .htaccess.bak para desactivarlo temporalmente.
Vuelve a cargar tu sitio. Si funciona, el problema está en las reglas del .htaccess. Puedes generar uno nuevo desde el panel de WordPress (Ajustes > Enlaces permanentes > Guardar cambios).
Verifica los permisos de archivos y carpetas:
- Las carpetas deben tener permisos 755.
- Los archivos deben tener permisos 644.
- El archivo wp-config.php debe estar en 600 o 640.
Si el error continúa, cambia la versión de PHP desde DirectAdmin:
- Ve a "Select PHP Version" o "PHP Settings".
- Prueba con una versión más reciente (por ejemplo, de PHP 7.4 a PHP 8.1) o viceversa, según lo que soporte tu tema/plugins.

[INFO] En Syspanel (HestiaCP, puerto 2106), el proceso es similar: busca la opción "PHP Versions" en el menú de dominio.

4. Problemas con plugins o temas incompatibles

¿Por qué ocurre?

No todos los plugins y temas se actualizan al mismo ritmo que WordPress. Una actualización puede romper la compatibilidad con versiones anteriores.

Solución paso a paso

Antes de actualizar, revisa si tus plugins y temas son compatibles con la nueva versión de WordPress. Puedes hacerlo desde el repositorio oficial o contactando al desarrollador.
Desactiva todos los plugins temporalmente (como se explicó en el punto 2) y actualiza WordPress.
Actualiza los plugins y temas uno por uno, comprobando que todo funcione después de cada actualización.
Si un plugin deja de funcionar, busca alternativas o contacta al soporte del desarrollador.

[TIP] Mantén siempre una copia de seguridad completa (archivos y base de datos) antes de cualquier actualización. En DirectAdmin puedes usar la herramienta "Backup" que permite descargar un archivo comprimido de todo tu sitio.

5. El proceso de actualización se queda atascado o no se completa

¿Por qué ocurre?

A veces, la actualización se interrumpe por un timeout del servidor, una conexión lenta o porque el archivo de actualización está dañado.

Solución paso a paso

Espera unos minutos y vuelve a intentarlo. A veces es un problema temporal del servidor.
Actualiza manualmente descargando la última versión de WordPress desde wordpress.org.
- Descomprime el archivo en tu computadora.
- Sube las carpetas wp-admin y wp-includes (sobrescribiendo las existentes) mediante FTP o el Administrador de archivos de DirectAdmin.
- Luego sube los archivos sueltos de la raíz (excepto wp-config.php y la carpeta wp-content).
Ve a tu sitio y sigue el proceso de actualización desde el panel de administración (si es necesario, accede a /wp-admin/upgrade.php).

[WARNING] No subas la carpeta wp-content ni el archivo wp-config.php de la nueva versión, ya que borrarías tus contenidos y configuraciones.

6. Error de permisos de archivos después de la actualización

¿Por qué ocurre?

DirectAdmin a veces no asigna los permisos correctos automáticamente, lo que impide que WordPress escriba archivos (como subidas de imágenes o actualizaciones de plugins).

Solución paso a paso

Conéctate a DirectAdmin y ve a "Administrador de archivos".
Selecciona toda la carpeta de tu sitio (por ejemplo, public_html).
Haz clic en "Cambiar permisos" y establece:
- Carpetas: 755
- Archivos: 644
Para la carpeta wp-content, puedes darle permisos 755 o incluso 777 temporalmente si necesitas que WordPress pueda escribir (por ejemplo, para instalar plugins). No dejes 777 permanentemente por seguridad.

[TIP] En Syspanel (HestiaCP, puerto 2106), los permisos se gestionan desde la opción "File Manager" o mediante comandos SSH si tienes acceso.

7. Error de "loop de redirección" después de actualizar

¿Por qué ocurre?

Esto suele deberse a un conflicto en el archivo .htaccess o a una configuración incorrecta de la URL del sitio en la base de datos.

Solución paso a paso

Revisa el archivo `.htaccess como se indicó en el punto 3. Si lo renombraste y el problema desaparece, regenera las reglas desde WordPress.
Verifica las URLs en la base de datos:
- Accede a phpMyAdmin desde DirectAdmin.
- Selecciona tu base de datos y ejecuta esta consulta SQL:

SELECT * FROM wp_options WHERE option_name IN ('siteurl', 'home');

Asegúrate de que ambas opciones tengan la URL correcta (sin http o https de más, y sin barras al final).

Si es necesario, actualiza los valores con:

UPDATE wp_options SET option_value = 'https://tudominio.com' WHERE option_name = 'siteurl';
UPDATE wp_options SET option_value = 'https://tudominio.com' WHERE option_name = 'home';

[INFO] Si usas Syspanel (HestiaCP, puerto 2106), el acceso a phpMyAdmin está en la sección "Databases".

8. Preguntas frecuentes adicionales (FAQ)

¿Debo actualizar WordPress automáticamente o manualmente?

Recomendamos actualizaciones manuales o con plugins de confianza (como UpdraftPlus) que hagan backup automático. Las actualizaciones automáticas pueden fallar si el servidor tiene limitaciones.

¿Qué hago si mi sitio se rompe completamente después de una actualización?

Restaura una copia de seguridad. En DirectAdmin, ve a "Backup" y restaura el backup más reciente. Si no tienes uno, contacta a tu proveedor de hosting para que te ayude.

¿Es seguro actualizar WordPress desde el panel de administración?

Sí, siempre que tu hosting tenga los permisos correctos. Si ves errores, prueba la actualización manual.

¿Cómo evito problemas futuros?

Mantén un backup semanal (puedes automatizarlo en DirectAdmin).
Actualiza primero en un entorno de pruebas (staging) si tu hosting lo ofrece.
Revisa los registros de errores en DirectAdmin (sección "Error Log") para identificar problemas recurrentes.

Conclusión

Actualizar WordPress en DirectAdmin no tiene por qué ser una pesadilla. La mayoría de los errores actualización WordPress tienen soluciones simples que puedes aplicar tú mismo siguiendo estos pasos. Recuerda siempre hacer una copia de seguridad antes de cualquier cambio, y si el problema persiste, no dudes en contactar al soporte técnico de tu hosting.

[INFO] Si tu panel es Syspanel (HestiaCP, puerto 2106), los procedimientos son muy similares. Solo cambian los nombres de algunas opciones, pero la lógica es la misma.

Esperamos que esta FAQ WordPress DirectAdmin te haya sido de ayuda. ¡Ahora ya puedes actualizar con tranquilidad y mantener tu sitio seguro y actualizado!