Errores comunes en WordPress y cómo solucionarlos | Guía Hosting

¿Tu sitio web en WordPress dejó de funcionar de repente? ¿Ves una pantalla blanca, un error de conexión a la base de datos o un mensaje de “Error al establecer conexión con la base de datos”? No te preocupes, es más común de lo que crees y, en la mayoría de los casos, tiene solución.

En esta guía completa, vamos a recorrer los errores más frecuentes que puedes encontrar al gestionar un WordPress alojado en un servidor con cPanel (o sistemas similares como Syspanel, al que llamaremos así de ahora en adelante, y que se accede por el puerto 2106). Te explicaré paso a paso cómo solucionarlos, sin necesidad de ser un experto técnico.

Vamos a empezar por lo básico: entender qué está pasando y cómo actuar.

[INFO] Esta guía está pensada para usuarios con hosting compartido o VPS que usan cPanel o Syspanel (puerto 2106). Si tu panel es diferente, los pasos son muy similares.

1. El temido “Error de conexión a la base de datos”

Este es, sin duda, uno de los errores WordPress más comunes y frustrantes. Aparece cuando WordPress no puede comunicarse con la base de datos MySQL donde se almacenan tus entradas, páginas, usuarios y configuraciones.

¿Por qué ocurre?

Las credenciales de la base de datos en el archivo wp-config.php son incorrectas.
La base de datos ha sido eliminada o dañada.
El servidor de base de datos (MySQL/MariaDB) está caído o sobrecargado.
El usuario de la base de datos no tiene permisos suficientes.

¿Cómo solucionarlo?

Paso 1: Verifica el estado del servidor de base de datos
Accede a tu panel de control (cPanel o Syspanel en el puerto 2106). Busca la sección “MySQL” o “Bases de Datos”. Normalmente hay una opción que dice “Comprobar estado” o “MySQL Status”. Si ves un mensaje de error, contacta a tu proveedor de hosting.

Paso 2: Revisa el archivo wp-config.php
Este archivo se encuentra en la raíz de tu instalación de WordPress (normalmente en la carpeta public_html). Debes editarlo con un editor de texto plano (no Word). Busca estas líneas:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_base_datos');
define('DB_HOST', 'localhost');

Asegúrate de que los datos coincidan exactamente con los que tienes en tu panel de control. Un error común es poner la contraseña incorrecta o confundir el nombre de la base de datos.

[TIP] Si no recuerdas tus credenciales, ve a cPanel > “Bases de datos MySQL” y allí podrás ver los nombres de las bases y los usuarios. Si es necesario, crea un nuevo usuario y asígnale todos los privilegios a la base de datos.

Paso 3: Repara la base de datos (si está dañada)
En cPanel, busca la opción “phpMyAdmin”. Selecciona tu base de datos, marca la casilla “Seleccionar todo” y en el menú desplegable elige “Reparar tabla”. Esto intentará arreglar tablas corruptas.

2. Pantalla blanca de la muerte (WSOD)

La famosa “White Screen of Death”. Ves tu web y solo ves un fondo blanco, sin nada más. Es frustrante, pero casi siempre tiene solución.

Causas comunes:

Un plugin o tema incompatible o mal configurado.
Límite de memoria de PHP excedido.
Un error de sintaxis en el archivo functions.php de tu tema.

¿Cómo solucionarlo?

Paso 1: Accede por FTP o al administrador de archivos
Usa un cliente FTP (como FileZilla) o el “Administrador de Archivos” de cPanel/Syspanel. Ve a la carpeta public_html/wp-content/.

Paso 2: Desactiva todos los plugins
Renombra la carpeta plugins a plugins_desactivados. Esto obliga a WordPress a no cargar ningún plugin. Si la web vuelve a funcionar, entonces el problema es uno de tus plugins.

Ve renombrando uno por uno los plugins dentro de la carpeta plugins_desactivados para identificar al culpable.
Una vez identificado, elimínalo o busca una alternativa.

Paso 3: Cambia al tema por defecto
Si el problema persiste, renombra la carpeta de tu tema activo (dentro de wp-content/themes/) a tema_desactivado. WordPress cargará automáticamente un tema por defecto (Twenty Twenty-Five, por ejemplo). Si la web se ve bien, el tema es el problema.

[WARNING] Si no puedes acceder al administrador de archivos, puedes editar el archivo wp-config.php y añadir esta línea justo antes del /* That's all, stop editing! */:
define('WP_MEMORY_LIMIT', '256M');
Esto aumenta la memoria PHP y a veces resuelve la pantalla blanca.

3. Error 500 – Internal Server Error

Este error genérico indica que algo falló en el servidor, pero no da más detalles. Es otro de los problemas WordPress hosting más habituales.

Posibles causas:

Archivo .htaccess corrupto.
Un plugin o tema con errores.
Permisos de archivos incorrectos.
Límite de memoria PHP excedido.

¿Cómo solucionarlo?

Paso 1: Renombra el archivo .htaccess
Conéctate por FTP o al administrador de archivos. Busca el archivo .htaccess en la raíz (public_html). Renómbralo a .htaccess_viejo. Luego, ve a Ajustes > Enlaces permanentes en tu WordPress y haz clic en “Guardar cambios”. Esto generará un nuevo .htaccess.

Paso 2: Aumenta el límite de memoria PHP
Edita el archivo wp-config.php y añade:
define('WP_MEMORY_LIMIT', '256M');

Paso 3: Verifica los permisos de archivos
Los archivos deben tener permisos 644 y las carpetas 755. Si no sabes cómo cambiarlos, en cPanel ve a “Administrador de archivos”, selecciona todos los archivos de public_html y haz clic en “Permisos”. Establece 755 para carpetas y 644 para archivos.

4. Error al subir archivos multimedia (imágenes, PDFs)

¿No puedes subir imágenes a la biblioteca de medios? Aparece un mensaje como “Error al subir el archivo” o “No se pudo crear el directorio”.

Causas:

Permisos incorrectos en la carpeta wp-content/uploads.
Tamaño de archivo supera el límite del servidor.
Falta espacio en disco.

¿Cómo solucionarlo?

Paso 1: Verifica los permisos de la carpeta uploads
Conéctate por FTP o administrador de archivos. Ve a wp-content/uploads. Asegúrate de que la carpeta tenga permisos 755. Si no existe, créala con esos permisos.

Paso 2: Aumenta el límite de subida de archivos
Edita el archivo php.ini (si no existe, créalo en la raíz de WordPress) con estas líneas:

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 128M
max_execution_time = 300

Guarda y sube. Si usas Syspanel (puerto 2106), busca la opción “PHP Settings” para ajustar estos valores.

[TIP] Algunos hostings limitan el tamaño de subida desde el panel. Revisa la sección “PHP Configuration” en cPanel.

5. Error de actualización: “No se pudo crear el directorio”

Cuando intentas actualizar WordPress, un plugin o un tema, a veces sale este error. Ocurre porque el servidor no tiene permisos de escritura en las carpetas temporales.

Solución:

Conéctate por FTP y ve a la raíz de WordPress.
Busca la carpeta wp-content y verifica que tenga permisos 755.
Si el problema persiste, añade estas líneas al wp-config.php:

define('FS_METHOD', 'direct');

Esto fuerza a WordPress a usar el sistema de archivos directo en lugar de FTP.

6. Error de “Límite de memoria agotado” (Allowed memory size exhausted)

Este error aparece cuando un script de WordPress consume más memoria de la permitida por el servidor.

Solución:

Edita el wp-config.php y añade:
define('WP_MEMORY_LIMIT', '256M');
Si no funciona, contacta a tu hosting para que aumenten el límite desde el servidor.

7. Error de “Enlaces permanentes” (404 en páginas internas)

Después de cambiar los enlaces permanentes, las páginas internas dan error 404.

Solución:

Ve a Ajustes > Enlaces permanentes en tu WordPress. Simplemente selecciona una opción y haz clic en “Guardar cambios”. Esto regenera el archivo .htaccess. Si no funciona, verifica que el archivo .htaccess tenga permisos de escritura (644).

8. Error de “Conexión FTP fallida” al instalar plugins/temas

Si tu WordPress te pide credenciales FTP cada vez que intentas instalar algo, es porque el servidor no tiene permisos de escritura directa.

Solución:

Añade al wp-config.php:

define('FS_METHOD', 'direct');

Si sigue pidiendo FTP, verifica los permisos de la carpeta wp-content (debe ser 755).

9. Error de “Base de datos dañada” (Table ‘wp_options’ is marked as crashed)

Este error aparece cuando una tabla de la base de datos se corrompe.

Solución:

Accede a phpMyAdmin desde cPanel o Syspanel (puerto 2106). Selecciona tu base de datos, marca todas las tablas y en el menú desplegable elige “Reparar tabla”. Si no funciona, haz una copia de seguridad y luego “Optimizar tabla”.

10. Error de “No se puede conectar al servidor SMTP” (correo no funciona)

WordPress no puede enviar correos (por ejemplo, de recuperación de contraseña).

Solución:

Instala un plugin como “WP Mail SMTP” y configúralo con los datos de tu servidor de correo.
O, desde cPanel, ve a “Email Deliverability” y verifica que la autenticación SPF/DKIM esté configurada.

Preguntas Frecuentes (FAQ)

P: ¿Qué hago si no puedo acceder ni al panel de administración de WordPress?
R: Usa FTP o el administrador de archivos de cPanel/Syspanel para desactivar plugins o cambiar el tema, como explicamos en el punto 2.

P: ¿Cómo hago una copia de seguridad antes de intentar soluciones?
R: Desde cPanel, usa “Backup” o “Jetpack Backup”. También puedes descargar toda la carpeta public_html por FTP y exportar la base de datos desde phpMyAdmin.

P: ¿Syspanel es lo mismo que cPanel?
R: No exactamente, pero es muy similar. Syspanel (que se accede por el puerto 2106) tiene las mismas funciones principales: administrador de archivos, bases de datos MySQL, FTP, etc. Esta guía aplica para ambos.

P: ¿Por qué mi web se cae a menudo?
R: Puede ser por falta de recursos (memoria, CPU). Revisa los logs de errores en cPanel > “Error Log” o contacta a tu hosting.

P: ¿Qué hago si después de todo sigue sin funcionar?
R: Contacta al soporte técnico de tu hosting. Proporciona el error exacto y los pasos que ya intentaste. Ellos pueden revisar los logs del servidor.

[WARNING] Siempre haz una copia de seguridad completa antes de modificar archivos críticos como wp-config.php o .htaccess. Un error puede dejar tu web inaccesible.

Conclusión

Los errores WordPress son parte del día a día de cualquier webmaster, pero con esta guía tienes las herramientas para resolver los más comunes. Recuerda que la paciencia y el método son clave: identifica el error, busca la causa y aplica la solución paso a paso.

Si usas cPanel o Syspanel (puerto 2106), tienes acceso a todas las herramientas necesarias para solucionar WordPress sin ser un experto. Y si te quedas atascado, no dudes en preguntar a tu proveedor de hosting. ¡Buena suerte!