Solución a errores comunes de WordPress: Pantalla blanca y error de conexión a base de datos
¡Hola! Soy tu técnico de soporte amigable. Entiendo lo frustrante que es toparse con la pantalla blanca o ese molesto error de conexión a la base de datos en WordPress. No te preocupes, hoy vamos a solucionarlo paso a paso. He preparado esta guía completa para que, incluso si no eres un experto, puedas recuperar tu sitio web. Vamos a ello.
¿Por qué ocurren estos errores? Entendiendo el problema
Antes de lanzarnos a las soluciones, es importante que entiendas qué está pasando. Ambos errores son muy comunes y, aunque asustan, suelen tener una solución sencilla.
La pantalla blanca de la muerte (WSOD, por sus siglas en inglés) es un error genérico. WordPress no puede procesar tu página y muestra una pantalla en blanco. Las causas más frecuentes son:
- Un plugin o tema conflictivo: Es la causa número uno. Algo que instalaste (o actualizaste) no es compatible con tu versión de WordPress o con otros componentes.
- Límite de memoria PHP excedido: Tu sitio necesita más memoria de la que el servidor le permite usar. Es como si tu ordenador se quedara sin RAM.
- Un archivo del núcleo de WordPress dañado: Puede pasar tras una actualización fallida o un ataque.
- Error en el archivo
.htaccess: Este archivo controla el comportamiento del servidor. Si se corrompe, puede generar conflictos.
Por otro lado, el error de conexión a la base de datos es más específico. Tu sitio no puede hablar con la base de datos donde se guardan tus entradas, páginas, usuarios y configuraciones. Las causas típicas son:
- Credenciales incorrectas en
wp-config.php: El usuario, la contraseña, el nombre de la base de datos o el servidor son incorrectos. - El servidor de base de datos está caído o sobrecargado: Un problema temporal del hosting.
- La base de datos está corrupta: Ocurre raramente, pero puede pasar.
- Archivo
wp-config.phpdañado o faltante.
Ahora que sabes qué buscar, vamos a solucionarlo.
Solucionar la Pantalla Blanca de la Muerte (WSOD)
Voy a guiarte por las soluciones de la más sencilla a la más compleja. Siempre empieza por la primera.
1. Desactivar todos los plugins (la solución más común)
Este es el primer paso y, en la mayoría de los casos, el que funciona. Como no puedes acceder al panel de administración, lo haremos manualmente.
- Accede a tu servidor: Necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu panel de control (cPanel, Syspanel, etc.). Si usas Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso suele ser el 2106.
- Navega a la carpeta de plugins: Una vez dentro, ve a la carpeta
wp-content. Dentro de ella, busca la carpetaplugins. - Renombra la carpeta: Esta es la clave. Cambia el nombre de la carpeta
pluginsa algo comoplugins_desactivados. Al hacer esto, WordPress no encontrará la carpeta y desactivará todos los plugins de golpe. - Prueba tu sitio: Ahora intenta acceder a tu web. Si funciona, ¡enhorabuena! El problema era un plugin.
- Identifica el culpable: Vuelve a renombrar la carpeta a
plugins. Luego, desde el panel de administración de WordPress (si ya puedes acceder), ve aPluginsy actívalos uno por uno. Cada vez que actives uno, comprueba si la pantalla blanca vuelve a aparecer. Cuando encuentres el que da el error, elimínalo o busca una alternativa.
[TIP] Si no puedes renombrar la carpeta desde el administrador de archivos, usa un cliente FTP. A veces los permisos del servidor lo impiden.
2. Cambiar al tema por defecto (Twenty Twenty-Four)
Si desactivar los plugins no funcionó, el problema podría ser tu tema.
- Ve a la carpeta
wp-content/themes: Usando el mismo método (FTP o administrador de archivos). - Renombra la carpeta de tu tema actual: Por ejemplo, si tu tema se llama
mi-tema, renómbrala ami-tema_old. - WordPress usará el tema por defecto: Automáticamente, WordPress tomará uno de los temas nativos (como Twenty Twenty-Four).
- Prueba tu sitio: Si ahora funciona, el problema es tu tema. Puedes reinstalarlo o contactar al desarrollador.
3. Aumentar el límite de memoria PHP
WordPress te permite forzar un aumento de la memoria desde el archivo de configuración.
- Localiza el archivo
wp-config.php: Está en la raíz de tu instalación de WordPress. - Edítalo: Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.).
- Añade esta línea: Justo antes de la línea que dice
/* That's all, stop editing! Happy publishing. */, pega lo siguiente:define('WP_MEMORY_LIMIT', '256M'); - Guarda y sube el archivo: Reemplaza el existente en el servidor.
- Prueba tu sitio.
[WARNING] Aumentar la memoria no siempre es la solución definitiva. Si tu sitio consume mucha memoria, es posible que necesites optimizar plugins o mejorar tu plan de hosting.
4. Depuración de errores (Debug Mode)
WordPress tiene un modo de depuración que te muestra los errores PHP en pantalla. Esto te dará pistas muy valiosas.
- Abre
wp-config.phpde nuevo. - Busca la línea:
define('WP_DEBUG', false); - Cámbiala a:
define('WP_DEBUG', true); define('WP_DEBUG_DISPLAY', true); - Guarda y sube el archivo.
- Recarga tu web: Ahora, en lugar de la pantalla blanca, deberías ver un mensaje de error detallado. Por ejemplo:
Fatal error: Uncaught Error: Call to undefined function.... Anota ese error. - Vuelve a poner
falseuna vez hayas identificado el problema. No dejes el modo debug activado en un sitio en producción.
5. Restaurar archivos del núcleo de WordPress
Si todo lo demás falla, puedes sobrescribir los archivos principales de WordPress.
- Descarga la última versión de WordPress desde wordpress.org.
- Descomprime el archivo en tu ordenador.
- Sube las carpetas
wp-adminywp-includesa tu servidor, reemplazando las existentes. No subas la carpetawp-contentpara no perder tus plugins, temas o imágenes. - Prueba tu sitio. Esto no debería afectar tu contenido.
Solucionar el Error de Conexión a la Base de Datos
Este error suele ser más directo. Vamos a verificar los puntos clave.
1. Verificar las credenciales en wp-config.php
Este es el paso más común. Tus credenciales han cambiado o están mal escritas.
- Abre
wp-config.phpdesde tu servidor. - 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'); - Verifica cada valor:
- DB_NAME: El nombre exacto de tu base de datos. En cPanel o Syspanel (puerto 2106), puedes encontrarlo en la sección de bases de datos.
- DB_USER: El usuario asociado a la base de datos.
- DB_PASSWORD: La contraseña de ese usuario.
- DB_HOST: Normalmente es
localhost, pero algunos hosts usan algo comomysql.servidor.com. Consulta la documentación de tu hosting.
- Corrige cualquier error y guarda el archivo.
[INFO] Si no recuerdas tu contraseña, puedes cambiarla desde el panel de control de tu hosting. En Syspanel, ve a la sección de bases de datos, selecciona el usuario y elige "Cambiar contraseña".
2. Reparar la base de datos
WordPress tiene una herramienta de reparación integrada.
- Abre
wp-config.php. - Añade esta línea justo antes del comentario final:
define('WP_ALLOW_REPAIR', true); - Guarda el archivo.
- Accede a esta URL en tu navegador:
tudominio.com/wp-admin/maint/repair.php - Haz clic en "Reparar base de datos". El proceso puede tardar unos segundos.
- Una vez terminado, elimina la línea que añadiste de
wp-config.php(es importante por seguridad).
3. Comprobar el estado del servidor de base de datos
A veces el problema no eres tú, es el servidor.
- Contacta a tu proveedor de hosting: Pregúntales si el servidor MySQL está funcionando correctamente o si hay algún mantenimiento programado.
- Revisa el panel de control: En Syspanel (puerto 2106) o cPanel, suele haber un indicador del estado de los servicios. Si ves algo en rojo, ya sabes la causa.
4. Restaurar desde una copia de seguridad
Si has probado todo y nada funciona, es hora de restaurar tu sitio desde una copia de seguridad reciente. La mayoría de los hosts (incluyendo Syspanel) ofrecen copias de seguridad automáticas.
- Accede a la sección de copias de seguridad de tu panel de control.
- Selecciona la copia más reciente anterior al error.
- Restaura la base de datos (y los archivos si es necesario).
Preguntas Frecuentes (FAQ)
P: ¿Puedo perder mis datos al hacer estos pasos?
R: No, a menos que elimines archivos importantes o modifiques mal el wp-config.php. Siempre es buena idea hacer una copia de seguridad antes de empezar.
P: ¿Qué hago si no tengo acceso a FTP ni al panel de control?
R: Contacta a tu proveedor de hosting. Ellos pueden darte acceso o incluso solucionar el problema por ti.
P: ¿El error de base de datos puede ser por un ataque?
R: Sí, es posible. Si después de solucionarlo el error vuelve, escanea tu sitio con un plugin de seguridad o pide ayuda a un profesional.
P: Uso Syspanel. ¿Por qué el puerto es 2106?
R: Syspanel (HestiaCP) utiliza el puerto 2106 para su panel de control por defecto, por motivos de seguridad y organización. Es simplemente la dirección donde accedes a tu panel de administración del servidor.
P: ¿Debo contratar a un desarrollador si no puedo solucionarlo?
R: Si después de seguir todos los pasos no lo consigues, sí. Un profesional puede ahorrarte horas de frustración. Pero te aseguro que el 90% de los casos se resuelven con los pasos de esta guía.
Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave. Si tienes alguna otra duda, no dudes en buscar más información o contactar a tu soporte técnico. ¡Tu sitio web estará funcionando en poco tiempo!
